Registry / data / basemap-data

basemap-data

JSON →
library2.0.0pypypiunverified

Data assets for matplotlib basemap. This package provides the shapefiles, topography, and other geospatial data required by the basemap toolkit. Version 2.0.0 is a major release that reorganized data handling and removed deprecated datasets. Release cadence is sporadic, tied to basemap releases.

data
pip install basemap-data
github ↗package ↗docs ↗
INSTALL
IMPORT
SIG · BASEMAP-DATA
B
basemap-data
datapythonv2.0.0
Install
2.1s avg
Import
—
Disk
57MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.9–3.13
musl
3.9–3.13
Install & Compatibility
Where this runs
tested against v2.0.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 58.8MB
glibc
py 3.10–3.95 runs
installs and imports cleanly · install 2.1s · import 0.000s · 59MB
57MB installed
● package 57MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

Basemap
✓ from mpl_toolkits.basemap import Basemap
✗ from mpl_toolkits.basemap import Basemap

Minimal example: create a Basemap instance and draw coastlines. Ensure basemap-data is installed so shapefiles are found automatically.

import os os.environ['BASEMAP_DATA_DIR'] = '/path/to/basemap-data' # optional custom path from mpl_toolkits.basemap import Basemap import matplotlib.pyplot as plt m = Basemap(projection='mill', llcrnrlat=-60, urcrnrlat=90, llcrnrlon=-180, urcrnrlon=180) m.drawcoastlines() plt.show()
Debug
Known issues
breakingBasemap and basemap-data packages are removed from metplotlib. Use Cartopy instead.
fix
Migrate to Cartopy: `pip install cartopy` and `import cartopy.crs as ccrs`. See https://matplotlib.org/basemap/users/intro.html
affects: >=2.0.0
gotchabasemap-data does NOT include the full dataset archive. Some older shapefiles may require separate download from SOEST.
fix
If you get missing shapefile errors, ensure basemap-data is installed and you are using a supported projection. Old custom datasets need manual placement in the data directory.
affects: all
deprecatedThe 'basemap' package itself is deprecated. No new features, only critical bug fixes.
fix
Plan migration to Cartopy (https://scitools.org.uk/cartopy/).
affects: all
Upgrade
Version history
2.0.0latest on PyPI · released Jun 13, 2025
Audit
Dependencies
basemaprequiredbasemap-data provides data files used by basemap at runtime; must be installed separately if not using conda.
matplotlibrequiredbasemap depends on matplotlib, required for plotting.
Agent activity
19 hits · last 30 days
node
16
OpenAI (training)
1
Resources
githubhttps://github.com/matplotlib/basemap ↗
packagehttps://pypi.org/project/basemap-data/ ↗
docshttps://matplotlib.org/basemap ↗
basemap-data — pip install basemap-data · libregistry