pysatgeo

pysatgeo is a small Python package for raster and vector geospatial processing.

The project started as a learning repo for packaging, CI, and geospatial utilities. It has now been trimmed down to a smaller set of maintained modules with clearer imports, better tests, and lighter docs.

Current Scope

The package is organized into a few focused modules:

• raster: reprojection, clipping, stacking, alignment, polygonizing
• vector: CRS assignment, format conversion, clipping, dissolve
• raster_analysis: normalization, reclassification, clustering
• terrain: DEM-related helpers such as slope and aspect
• sampling: point generation and raster sampling
• ranking: simple AHP-style ranking helpers
• styles, netcdf, and gee: smaller utility modules

Project Status

This package is still modest, but it is much more coherent than the original experimental repo.

• Public imports are available from pysatgeo itself.
• Top-level imports are resolved lazily to keep import pysatgeo lightweight.
• Core behavior is covered by automated tests.
• Old experimental modules that were not maintained or documented have been removed.

Installation

Because the package depends on GDAL, rasterio, and geopandas, a Conda environment is usually the easiest setup, especially on Windows.

Example:

conda create -n pysatgeo python=3.11 -y
conda activate pysatgeo
conda install -c conda-forge geopandas rasterio rioxarray gdal pyarrow shapely xarray scikit-learn matplotlib mapclassify scipy pytest -y
pip install pysatgeo

If you are working from this repository:

pip install -r requirements.txt
pip install -e .

Quick Start

Import the package directly:

import pysatgeo

Use functions from the top level:

import pysatgeo

pysatgeo.reproject_clip_resample_tiff(...)
pysatgeo.assign_crs_to_vector(...)

Module-level imports still work too:

from pysatgeo.raster import reproject_clip_resample_tiff
from pysatgeo.vector import assign_crs_to_vector

Development

Run the test suite from the repository root:

conda run -n pysatgeo pytest -q

The current test suite covers:

• top-level package import behavior
• raster and vector validation paths
• raster sampling and analysis helpers
• ranking helpers
• NetCDF and style parsing utilities

Documentation

Project documentation lives in the docs/ folder and is published at:

https://JPPereira93.github.io/pysatgeo

The most useful pages are:

• docs/usage.md for quick examples
• docs/installation.md for environment setup
• the API Reference pages for module docs

License

MIT License