surtgis
High-performance geospatial analysis library for Python, powered by Rust.
SurtGIS provides 40+ terrain, hydrology, and imagery algorithms with native performance through PyO3 bindings.
Installation
pip install surtgis
Quick Start
import numpy as np
import surtgis
# Create a sample DEM (100x100 grid)
dem = np.random.rand(100, 100) * 100 # Elevation in meters
cell_size = 30.0 # 30m resolution
# Compute terrain derivatives
slope = surtgis.slope(dem, cell_size)
aspect = surtgis.aspect_degrees(dem, cell_size)
hillshade = surtgis.hillshade_compute(dem, cell_size, azimuth=315.0, altitude=45.0)
# Curvature analysis
profile_curv = surtgis.curvature_compute(dem, cell_size, ctype="profile")
plan_curv = surtgis.curvature_compute(dem, cell_size, ctype="plan")
# Advanced Florinsky curvatures (14 types available)
mean_h = surtgis.advanced_curvature(dem, cell_size, ctype="mean_h")
gaussian_k = surtgis.advanced_curvature(dem, cell_size, ctype="gaussian_k")
# Hydrology
twi = surtgis.twi_compute(dem, cell_size) # Topographic Wetness Index
hand = surtgis.hand_compute(dem, cell_size) # Height Above Nearest Drainage
print(f"Slope range: {slope.min():.1f} - {slope.max():.1f}")
print(f"TWI range: {twi.min():.2f} - {twi.max():.2f}")
Available Functions
Terrain Analysis (21 functions)
| Function | Description |
|---|---|
slope(dem, cell_size) |
Slope in degrees or percent |
aspect_degrees(dem, cell_size) |
Aspect in degrees (0-360) |
hillshade_compute(dem, cell_size, azimuth, altitude) |
Analytical hillshade |
multidirectional_hillshade(dem, cell_size) |
Multi-azimuth hillshade |
curvature_compute(dem, cell_size, ctype) |
Profile, plan, or general curvature |
advanced_curvature(dem, cell_size, ctype) |
14 Florinsky curvatures |
tpi_compute(dem, cell_size, radius) |
Topographic Position Index |
tri_compute(dem, cell_size) |
Terrain Ruggedness Index |
dev_compute(dem, cell_size, radius) |
Deviation from Mean Elevation |
vrm_compute(dem, cell_size, radius) |
Vector Ruggedness Measure |
geomorphons_compute(dem, cell_size, flatness, radius) |
Landform classification |
mrvbf_compute(dem, cell_size) |
Multi-resolution Valley Bottom Flatness |
northness_compute(dem, cell_size) |
Cosine of aspect |
eastness_compute(dem, cell_size) |
Sine of aspect |
shape_index_compute(dem, cell_size) |
Shape index |
curvedness_compute(dem, cell_size) |
Curvedness |
sky_view_factor_compute(dem, cell_size) |
Sky View Factor |
viewshed_compute(dem, cell_size, observer_row, observer_col) |
Line-of-sight visibility |
openness_positive(dem, cell_size) |
Positive openness |
openness_negative(dem, cell_size) |
Negative openness |
uncertainty_slope(dem, cell_size, dem_rmse) |
Slope uncertainty from DEM error |
Hydrology (9 functions)
| Function | Description |
|---|---|
fill_depressions(dem, cell_size) |
Planchon-Darboux sink filling |
priority_flood_fill(dem, cell_size) |
Priority-Flood (Barnes 2014) |
breach_fill(dem, cell_size) |
Breach depressions (Lindsay 2016) |
flow_direction_d8(dem, cell_size) |
D8 flow direction |
flow_accumulation_d8(fdir, cell_size) |
D8 flow accumulation |
flow_accumulation_mfd_compute(dem, cell_size) |
Multi-flow direction accumulation |
twi_compute(dem, cell_size) |
Topographic Wetness Index |
hand_compute(dem, cell_size) |
Height Above Nearest Drainage |
stream_network_compute(dem, cell_size, threshold) |
Stream network extraction |
Imagery (4 functions)
| Function | Description |
|---|---|
ndvi_compute(nir, red) |
Normalized Difference Vegetation Index |
ndwi_compute(green, nir) |
Normalized Difference Water Index |
savi_compute(nir, red, l_factor) |
Soil-Adjusted Vegetation Index |
normalized_diff(a, b) |
Generic normalized difference |
Morphology (4 functions)
| Function | Description |
|---|---|
morph_erode(data, radius) |
Morphological erosion |
morph_dilate(data, radius) |
Morphological dilation |
morph_opening(data, radius) |
Morphological opening |
morph_closing(data, radius) |
Morphological closing |
Statistics (3 functions)
| Function | Description |
|---|---|
focal_mean(data, radius) |
Focal mean |
focal_std(data, radius) |
Focal standard deviation |
focal_range(data, radius) |
Focal range (max - min) |
Advanced Curvature Types
The advanced_curvature function supports 14 curvature types from Florinsky (2025):
mean_h- Mean curvature Hgaussian_k- Gaussian curvature Kunsphericity_m- Unsphericity Mdifference_e- Difference curvature Eminimal_kmin- Minimal principal curvaturemaximal_kmax- Maximal principal curvaturehorizontal_kh- Horizontal (plan) curvaturevertical_kv- Vertical (profile) curvaturehorizontal_excess_khe- Horizontal excess curvaturevertical_excess_kve- Vertical excess curvatureaccumulation_ka- Accumulation curvaturering_kr- Ring curvaturerotor- Rotor (flow-line torsion)laplacian- Laplacian
Performance
SurtGIS is 5-10x faster than pure Python implementations thanks to Rust's zero-cost abstractions and automatic parallelization via Rayon.
License
MIT OR Apache-2.0
1 maintainer
Release files for surtgis 1.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| surtgis-1.4.0.tar.gz | 934.5 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| surtgis-1.4.0-cp39-abi3-win_amd64.whl | CPython 3.9 | abi3 | Windows x86-64 | Details |
| surtgis-1.4.0-cp39-abi3-musllinux_1_2_x86_64.whl | CPython 3.9 | abi3 | Linux musl 1.2+ x86-64 | Details |
| surtgis-1.4.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.9 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| surtgis-1.4.0-cp39-abi3-macosx_11_0_arm64.whl | CPython 3.9 | abi3 | macOS 11.0+ ARM64 | Details |
| surtgis-1.4.0-cp39-abi3-macosx_10_12_x86_64.whl | CPython 3.9 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 16.9 MB
Release files / surtgis-1.4.0.tar.gz
| Download URL | surtgis-1.4.0.tar.gz |
|---|---|
| Size | 934.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0d144f1739293c213d81f6db5f4ecb93190a28e6bcb4c2a830de031948b6fd47
|
|
BLAKE2b-256 checksum How to use checksums |
afb1bf706babf0010805486dae775d04b46d333a093f137ac6d1f9e0ad145e03
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.
Transparency logRelease files / surtgis-1.4.0-cp39-abi3-win_amd64.whl
| Download URL | surtgis-1.4.0-cp39-abi3-win_amd64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | CPython 3.9 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
56f22ca0ce1f766dfde4a24966e5c08c86c603ee640602b0f546a5f7abfc94b2
|
|
BLAKE2b-256 checksum How to use checksums |
e82211256e76c92c9dfa8f056f4e8e1ae018450b3d22f13ae4b4eaf87a0a410b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.
Transparency logRelease files / surtgis-1.4.0-cp39-abi3-musllinux_1_2_x86_64.whl
| Download URL | surtgis-1.4.0-cp39-abi3-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.9 Linux musl 1.2+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
92fa92f0877fca7d01c6eeaf5a75041b49dc9e119be2cb7c01d5cbb3c90149a7
|
|
BLAKE2b-256 checksum How to use checksums |
36e293155f4edc21d166c75d6859554a526110be3d24cc079dd6967b860013d5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.
Transparency logRelease files / surtgis-1.4.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | surtgis-1.4.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | CPython 3.9 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
100ba6bae3ec183b46d3c0cf547f82337e90a77ba02e03f5f9a870077ed2990b
|
|
BLAKE2b-256 checksum How to use checksums |
9a60738ef19caeba92768006182efa6bddbd53dac71c3235eca4311fce36b183
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.
Transparency logRelease files / surtgis-1.4.0-cp39-abi3-macosx_11_0_arm64.whl
| Download URL | surtgis-1.4.0-cp39-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.9 MB |
| Tags | CPython 3.9 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
1bc8a0e0aaa193b1ad3e9f53ecf76b1ee711a3d76942bf356bc9372620c0cac9
|
|
BLAKE2b-256 checksum How to use checksums |
e9487708fefd30aa902506b243a6b565b58a03788d94a99cdb421e237ab66ac3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.
Transparency logRelease files / surtgis-1.4.0-cp39-abi3-macosx_10_12_x86_64.whl
| Download URL | surtgis-1.4.0-cp39-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | CPython 3.9 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
2efe351dded97e32a4b22809cb96071253b2f629a5a05afc9259073e0ffe2cd2
|
|
BLAKE2b-256 checksum How to use checksums |
189fde02e89b4e425805042c67feb09c3d261ce57828c19bc0858aa9a766ae27
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.
Transparency log
