<img src="https://gw.alipayobjects.com/zos/antfincdn/R8sN%24GNdh6/language.svg" width="18"> English | [简体中文](./README.zh-CN.md)
# PyL7VP
🌍 Python3 binding for [`@AntV/L7VP`](https://li.antv.antgroup.com) geospatial visual analysis tool.
[](https://pypi.python.org/pypi/pyl7vp) [](https://github.com/antvis/L7VP/actions?query=workflow:pyl7vp-test) [](https://pypi.python.org/pypi/pyl7vp)
<div align="center">
<img src="https://mdn.alipayobjects.com/huamei_qa8qxu/afts/img/A*MsnaS4IHywoAAAAAAAAAAAAADmJ7AQ/original" width="800">
</div>
## Installation
```bash
$ pip install pyl7vp
```
### Usage
### Jupyter Notebook and JupyterLab
```py
import pandas as pd
from pyl7vp import L7VP
l7vp_map = L7VP(height = 600)
# data
df = pd.DataFrame(
{'longitude': [105.005, 104.602, 103.665, 105.275],
'latitude': [32.349, 32.067, 31.29, 32.416],
'mag': [5.2, 3.0, 6.0, 2.0]
})
# add dataset to map
l7vp_map.add_dataset({"id": "my_dataset", "type": 'local', "data": df})
# Set config
l7vp_map.set_config({
"map": {
"type": "Gaode",
"config": {
"zoom": 7,
"center": [104.615357, 32.068745],
"style": 'dark',
},
},
})
# display map
l7vp_map.show()
```
### Save to HTML File
```py
from pyl7vp import L7VP
l7vp_map = L7VP(height = 600)
# save to html file
l7vp_map.save_to_html("map.html")
```
## User Guide
- [Quick Start](https://www.yuque.com/antv/l7vp/pyl7vp-user-guide#C7cMY)
- [Data Format](https://www.yuque.com/antv/l7vp/pyl7vp-user-guide#ZaJB8)
- [API Document](https://www.yuque.com/antv/l7vp/pyl7vp-user-guide#YdNaX)
- [PyL7VP in Notebook](https://github.com/antvis/L7VP/blob/master/bindings/pyl7vp/notebooks/quick-start.ipynb)
- [PyL7VP in Google Colab](https://colab.research.google.com/github/antvis/L7VP/blob/master/bindings/pyl7vp/notebooks/quick-start.ipynb)
## Local Development
### Install Jupyter
```shell
# Using pip
pip install jupyter
# or Using conda
# conda install jupyter
```
### Clone code
```shell
git clone https://github.com/antvis/L7VP.git
```
### Setup jupyter
#### Install python module
```sh
cd bindings/pyl7vp
# dev install from folder containing setup.py
pip install -e .
```
#### Start jupyter notebook
```shell
cd notebooks
jupyter notebook
```
### Release a new version
Update `version` in `bindings/pyl7vp/pyl7vp/meta.py`
```py
__version__ = "0.0.1"
```
Build and publish
```bash
python setup.py upload
```
## License
[Apache-2.0](./LICENSE)
Raw data
{
"_id": null,
"home_page": "https://github.com/antvis/L7VP/bindings/pyl7vp",
"name": "pyl7vp",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "AntV,L7VP,PyL7VP,visualization,map,geospatial visualization,geospatial analysis",
"author": "@lvisei",
"author_email": "yunji.me@outlook.com",
"download_url": "https://files.pythonhosted.org/packages/cd/b8/2f704fc89a848a3b0d5111c531c81f3abad5b61a623b34f64478459b32c7/pyl7vp-0.1.0.tar.gz",
"platform": null,
"description": "<img src=\"https://gw.alipayobjects.com/zos/antfincdn/R8sN%24GNdh6/language.svg\" width=\"18\"> English | [\u7b80\u4f53\u4e2d\u6587](./README.zh-CN.md)\n\n# PyL7VP\n\n\ud83c\udf0d Python3 binding for [`@AntV/L7VP`](https://li.antv.antgroup.com) geospatial visual analysis tool.\n\n[](https://pypi.python.org/pypi/pyl7vp) [](https://github.com/antvis/L7VP/actions?query=workflow:pyl7vp-test) [](https://pypi.python.org/pypi/pyl7vp)\n\n<div align=\"center\">\n <img src=\"https://mdn.alipayobjects.com/huamei_qa8qxu/afts/img/A*MsnaS4IHywoAAAAAAAAAAAAADmJ7AQ/original\" width=\"800\">\n</div>\n\n## Installation\n\n```bash\n$ pip install pyl7vp\n```\n\n### Usage\n\n### Jupyter Notebook and JupyterLab\n\n```py\nimport pandas as pd\nfrom pyl7vp import L7VP\n\nl7vp_map = L7VP(height = 600)\n\n# data\ndf = pd.DataFrame(\n {'longitude': [105.005, 104.602, 103.665, 105.275],\n 'latitude': [32.349, 32.067, 31.29, 32.416],\n 'mag': [5.2, 3.0, 6.0, 2.0]\n })\n\n# add dataset to map\nl7vp_map.add_dataset({\"id\": \"my_dataset\", \"type\": 'local', \"data\": df})\n\n# Set config\nl7vp_map.set_config({\n \"map\": {\n \"type\": \"Gaode\",\n \"config\": {\n \"zoom\": 7,\n \"center\": [104.615357, 32.068745],\n \"style\": 'dark',\n },\n },\n})\n\n# display map\nl7vp_map.show()\n```\n\n### Save to HTML File\n\n```py\nfrom pyl7vp import L7VP\n\nl7vp_map = L7VP(height = 600)\n\n# save to html file\nl7vp_map.save_to_html(\"map.html\")\n```\n\n## User Guide\n\n- [Quick Start](https://www.yuque.com/antv/l7vp/pyl7vp-user-guide#C7cMY)\n- [Data Format](https://www.yuque.com/antv/l7vp/pyl7vp-user-guide#ZaJB8)\n- [API Document](https://www.yuque.com/antv/l7vp/pyl7vp-user-guide#YdNaX)\n- [PyL7VP in Notebook](https://github.com/antvis/L7VP/blob/master/bindings/pyl7vp/notebooks/quick-start.ipynb)\n- [PyL7VP in Google Colab](https://colab.research.google.com/github/antvis/L7VP/blob/master/bindings/pyl7vp/notebooks/quick-start.ipynb)\n\n## Local Development\n\n### Install Jupyter\n\n```shell\n# Using pip\npip install jupyter\n\n# or Using conda\n# conda install jupyter\n```\n\n### Clone code\n\n```shell\ngit clone https://github.com/antvis/L7VP.git\n```\n\n### Setup jupyter\n\n#### Install python module\n\n```sh\ncd bindings/pyl7vp\n\n# dev install from folder containing setup.py\npip install -e .\n```\n\n#### Start jupyter notebook\n\n```shell\ncd notebooks\njupyter notebook\n```\n\n### Release a new version\n\nUpdate `version` in `bindings/pyl7vp/pyl7vp/meta.py`\n\n```py\n__version__ = \"0.0.1\"\n```\n\nBuild and publish\n\n```bash\npython setup.py upload\n```\n\n## License\n\n[Apache-2.0](./LICENSE)\n\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Python3 binding for @AntV/L7VP geospatial visual analysis tool.",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/antvis/L7VP/bindings/pyl7vp"
},
"split_keywords": [
"antv",
"l7vp",
"pyl7vp",
"visualization",
"map",
"geospatial visualization",
"geospatial analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fc264f1eaf9db3fca696c2df5e5a8470f9b6658dc491cc1ae395d55c37501439",
"md5": "913cd0fdaee9d3bf4449833b13678a9a",
"sha256": "c2bbc6dbbc47f5b53728434fd64cc4222d49ab36e1e652db0a1d041853a43310"
},
"downloads": -1,
"filename": "pyl7vp-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "913cd0fdaee9d3bf4449833b13678a9a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 15445,
"upload_time": "2024-01-24T05:22:05",
"upload_time_iso_8601": "2024-01-24T05:22:05.023476Z",
"url": "https://files.pythonhosted.org/packages/fc/26/4f1eaf9db3fca696c2df5e5a8470f9b6658dc491cc1ae395d55c37501439/pyl7vp-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cdb82f704fc89a848a3b0d5111c531c81f3abad5b61a623b34f64478459b32c7",
"md5": "a8ff5a4164f57c9f3b364998f06ac6bf",
"sha256": "27da6e4c47e0c0421ede189426573298fdde3e0fc4fd3caa4daac70ca8dc3adf"
},
"downloads": -1,
"filename": "pyl7vp-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "a8ff5a4164f57c9f3b364998f06ac6bf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 15116,
"upload_time": "2024-01-24T05:22:07",
"upload_time_iso_8601": "2024-01-24T05:22:07.051231Z",
"url": "https://files.pythonhosted.org/packages/cd/b8/2f704fc89a848a3b0d5111c531c81f3abad5b61a623b34f64478459b32c7/pyl7vp-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-24 05:22:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "antvis",
"github_project": "L7VP",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pyl7vp"
}
JSON
