Metadata-Version: 2.3
Name: cartes
Version: 0.8.2
Summary: A generic toolbox for building maps in Python
Project-URL: Documentation, https://cartes-viz.github.io/
Project-URL: Code, https://github.com/xoolive/cartes/
Project-URL: Issues, https://github.com/xoolive/cartes/issues/
Project-URL: Releases, https://github.com/xoolive/cartes/releases/
Author-email: Xavier Olive <git@xoolive.org>
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Software Development :: Libraries
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: altair>=5.4.1
Requires-Dist: appdirs>=1.4.4
Requires-Dist: beautifulsoup4>=4.12.3
Requires-Dist: cartopy>=0.23.0; python_version < '3.10'
Requires-Dist: cartopy>=0.24.1; python_version >= '3.10'
Requires-Dist: fastapi>=0.115.0
Requires-Dist: geopandas>=1.0.1
Requires-Dist: httpx[http2]>=0.27.2
Requires-Dist: jsonschema>=4.23.0
Requires-Dist: lxml>=5.3.0
Requires-Dist: matplotlib>=3.9.2
Requires-Dist: nest-asyncio>=1.6.0
Requires-Dist: numpy>=2.0.2; python_version < '3.10'
Requires-Dist: numpy>=2.1.2; python_version >= '3.10'
Requires-Dist: pandas>=2.2.3
Requires-Dist: pyproj<3.7.1; python_version < '3.10'
Requires-Dist: pyproj>=3.7.0; python_version >= '3.10'
Requires-Dist: scipy>=1.13.1; python_version < '3.10'
Requires-Dist: scipy>=1.14.1; python_version >= '3.10'
Requires-Dist: shapely>=2.0.6
Requires-Dist: tqdm>=4.66.5
Requires-Dist: uvicorn>=0.31.0
Description-Content-Type: text/markdown

# Cartes

![tests](https://github.com/xoolive/cartes/workflows/tests/badge.svg)
![docs](https://github.com/xoolive/cartes/workflows/docs/badge.svg)
![Code Coverage](https://img.shields.io/codecov/c/github/xoolive/cartes.svg)
![Checked with mypy](https://img.shields.io/badge/mypy-checked-blue.svg)
![Code style: black](https://img.shields.io/badge/code%20style-black-black.svg)
![License](https://img.shields.io/pypi/l/cartes.svg)\
![PyPI version](https://img.shields.io/pypi/v/cartes)
![PyPI downloads](https://img.shields.io/pypi/dm/cartes)
![Conda version](https://img.shields.io/conda/vn/conda-forge/cartes)
![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/cartes.svg)

Cartes is a Python library providing facilities to produce meaningful maps.

Cartes builds on top of most common Python visualisation libraries (Matplotlib/Cartopy, Altair, ipyleaflet) and data manipulation libraries (Pandas, Geopandas) and provides mostly:

- a **comprehensive set of geographic projections**, built on top of Cartopy and Altair/d3.js;
- an **interface to OpenstreetMap Nominatim and Overpass API**. Result of requests are parsed in a convenient format for preprocessing and storing in standard formats;
- beautiful **default parameters** for quality visualisations;
- **advanced caching facilities**. Do not download twice the same content in the same day.

The cartes library is a powerful asset to **publish clean, lightweight geographical datasets**; and to **produce decent geographical visualisations** in few lines of code.

## Gallery

<a href="https://cartes-viz.github.io/gallery/mercantour.html"><img width="20%" src="https://cartes-viz.github.io/_static/homepage/mercantour.png"></a>
<a href="https://cartes-viz.github.io/gallery/footprint.html"><img width="20%" src="https://cartes-viz.github.io/_static/homepage/antibes.png"></a>
<a href="https://cartes-viz.github.io/gallery/airports.html"><img width="20%" src="https://cartes-viz.github.io/_static/homepage/airports.png"></a>
<a href="https://cartes-viz.github.io/gallery/tokyo_metro.html#zoom-in-to-downtown-tokyo"><img width="20%" src="https://cartes-viz.github.io/_static/homepage/tokyo.png"></a>

More in the [documentation](https://cartes-viz.github.io/gallery.html)

## Installation

Latest release:

Recommended, with conda:

```sh
conda install -c conda-forge cartes
```

or with pip:

```sh
pip install cartes
```

Development version:

```sh
git clone https://github.com/xoolive/cartes
cd cartes
pip install .
```

## Documentation

![docs](https://github.com/xoolive/cartes/workflows/docs/badge.svg)

Documentation available at https://cartes-viz.github.io/
