GeoGrapher is a Python library for building object-centric machine learning datasets from remote sensing data—starting with a list of objects (vector features such as locations or polygonal segmentation masks) rather than a specific area. At its core, GeoGrapher leverages a bipartite graph structure to efficiently associate objects with relevant geospatial data, solving common challenges in object-centric dataset construction. It provides flexible, customizable cutting of large remote sensing rasters, ensuring precise data extraction.
For a deeper dive, check out the blog post or explore the documentation.
This package has two external dependencies:
- Python 3.9 or newer.
- The geopandas and rasterio libraries might depend on GDAL base C libraries.
See https://geopandas.org/en/stable/getting_started/install.html#dependencies
and https://pypi.org/project/rasterio/
for instructions on installing these. On many Linux distros, you can use the
the
gdal-develorlibgdal-devpackages.
The package itself (and its Python dependencies) can be installed with
pip install GeoGrapher
Here are several options for getting started:
- Try out the tutorial notebooks in the notebooks directory,
- Read the documentation.
To create a local dev installation, clone the repo, cd into the repo folder,
and use the commands
python -m venv geographer-env
source geographer-env/bin/activate
make -B venv
to create a virtual environment, activate it, and create an editable local installation of the package and its dependencies.
Use the make format, make lint, make test, and make docs commands to format,
lint, or test the code or to create the documentation locally.
To create the documentation locally, you will need to install the pandoc external dependency following the instructions here https://pandoc.org/installing.html.
You can contribute by giving feedback, opening an issue, submitting feature requests or bug reports, or submitting pull requests.
Give this project a star if you like it!
Contact the maintainer at @rustamdantia.
This project is licensed under a version of the Hippocratic License that in particular prohibits use for military activites. You can find a copy of the license here.