Metadata-Version: 2.4
Name: geospace
Version: 0.6.1
Summary: Geospatial processing library based on GDAL and Google Earth Engine
Author: Cody James
Author-email: Cody James <xiejx5@gmail.com>
License-Expression: MIT
Requires-Dist: gdal-wheel
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: openpyxl
Requires-Dist: tqdm
Requires-Dist: psutil
Requires-Dist: requests ; extra == 'gee'
Requires-Dist: earthengine-api ; extra == 'gee'
Requires-Dist: cartopy ; extra == 'mask'
Requires-Dist: scikit-image ; extra == 'mask'
Requires-Python: >=3.12
Project-URL: homepage, https://github.com/xiejx5/geospace
Provides-Extra: gee
Provides-Extra: mask
Description-Content-Type: text/markdown

# GeoSpace

A lightweight Python library for geospatial processing based on GDAL.

GeoSpace provides practical tools for raster and vector processing, including zonal statistics, reprojection, resampling, mosaicking, clipping, rasterization, and optional Google Earth Engine workflows.

## Installation

```bash
uv add geospace
```

GeoSpace uses [`gdal-wheel`](https://github.com/xiejx5/gdal-wheel) as its GDAL dependency, so GDAL does not need to be compiled as part of GeoSpace.

```python
import geospace
from osgeo import gdal
```

## Example

```python
import geospace as gs

rasters = ["precipitation.tif", "temperature.tif"]
basins = "basins.shp"

stats = gs.reduce(rasters, basins)
print(stats)
```

## Features

- High-performance zonal statistics
- Raster reprojection, resampling, mosaicking, clipping, and nodata filling
- Raster and vector conversion
- Shapefile projection, filtering, buffering, and rasterization
- Coordinate and spatial calculations
- Optional Google Earth Engine integration

## Optional dependencies

Google Earth Engine support:

```bash
uv add "geospace[gee]"
```

Mask-related features:

```bash
uv add "geospace[mask]"
```

## Development

```bash
git clone https://github.com/xiejx5/geospace.git
cd geospace
uv sync
```

GeoSpace is a pure-Python package. GDAL wheels are built and published separately by [`gdal-wheel`](https://github.com/xiejx5/gdal-wheel).
