{"id":15932774,"url":"https://github.com/sgraaf/papermap","last_synced_at":"2026-03-09T16:06:01.131Z","repository":{"id":56311402,"uuid":"213895414","full_name":"sgraaf/papermap","owner":"sgraaf","description":"PaperMap is a Python package and CLI for creating ready-to-print paper maps.","archived":false,"fork":false,"pushed_at":"2026-01-21T17:10:07.000Z","size":65523,"stargazers_count":39,"open_issues_count":6,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-21T23:58:05.648Z","etag":null,"topics":["cartography","geodesy","map","maps","mgrs","openstreetmap","osm","paper","topography","utm"],"latest_commit_sha":null,"homepage":"https://papermap.readthedocs.io/en/stable/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sgraaf.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-10-09T11:04:41.000Z","updated_at":"2026-01-21T17:13:01.000Z","dependencies_parsed_at":"2025-12-03T07:05:27.647Z","dependency_job_id":null,"html_url":"https://github.com/sgraaf/papermap","commit_stats":{"total_commits":38,"total_committers":3,"mean_commits":"12.666666666666666","dds":0.1578947368421053,"last_synced_commit":"5bd250b5c1e2a6f329f01d985dcc8264947084c1"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/sgraaf/papermap","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgraaf%2Fpapermap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgraaf%2Fpapermap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgraaf%2Fpapermap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgraaf%2Fpapermap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sgraaf","download_url":"https://codeload.github.com/sgraaf/papermap/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgraaf%2Fpapermap/sbom","scorecard":{"id":814506,"data":{"date":"2025-08-11","repo":{"name":"github.com/sgraaf/papermap","commit":"5bd250b5c1e2a6f329f01d985dcc8264947084c1"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.1,"checks":[{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Code-Review","score":0,"reason":"Found 1/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/publish.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.2.2 not signed: https://api.github.com/repos/sgraaf/papermap/releases/34450867","Warn: release artifact v0.2.1 not signed: https://api.github.com/repos/sgraaf/papermap/releases/33391723","Warn: release artifact v0.2.2 does not have provenance: https://api.github.com/repos/sgraaf/papermap/releases/34450867","Warn: release artifact v0.2.1 does not have provenance: https://api.github.com/repos/sgraaf/papermap/releases/33391723"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/sgraaf/papermap/publish.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/sgraaf/papermap/publish.yml/main?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/publish.yml:21","Info:   0 out of   2 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   1 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 4 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-23T13:55:21.895Z","repository_id":56311402,"created_at":"2025-08-23T13:55:21.895Z","updated_at":"2025-08-23T13:55:21.895Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30301562,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T14:33:48.460Z","status":"ssl_error","status_checked_at":"2026-03-09T14:33:48.027Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cartography","geodesy","map","maps","mgrs","openstreetmap","osm","paper","topography","utm"],"created_at":"2024-10-07T02:03:49.859Z","updated_at":"2026-03-09T16:06:01.119Z","avatar_url":"https://github.com/sgraaf.png","language":"Python","readme":"\u003c!-- start docs-include-index --\u003e\n\n# papermap\n\n[![PyPI](https://img.shields.io/pypi/v/papermap)](https://img.shields.io/pypi/v/papermap)\n[![Supported Python Versions](https://img.shields.io/pypi/pyversions/papermap)](https://pypi.org/project/papermap/)\n[![CI](https://github.com/sgraaf/papermap/actions/workflows/ci.yml/badge.svg)](https://github.com/sgraaf/papermap/actions/workflows/ci.yml)\n[![Test](https://github.com/sgraaf/papermap/actions/workflows/test.yml/badge.svg)](https://github.com/sgraaf/papermap/actions/workflows/test.yml)\n[![Documentation Status](https://readthedocs.org/projects/papermap/badge/?version=latest)](https://papermap.readthedocs.io/en/latest/?badge=latest)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11822/badge)](https://www.bestpractices.dev/projects/11822)\n\n*papermap* is a Python library and CLI tool for creating ready-to-print paper maps.\n\n\u003c!-- end docs-include-index --\u003e\n\n## Installation\n\n\u003c!-- start docs-include-installation --\u003e\n\n*papermap* is available on [PyPI](https://pypi.org/project/papermap/). Install with [uv](https://docs.astral.sh/uv/) or your package manager of choice:\n\n```sh\nuv add papermap\n```\n\n\u003c!-- end docs-include-installation --\u003e\n\n## Documentation\n\nCheck out the [*papermap* documentation](https://papermap.readthedocs.io/en/stable/) for the [User's Guide](https://papermap.readthedocs.io/en/stable/usage.html), [API Reference](https://papermap.readthedocs.io/en/stable/api.html) and [CLI Reference](https://papermap.readthedocs.io/en/stable/cli.html).\n\n## Usage\n\n\u003c!-- start docs-include-usage --\u003e\n\n*papermap* can be used both in your own applications as a package, as well as a CLI tool.\n\n### As a Library\n\n#### Basic Usage\n\nCreate a simple portrait-oriented, A4-sized map at scale 1:25000:\n\n```python\n\u003e\u003e\u003e from papermap import PaperMap\n\u003e\u003e\u003e pm = PaperMap(13.75889, 100.49722)  # Bangkok, Thailand\n\u003e\u003e\u003e pm.render()\n\u003e\u003e\u003e pm.save(\"Bangkok.pdf\")\n```\n\n#### Custom Size and Orientation\n\nCreate a landscape-oriented, A3-sized map with grid overlay:\n\n```python\n\u003e\u003e\u003e from papermap import PaperMap\n\u003e\u003e\u003e pm = PaperMap(\n...     lat=40.416775,\n...     lon=-3.703790,  # Madrid, Spain\n...     tile_provider_key=\"stadia-stamenterrain\",\n...     size=\"a3\",\n...     landscape=True,\n...     scale=50_000,\n...     add_grid=True,\n... )\n\u003e\u003e\u003e pm.render()\n\u003e\u003e\u003e pm.save(\"Madrid.pdf\")\n```\n\n#### Satellite Imagery\n\nCreate a map using satellite imagery:\n\n```python\n\u003e\u003e\u003e from papermap import PaperMap\n\u003e\u003e\u003e pm = PaperMap(\n...     lat=51.5074,\n...     lon=-0.1278,  # London, UK\n...     tile_provider_key=\"esri-worldimagery\",\n...     size=\"a4\",\n...     scale=10_000,\n... )\n\u003e\u003e\u003e pm.render()\n\u003e\u003e\u003e pm.save(\"London_Satellite.pdf\")\n```\n\n#### Topographic Maps\n\nCreate a topographic map for hiking:\n\n```python\n\u003e\u003e\u003e from papermap import PaperMap\n\u003e\u003e\u003e pm = PaperMap(\n...     lat=46.5197,\n...     lon=7.9577,  # Mürren, Switzerland\n...     tile_provider_key=\"opentopomap\",\n...     size=\"a3\",\n...     landscape=True,\n...     scale=25_000,\n...     add_grid=True,\n...     grid_size=500,  # 500m grid for easier navigation\n... )\n\u003e\u003e\u003e pm.render()\n\u003e\u003e\u003e pm.save(\"Murren_Topo.pdf\")\n```\n\n#### High-Resolution Printing\n\nCreate a high-resolution map for professional printing:\n\n```python\n\u003e\u003e\u003e from papermap import PaperMap\n\u003e\u003e\u003e pm = PaperMap(\n...     lat=35.6762,\n...     lon=139.6503,  # Tokyo, Japan\n...     tile_provider_key=\"openstreetmap\",\n...     size=\"a0\",  # Large format\n...     landscape=True,\n...     scale=15_000,\n...     dpi=600,  # High resolution\n...     add_grid=True,\n... )\n\u003e\u003e\u003e pm.render()\n\u003e\u003e\u003e pm.save(\"Tokyo_HighRes.pdf\")\n```\n\n#### Using UTM Coordinates\n\nCreate a map using UTM coordinates instead of latitude/longitude:\n\n```python\n\u003e\u003e\u003e from papermap import PaperMap\n\u003e\u003e\u003e pm = PaperMap.from_utm(\n...     easting=500000,\n...     northing=4649776,\n...     zone=30,\n...     hemisphere=\"N\",  # Northern hemisphere\n...     tile_provider_key=\"openstreetmap\",\n...     size=\"a4\",\n...     scale=25_000,\n...     add_grid=True,\n... )\n\u003e\u003e\u003e pm.render()\n\u003e\u003e\u003e pm.save(\"UTM_Map.pdf\")\n```\n\n#### Custom Margins\n\nCreate a map with custom margins for binding:\n\n```python\n\u003e\u003e\u003e from papermap import PaperMap\n\u003e\u003e\u003e pm = PaperMap(\n...     lat=-33.8688,\n...     lon=151.2093,  # Sydney, Australia\n...     tile_provider_key=\"openstreetmap\",\n...     size=\"letter\",\n...     margin_left=20,  # Extra margin for binding\n...     margin_top=10,\n...     margin_right=10,\n...     margin_bottom=10,\n...     scale=20_000,\n... )\n\u003e\u003e\u003e pm.render()\n\u003e\u003e\u003e pm.save(\"Sydney_Binding.pdf\")\n```\n\n#### Using API Keys\n\nSome tile providers require API keys. Here's how to use them:\n\n```python\n\u003e\u003e\u003e from papermap import PaperMap\n\u003e\u003e\u003e pm = PaperMap(\n...     lat=37.7749,\n...     lon=-122.4194,  # San Francisco, USA\n...     tile_provider_key=\"thunderforest-outdoors\",\n...     api_key=\"your_api_key_here\",  # Get from thunderforest.com\n...     size=\"a4\",\n...     landscape=True,\n...     scale=25_000,\n...     add_grid=True,\n... )\n\u003e\u003e\u003e pm.render()\n\u003e\u003e\u003e pm.save(\"SF_Outdoors.pdf\")\n```\n\nFor more options and details, see the [API Reference](https://papermap.readthedocs.io/en/stable/api.html#papermap.papermap.PaperMap).\n\n### As a CLI Tool\n\n#### Basic Usage\n\nCreate a simple portrait-oriented, A4-sized map:\n\n```shell\n$ papermap latlon -- 13.75889 100.49722 Bangkok.pdf\n```\n\n#### Custom Size and Orientation\n\nCreate a landscape-oriented, A3-sized map with grid overlay:\n\n```shell\n$ papermap latlon \\\n    --tile-provider stadia-stamenterrain \\\n    --paper-size a3 \\\n    --landscape \\\n    --scale 50000 \\\n    --grid \\\n    -- 40.416775 -3.703790 Madrid.pdf\n```\n\n#### Satellite Imagery\n\nCreate a map using satellite imagery:\n\n```shell\n$ papermap latlon \\\n    --tile-provider esri-worldimagery \\\n    --scale 10000 \\\n    -- 51.5074 -0.1278 London_Satellite.pdf\n```\n\n#### Topographic Maps\n\nCreate a topographic map for hiking:\n\n```shell\n$ papermap latlon \\\n    --tile-provider opentopomap \\\n    --paper-size a3 \\\n    --landscape \\\n    --scale 25000 \\\n    --grid \\\n    --grid-size 500 \\\n    -- 46.5197 7.9577 Murren_Topo.pdf\n```\n\n#### High-Resolution Printing\n\nCreate a high-resolution map for professional printing:\n\n```shell\n$ papermap latlon \\\n    --tile-provider openstreetmap \\\n    --paper-size a0 \\\n    --landscape \\\n    --scale 15000 \\\n    --dpi 600 \\\n    --grid \\\n    -- 35.6762 139.6503 Tokyo_HighRes.pdf\n```\n\n#### Using UTM Coordinates\n\nCreate a map using UTM coordinates:\n\n```shell\n$ papermap utm \\\n    --tile-provider openstreetmap \\\n    --paper-size a4 \\\n    --scale 25000 \\\n    --grid \\\n    -- 500000 4649776 30 N UTM_Map.pdf\n```\n\n#### Custom Margins\n\nCreate a map with custom margins for binding:\n\n```shell\n$ papermap latlon \\\n    --tile-provider openstreetmap \\\n    --paper-size letter \\\n    --margin-left 20 \\\n    --margin-top 10 \\\n    --margin-right 10 \\\n    --margin-bottom 10 \\\n    --scale 20000 \\\n    -- -33.8688 151.2093 Sydney_Binding.pdf\n```\n\n#### Using API Keys\n\nUse tile providers that require API keys:\n\n```shell\n$ papermap latlon \\\n    --tile-provider thunderforest-outdoors \\\n    --api-key \"your_api_key_here\" \\\n    --paper-size a4 \\\n    --landscape \\\n    --scale 25000 \\\n    --grid \\\n    -- 37.7749 -122.4194 SF_Outdoors.pdf\n```\n\nFor more options and details, see the [CLI Reference](https://papermap.readthedocs.io/en/stable/cli.html).\n\n\u003c!-- end docs-include-usage --\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsgraaf%2Fpapermap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsgraaf%2Fpapermap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsgraaf%2Fpapermap/lists"}