Generated using DALL·E 3 model with this prompt: Cute stylized conducting virtuoso using a paper map as music sheet. White background, minimalistic, vector graphics, clean background, encased in a circle. In navy and gold colours. Logo for a python library, should work well as small icon.
OvertureMaestro
An open-source tool for reading OvertureMaps data with multiprocessing and additional Quality-of-Life features.
What is OvertureMaestro 🎼🌍?
- Scalable reader for OvertureMaps data.
- Is based on top of
PyArrow1. - Saves files in the
GeoParquet2 file format for easier integration with modern cloud stacks. - Filters data based on geometry.
- Can filter data using PyArrow expressions.
- Utilizes multiprocessing for faster data download.
- Utilizes dedicated index of all features in the Overture Maps dataset to download only specific parts based on the geometry filter.
- Utilizes caching to reduce repeatable computations.
- Can be used as Python module as well as a beautiful CLI based on
Typer3.
Installing
As pure Python module
pip install overturemaestro
With beautiful CLI
pip install overturemaestro[cli]
Required Python version?
OvertureMaestro supports Python >= 3.10
Dependencies
Required:
-
overturemaps (>=0.8.0): Reusing oficial CLI library with dedicated schema related functions -
pyarrow (>=16.0.0): For OvertureMaps GeoParquet dataset wrangling -
geopandas (>=1.0): For returning GeoDataFrames and reading Geo files -
shapely (>=2.0): For parsing WKT and GeoJSON strings and filtering data with STRIndex -
geoarrow-rust-core (>=0.4.0): For transforming Arrow data to Shapely objects -
duckdb (>=1.1.2): For transforming downloaded data to the wide format and sorting files by geometry -
pooch (>=1.6.0): For downloading precalculated dataset indexes -
rich (>=12.0.0): For showing progress bars -
fsspec (>=2021.04.0)&aiohttp (>=3.8.0): For accessing AWS S3 datasets in PyArrow and GitHub files for precalculated datasets -
geopy (>=2.0.0): For geocoding of strings
Optional:
-
typer[all] (>=0.9.0)(click, colorama, rich, shellingham): Required in CLI -
h3 (>=4.0.0b1): For reading H3 strings. Required in CLI -
s2 (>=0.1.9): For transforming S2 indexes into geometries. Required in CLI -
python-geohash (>=0.8): For transforming GeoHash indexes into geometries. Required in CLI
Usage
TODO
1 maintainer
Metadata
1 maintainer
Release files for OvertureMaestro 0.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| overturemaestro-0.7.0.tar.gz | 305.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| overturemaestro-0.7.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 362.5 kB
Release files / overturemaestro-0.7.0.tar.gz
| Download URL | overturemaestro-0.7.0.tar.gz |
|---|---|
| Size | 305.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7bc27512e7328f1016e363db217ace8f092d40e55303e0ee04f42f95f6b83023
|
|
BLAKE2b-256 checksum How to use checksums |
59086d2a583b171522104819905b9692edeeaad9b39736f90ca0146b5b775691
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
pdm/2.29.2 CPython/3.12.14 Linux/6.17.0-1022-azure
|
Release files / overturemaestro-0.7.0-py3-none-any.whl
| Download URL | overturemaestro-0.7.0-py3-none-any.whl |
|---|---|
| Size | 57.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ca75639a3645d615f0050960174c17993d3b0ff68e90f7c81c99bd75b95d0d06
|
|
BLAKE2b-256 checksum How to use checksums |
bf05121e10aa344e4dd79ca551fc024dce8cc091e8fcd6015dd90b9d81dff8ff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
pdm/2.29.2 CPython/3.12.14 Linux/6.17.0-1022-azure
|
