Skip to main content

PaperMap is a Python package and CLI for creating ready-to-print paper maps.

Project description

PaperMap

PyPI Supported Python Versions pre-commit.ci status Test Documentation Status PyPI - License

PaperMap is a Python package and CLI for creating ready-to-print paper maps.

Installation

From PyPI

PaperMap is available on PyPI.

As a package

For use as a package, install PaperMap with pip or your package manager of choice:

pip install papermap

As a CLI tool

For use as a CLI tool, we recommend installing PaperMap with pipx:

pipx install papermap

From source

If you'd like, you can also install PaperMap from source (with flit):

git clone https://github.com/sgraaf/papermap.git
cd papermap
python3 -m pip install flit
flit install

Documentation

Check out the PaperMap documentation for the User's Guide and API Reference.

Usage

PaperMap can be used both in your own applications as a package, as well as a CLI tool.

As a package

Using the default values, the example below will create an portrait-oriented, A4-sized map of Bangkok at scale 1:25000:

>>> from papermap import PaperMap
>>> pm = PaperMap(13.75889, 100.49722)
>>> pm.render()
>>> pm.save("Bangkok.pdf")

You can easily customize the generated map by changing the tile server, size, orientation, etc. For an exhaustive list of all available options, please see the API Reference.

For example, the example below will create a landscape-oriented, A3-sized map of Madrid using the Stamen Terrein tile server, with a UTM grid overlay, at scale 1:50000:

>>> from papermap import PaperMap
>>> pm = PaperMap(
...     lat=40.416775,
...     lon=-3.703790,
...     tile_server="Stamen Terrain",
...     size="a3",
...     landscape=True,
...     scale=50_000,
...     add_grid=True,
>>> )
>>> pm.render()
>>> pm.save("Madrid.pdf")

As a CLI tool

Similarly, using the default values, the example below will create an portrait-oriented, A4-sized map of Bangkok at scale 1:25000:

$ papermap latlon -- 13.75889 100.49722 Bangkok.pdf

As with the package, maps generated through the CLI are also highly customizable. Please see the CLI Reference for an exhaustive list of all available options.

The example below will create a landscape-oriented, A3-sized map of Madrid using the Stamen Terrein tile server, with a UTM grid overlay, at scale 1:50000:

$ papermap latlon \
    --tile-server "Stamen Terrain" \
    --size a3 \
    --landscape \
    --scale 50000 \
    --grid \
    -- 40.416775 -3.703790 Madrid.pdf

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

papermap-0.3.0.tar.gz (36.8 MB view hashes)

Uploaded source

Built Distribution

papermap-0.3.0-py3-none-any.whl (29.8 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page