# Compute continous cartograms (anamorphic maps)
This is a Python package to compute cartograms from `geopandas.GeoDataFrames`, using the algorithm presented in [Dougenik et al. (1985)](http://www.tandfonline.com/doi/abs/10.1111/j.0033-0124.1985.00075.x). It is the ‘sister project’ and Python implementation of our [QGIS plugin](https://github.com/austromorph/cartogram3) which continues to be available.
## Installation
`cartogram` is available from the [PyPi package
repository](https://pypi.org/project/cartogram), install it, for instance, using `pip`:
```
pip install cartogram
```
## Quick start
### Input data
You will need a polygon data set [in any format readable by
`geopandas`](https://geopandas.org/en/stable/docs/user_guide/io.html) that
features a numeric attribute column to use as the relative target values to base
the cartogram distortion on.
If you want to have a quick try-out, see the population data for Austrian
provinces in the [`tests/data`](tests/data) directory of this repository.
### Cartogram creation
```
import cartogram
import geopandas
df = geopandas.read_file("input-data.gpkg")
c = cartogram.Cartogram(df, column="population")
c.to_file("output-data.gpkg")
```
## Documentation
Find more detailed examples and an API reference at <https://python-cartogram.readthedocs.io/>.
Raw data
{
"_id": null,
"home_page": null,
"name": "cartogram",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "cartography, geodata, geoinformation, visualisation",
"author": null,
"author_email": "Christoph Fink <christoph.fink@christophfink.com>",
"download_url": "https://files.pythonhosted.org/packages/97/35/982029ff13b0ae60908d1a10596c3dc15746e184b34f76fb375661f1986a/cartogram-0.0.2.tar.gz",
"platform": null,
"description": "# Compute continous cartograms (anamorphic maps)\n\nThis is a Python package to compute cartograms from `geopandas.GeoDataFrames`, using the algorithm presented in [Dougenik et al. (1985)](http://www.tandfonline.com/doi/abs/10.1111/j.0033-0124.1985.00075.x). It is the \u2018sister project\u2019 and Python implementation of our [QGIS plugin](https://github.com/austromorph/cartogram3) which continues to be available.\n\n\n## Installation\n\n`cartogram` is available from the [PyPi package\nrepository](https://pypi.org/project/cartogram), install it, for instance, using `pip`:\n\n```\npip install cartogram\n```\n\n\n## Quick start\n\n### Input data\n\nYou will need a polygon data set [in any format readable by\n`geopandas`](https://geopandas.org/en/stable/docs/user_guide/io.html) that\nfeatures a numeric attribute column to use as the relative target values to base\nthe cartogram distortion on. \n\nIf you want to have a quick try-out, see the population data for Austrian\nprovinces in the [`tests/data`](tests/data) directory of this repository.\n\n### Cartogram creation\n\n```\nimport cartogram\nimport geopandas\n\ndf = geopandas.read_file(\"input-data.gpkg\")\nc = cartogram.Cartogram(df, column=\"population\")\n\nc.to_file(\"output-data.gpkg\")\n```\n\n## Documentation\n\nFind more detailed examples and an API reference at <https://python-cartogram.readthedocs.io/>.\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "Compute continous cartograms (anamorphic maps)",
"version": "0.0.2",
"project_urls": {
"Bug tracker": "https://github.com/austromorph/python-cartogram/issues",
"Change log": "https://github.com/austromorph/python-cartogram/blob/main/CHANGELOG.md",
"Documentation": "https://python-cartogram.readthedocs.org/",
"Repository": "https://github.com/austromorph/python-cartogram"
},
"split_keywords": [
"cartography",
" geodata",
" geoinformation",
" visualisation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "779f2f74a8989b59ef0af3c5cc2da4c8af5b821607afed57eb78dea34770f989",
"md5": "9582d79217817d6bbcb54b2ba10e2c23",
"sha256": "93e39addec33380f755d410344321b0ac98c88949de66c37647300a6a91688da"
},
"downloads": -1,
"filename": "cartogram-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9582d79217817d6bbcb54b2ba10e2c23",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 17533,
"upload_time": "2024-07-15T22:05:59",
"upload_time_iso_8601": "2024-07-15T22:05:59.706753Z",
"url": "https://files.pythonhosted.org/packages/77/9f/2f74a8989b59ef0af3c5cc2da4c8af5b821607afed57eb78dea34770f989/cartogram-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9735982029ff13b0ae60908d1a10596c3dc15746e184b34f76fb375661f1986a",
"md5": "18ae33f3f714111b2a046411a760b4e8",
"sha256": "34b237ddda54e0316cc06281753d759c3d29095b4054f93b7ff7e9071ca8e2bf"
},
"downloads": -1,
"filename": "cartogram-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "18ae33f3f714111b2a046411a760b4e8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 17797,
"upload_time": "2024-07-15T22:06:01",
"upload_time_iso_8601": "2024-07-15T22:06:01.511083Z",
"url": "https://files.pythonhosted.org/packages/97/35/982029ff13b0ae60908d1a10596c3dc15746e184b34f76fb375661f1986a/cartogram-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-15 22:06:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "austromorph",
"github_project": "python-cartogram",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cartogram"
}
JSON
