geomapviz


Namegeomapviz JSON
Version 1.1.3 PyPI version JSON
download
home_page
Summarydata visualization on maps with varying levels of granularity
upload_time2023-09-23 14:05:06
maintainer
docs_urlNone
author
requires_python>=3.8
licenseMIT License Copyright (c) [2020] [Thomas Bury] Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords geographical visualization map interactive choropleth
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <img src="pics/logo.png" alt="drawing" width="200"/>

[buy me caffeine](https://ko-fi.com/V7V72SOHX)

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![PyPI version](https://img.shields.io/pypi/v/geomapviz?style=flat)](https://pypi.org/project/geomapviz/)

# πŸ—ΊοΈπŸ Geomapviz - Python Library for Beautiful and Interactive Geospatial Tabular Data Visualization πŸš€

Geomapviz is a Python library for visualizing geospatial tabular data. It aggregates tabular data at the geoid level, merges it with the shapefile, and provides a simple API to plot the average for single or multiple columns. The library is designed to create beautiful and interactive visualizations that help users better understand geospatial data. Geomapviz can produce a single map or a panel of maps, making it useful for comparing how different models capture geographical patterns. The package also supports returning average values either raw or automatically binned. Additionally, it allows users to customize the background color, including the option to switch from a black background to a light one. The styling is handled by a DataClass, PlotOptions, object is used to specify various arguments for creating a geospatial plot of a dataset

[Geomapviz ReadTheDocs](https://geomapviz.readthedocs.io/en/latest/)

<td align="left"><img src="pics/example_01.png" width="600"/></td>
<td align="left"><img src="pics/example_02.png" width="300"/></td>


## Installation

`$ conda install -c conda-forge cartopy` then
`$ pip install geomapviz -U`

 - If you face a `cartopy` installation error, try to install first from pre-built binaries `conda install -c conda-forge cartopy`. For installing on Linux platform, some dependencies are required, see [the cartopy documentation](https://scitools.org.uk/cartopy/docs/latest/installing.html) for details.
 - If you face a geoviews installation error, try `conda install -c pyviz geoviews`

## Documentation

The [documentation notebook](nb/docs/geomap.ipynb) illustrates the functionality of `geomapviz`
## Changelog

### 1.0

 - Complete refactoring of the library, including modular features and simpler code base

### 0.6

 - Including files in source distributions

### 0.5

 - [Bug] Capital letter in importing the BE shapefile
 - [Bug] Changed default values of arguments

### 0.4

 - Make Belgian shp available using load_be_shp
 - More decimal
 - User defined alpha for the interactive maps

### 0.3

 - Bound functions to the upper level

### 0.2

 - First version

### 0.1

 - First version

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "geomapviz",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "geographical,visualization,map,interactive,choropleth",
    "author": "",
    "author_email": "Thomas Bury <bury.thomas@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/14/71/c3f4d3f87961a88c0277bc43b3c26c27b939404f8321aa57ac6224059b10/geomapviz-1.1.3.tar.gz",
    "platform": null,
    "description": "<img src=\"pics/logo.png\" alt=\"drawing\" width=\"200\"/>\r\n\r\n[buy me caffeine](https://ko-fi.com/V7V72SOHX)\r\n\r\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\r\n[![PyPI version](https://img.shields.io/pypi/v/geomapviz?style=flat)](https://pypi.org/project/geomapviz/)\r\n\r\n# \ud83d\uddfa\ufe0f\ud83d\udc0d Geomapviz - Python Library for Beautiful and Interactive Geospatial Tabular Data Visualization \ud83d\ude80\r\n\r\nGeomapviz is a Python library for visualizing geospatial tabular data. It aggregates tabular data at the geoid level, merges it with the shapefile, and provides a simple API to plot the average for single or multiple columns. The library is designed to create beautiful and interactive visualizations that help users better understand geospatial data. Geomapviz can produce a single map or a panel of maps, making it useful for comparing how different models capture geographical patterns. The package also supports returning average values either raw or automatically binned. Additionally, it allows users to customize the background color, including the option to switch from a black background to a light one. The styling is handled by a DataClass, PlotOptions, object is used to specify various arguments for creating a geospatial plot of a dataset\r\n\r\n[Geomapviz ReadTheDocs](https://geomapviz.readthedocs.io/en/latest/)\r\n\r\n<td align=\"left\"><img src=\"pics/example_01.png\" width=\"600\"/></td>\r\n<td align=\"left\"><img src=\"pics/example_02.png\" width=\"300\"/></td>\r\n\r\n\r\n## Installation\r\n\r\n`$ conda install -c conda-forge cartopy` then\r\n`$ pip install geomapviz -U`\r\n\r\n - If you face a `cartopy` installation error, try to install first from pre-built binaries `conda install -c conda-forge cartopy`. For installing on Linux platform, some dependencies are required, see [the cartopy documentation](https://scitools.org.uk/cartopy/docs/latest/installing.html) for details.\r\n - If you face a geoviews installation error, try `conda install -c pyviz geoviews`\r\n\r\n## Documentation\r\n\r\nThe [documentation notebook](nb/docs/geomap.ipynb) illustrates the functionality of `geomapviz`\r\n## Changelog\r\n\r\n### 1.0\r\n\r\n - Complete refactoring of the library, including modular features and simpler code base\r\n\r\n### 0.6\r\n\r\n - Including files in source distributions\r\n\r\n### 0.5\r\n\r\n - [Bug] Capital letter in importing the BE shapefile\r\n - [Bug] Changed default values of arguments\r\n\r\n### 0.4\r\n\r\n - Make Belgian shp available using load_be_shp\r\n - More decimal\r\n - User defined alpha for the interactive maps\r\n\r\n### 0.3\r\n\r\n - Bound functions to the upper level\r\n\r\n### 0.2\r\n\r\n - First version\r\n\r\n### 0.1\r\n\r\n - First version\r\n",
    "bugtrack_url": null,
    "license": "MIT License  Copyright (c) [2020] [Thomas Bury]  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
    "summary": "data visualization on maps with varying levels of granularity",
    "version": "1.1.3",
    "project_urls": {
        "Tracker": "https://github.com/ThomasBury/geomapviz/issues",
        "changelog": "https://github.com/ThomasBury/geomapviz",
        "documentation": "https://github.com/ThomasBury/geomapviz",
        "homepage": "https://github.com/ThomasBury/geomapviz",
        "repository": "https://github.com/ThomasBury/geomapviz.git"
    },
    "split_keywords": [
        "geographical",
        "visualization",
        "map",
        "interactive",
        "choropleth"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "113b9a2695a223d758be050f8ebd1406bbab7094688571aecad0ec7f26ec2670",
                "md5": "f6521468e2f5e4f02020eed1bd00cac0",
                "sha256": "b7bdd8e9bf23d0db07ce06772b7e6d2041013a4bcbc6e3c53de1b16becca1c13"
            },
            "downloads": -1,
            "filename": "geomapviz-1.1.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "f6521468e2f5e4f02020eed1bd00cac0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 18124496,
            "upload_time": "2023-09-23T14:04:57",
            "upload_time_iso_8601": "2023-09-23T14:04:57.618255Z",
            "url": "https://files.pythonhosted.org/packages/11/3b/9a2695a223d758be050f8ebd1406bbab7094688571aecad0ec7f26ec2670/geomapviz-1.1.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "1471c3f4d3f87961a88c0277bc43b3c26c27b939404f8321aa57ac6224059b10",
                "md5": "abed77c3a108c6da347655e2e3e6f605",
                "sha256": "c143f0b85811ca17953edbc3b382e03e450e149798627ad2ca776f57b9498885"
            },
            "downloads": -1,
            "filename": "geomapviz-1.1.3.tar.gz",
            "has_sig": false,
            "md5_digest": "abed77c3a108c6da347655e2e3e6f605",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 17983490,
            "upload_time": "2023-09-23T14:05:06",
            "upload_time_iso_8601": "2023-09-23T14:05:06.589434Z",
            "url": "https://files.pythonhosted.org/packages/14/71/c3f4d3f87961a88c0277bc43b3c26c27b939404f8321aa57ac6224059b10/geomapviz-1.1.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-09-23 14:05:06",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "ThomasBury",
    "github_project": "geomapviz",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "geomapviz"
}
        
Elapsed time: 0.11383s