ne-loader 0.4.1

A simple loader for Natural Earth map data.

NE Loader

A simple, robust Python package to download and load Natural Earth map data using GeoPandas.

Features

• Download and cache Natural Earth datasets
• Load shapefiles as GeoDataFrames

Installation

pip install ne-loader

Usage

from ne_loader import map_loader
world = map_loader.get_natural_earth('cultural', 'admin_0_countries')

Errors are raised by default. To return the caught exception instead:

result = map_loader.get_natural_earth(
    'cultural',
    'admin_0_countries',
    error_mode='return',
)

CLI

ne-loader --help

To set an environment override for the NE data save path:

export NATURAL_EARTH_CACHE_DIR="..."

Some commands include:
List cached datasets.

ne-loader list

Query where the cached datasets are.
If you change NATURAL_EARTH_CACHE_DIR, the command shows the active cache path for the current environment.

ne-loader where

Download a Natural Earth Dataset. Default resolution is 10m.

ne-loader download {category} {name} --res {res}

Example usage to download 10m_admin_0_countries

ne-loader download cultural admin_0_countries

Delete either one dataset or all, from current cache directory.

ne-loader rm {dataset}
# or
ne-loader rm --all

Tests

python3 -m pytest tests

License

MIT