Metadata-Version: 2.4
Name: lidar-rs
Version: 0.2.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Rust
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Dist: numpy>=1.24
Requires-Dist: pytest>=7 ; extra == 'test'
Provides-Extra: test
License-File: LICENSE
License-File: NOTICE
Summary: Pure-Rust port of opengeos/lidar for delineating nested surface depressions and mounts in DEMs (powered by terrio and richdem)
Keywords: GIS,lidar,dem,hydrology,depressions,terrain,rust
Author-email: Qiusheng Wu <giswqs@gmail.com>
License-Expression: MIT
Requires-Python: >=3.11
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://github.com/opengeos/lidar-rs
Project-URL: Issues, https://github.com/opengeos/lidar-rs/issues
Project-URL: Repository, https://github.com/opengeos/lidar-rs

# lidar-rs (Python bindings)

Pure-Rust port of [`opengeos/lidar`](https://github.com/opengeos/lidar) for delineating nested surface depressions and mounts in digital elevation models (DEMs), powered by [`terrio`](https://github.com/opengeos/terrio) and [`richdem`](https://github.com/opengeos/richdem-rs) with **zero GDAL or C/C++ dependencies**.

## Installation

Build from source with [maturin](https://www.maturin.rs/):

```sh
cd python
maturin develop --release
```

## Quick Start

```python
import lidar_rs as lidar

med = lidar.MedianFilter("dem.tif", kernel_size=3, out_file="out/median.tif")
sink = lidar.ExtractSinks(med, min_size=1000, out_dir="out")
dep_id, dep_level = lidar.DelineateDepressions(
    sink, min_size=1000, min_depth=0.3, interval=0.3, out_dir="out", bool_level_shp=True
)
```

