Metadata-Version: 2.4
Name: py-richdem
Version: 2.2.0rc2
Summary: Python interface to the RichDEM terrain analysis library.
Author-email: Richard Barnes <rbarnes@umn.edu>
License-Expression: GPL-3.0-only
Project-URL: Changelog, https://github.com/mcflugen/py-richdem/blob/main/CHANGES.md
Project-URL: Homepage, https://github.com/mcflugen/py-richdem
Project-URL: Repository, https://github.com/mcflugen/py-richdem
Keywords: GIS,terrain,hydrology,geomorphology,raster
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Other Audience
Classifier: Natural Language :: English
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Software Development :: Libraries
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: numpy>=1.23
Provides-Extra: gdal
Requires-Dist: gdal; extra == "gdal"
Dynamic: license-file

# py-richdem

**py-richdem** provides high-performance terrain analysis and hydrologic processing
for digital elevation models (DEMs), built on the original
[**RichDEM**](https://github.com/r-barnes/richdem) C++ core
and distributed as a modern Python package with multi-platform wheels.

## Relationship with RichDEM

**py-richdem** is derived from the original **RichDEM** project by
[Richard Barnes](https://github.com/r-barnes/).

> This project does not claim authorship of upstream **RichDEM** algorithms.

This project:

* Vendors the **RichDEM** C++ terrain analysis core
* Removes components unrelated to the Python interface
* Modernizes the build and packaging system
* Provides multi-platform wheels
* Maintains a focused Python distribution

This project does **not** aim to:

* Replace the upstream C++ project
* Redesign core terrain algorithms without clear documentation
* Diverge unnecessarily from upstream behavior

Changes in this repository are limited to:

* Build system modernization
* Packaging and distribution infrastructure
* Compatibility fixes
* Bug fixes required for supported Python versions
* Select performance or stability improvements

## Attribution and Citation

All scientific credit for the terrain analysis algorithms belongs to the original
authors of **RichDEM**.

If you use this software in academic work, please cite:

* The original RichDEM publication(s)
* This repository (if appropriate for reproducibility)
