cartograpy

Mapping in Python, the way it was always meant to be.

Cartograpy is a Python package for loading, processing, and mapping geographic data in a few lines of code: from a country's administrative boundaries to the final static map, ready to export, anywhere in the world.

Features

• Data: download administrative boundaries (GeoBoundaries), OpenStreetMap data, hydrography, geocoding, elevation (SRTM), World Bank indicators, weather/climate series (NASA POWER), Google Earth Engine imagery, or STAC catalogs (Planetary Computer, AWS Earth Search…) in one line; results returned as GeoDataFrame/DataFrame/RasterTools.
• Processing: import/export all common formats (Shapefile, GeoJSON, KML, GPX, GPKG, CSV, Parquet…), reproject, clip, merge, compute centroids, joins, and dynamic attributes (VectorTools, RasterTools); automatic UTM projection for accurate metric distances/areas, lazy/windowed raster loading for large files.
• Mapping: choropleth, point, polygon, raster, bivariate, or hexbin maps with the Map class (north arrow, scale bar, situation inset map, legends, graticule, PNG/SVG export); publication-ready multi-panel plates (Layout); interactive web maps (WebMap, Folium/lonboard/kepler.gl engines).
• Styling: Google Fonts, 16 built-in palettes + seaborn/matplotlib, graphic styles (scienceplots, mplcyberpunk).
• Project: Project structures folders and outputs, tracks the CRS, and validates dataset integrity.
• CLI: a cartograpy command (init, fetch, inspect, convert, map, doctor) for common tasks without writing a Python script.

Installation

pip install cartograpy

Online data sources and web maps are optional extras:

pip install cartograpy[osm,stac]   # or cartograpy[all]

How it works

Quick start

from cartograpy.data import Bound
from cartograpy.mapper import Map

bound = Bound()
civ = bound.get_admin("CIV", adm=0)          # national boundaries, via GeoBoundaries

m = Map(title="Côte d'Ivoire")
m.add_polygons(civ, facecolor="lightyellow", edge_color="black", alpha=1)
m.add_north_arrow()
m.add_scale_bar()
m.show()

m.save("cote-divoire.png", dpi=300)          # print-ready export

Command line

Common tasks without writing Python, via the cartograpy command installed with the package:

cartograpy init mon_projet
cartograpy fetch boundary CIV --adm 2
cartograpy map regions.gpkg --column population -o map.png
cartograpy doctor        # check Python, GDAL/PROJ/GEOS, core and optional deps

The modules

Everything is importable from the root (from cartograpy import Map, Bound, Project) or from each submodule.

Going further

Full documentation (API reference, step-by-step guides, gallery) is available at mr-kam.github.io/cartograpy.

For an interactive tour of all the features, see the notebooks folder notebooks/.

License

MIT: see LICENSE.