Metadata-Version: 2.4
Name: cartes
Version: 0.8.5
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: Programming Language :: Python :: 3.13
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.10
Requires-Dist: altair>=5.4.1
Requires-Dist: appdirs>=1.4.4
Requires-Dist: beautifulsoup4>=4.14.2
Requires-Dist: cartopy>=0.25.0
Requires-Dist: fastapi>=0.120.1
Requires-Dist: geopandas>=1.1.1
Requires-Dist: httpx[http2]>=0.27.2
Requires-Dist: jsonschema>=4.25.1
Requires-Dist: lxml>=6.0.2
Requires-Dist: matplotlib>=3.10.7
Requires-Dist: nest-asyncio>=1.6.0
Requires-Dist: networkx>=3.2.1
Requires-Dist: networkx>=3.5; python_version >= '3.11'
Requires-Dist: numpy>=2.1.2
Requires-Dist: numpy>=2.3.4; python_version >= '3.11'
Requires-Dist: pandas>=2.3.3
Requires-Dist: pydantic-core>=2.41.4
Requires-Dist: pyogrio>=0.11.1
Requires-Dist: pyproj>=3.7.0
Requires-Dist: pyproj>=3.7.2; python_version >= '3.11'
Requires-Dist: scipy>=1.14.1
Requires-Dist: scipy>=1.16.2; python_version >= '3.11'
Requires-Dist: shapely>=2.1.2
Requires-Dist: tqdm>=4.66.5
Requires-Dist: uvicorn>=0.38.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 for beginners, with conda:

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

or with pip:

```sh
pip install cartes
```

Development version, with uv:

```sh
git clone https://github.com/xoolive/cartes
cd cartes
uv sync --dev
```

## Documentation

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

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