Metadata-Version: 2.4
Name: georaffer
Version: 0.1.0
Summary: Download and process geospatial tiles (JP2, LAZ) from German state geodata providers
Project-URL: Homepage, https://github.com/michaelschleiss/georaffer
Project-URL: Repository, https://github.com/michaelschleiss/georaffer
Project-URL: Issues, https://github.com/michaelschleiss/georaffer/issues
Author-email: Michael Schleiss <michaelschleiss87@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: bdom,dsm,gdal,geospatial,germany,gis,nrw,orthophoto,rlp
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Python: >=3.10
Requires-Dist: laspy[lazrs]>=2.0
Requires-Dist: numba>=0.50
Requires-Dist: numpy>=1.20
Requires-Dist: pillow>=9.0
Requires-Dist: rasterio>=1.2
Requires-Dist: requests>=2.20
Requires-Dist: tqdm>=4.0
Requires-Dist: utm>=0.7
Provides-Extra: dev
Requires-Dist: pytest-cov; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Description-Content-Type: text/markdown

# georaffer

Download German orthophotos and DSM tiles (NRW, RLP) as GeoTIFF.

## Installation

### pip (macOS, Linux x86, Windows)

```bash
pip install georaffer
```

### conda-forge (all platforms incl. Linux ARM64)

```bash
git clone https://github.com/michaelschleiss/georaffer
cd georaffer
conda create -n georaffer libgdal-jp2openjpeg lazrs-python laspy rasterio -c conda-forge
conda activate georaffer
pip install -e .
```

Or with [pixi](https://pixi.sh):

```bash
git clone https://github.com/michaelschleiss/georaffer
cd georaffer
pixi install
```

## Usage

```bash
# From 4Seasons dataset
georaffer pygeon /data/4seasons/campaign --output ./tiles

# From CSV with coordinates
georaffer csv coords.csv --cols lon,lat --output ./tiles

# From bounding box
georaffer bbox 6.9,50.9,7.1,51.1 --output ./tiles

# From specific tile indices
georaffer tiles 362,5604 --output ./tiles
```

See `georaffer --help` for all options.

## Adding New Regions

Subclass `BaseDownloader` and implement:

- `parse_catalog()` - Parse the region's tile feed/catalog
- `grid_to_filename()` - Convert grid coordinates to download URL
- `utm_to_grid_coords()` - Convert UTM to the region's grid system

See `georaffer/downloaders/nrw.py` as reference.

## License

MIT
