Skip to main content

GISGEARS

A collection of Python tools for GIS/hydrology raster and vector analysis.

WhiteboxTools: wsdgen depends on the WhiteboxTools executable, which the whitebox Python package downloads automatically the first time it runs.

Installation

pip install gisgears

Features

  • wsdgen: Delineate a watershed from a DEM and an outlet layer (point or line)
  • wsdpyshed: Delineate watersheds and the stream network from a DEM and one or more outlets (points or lines) using pysheds (no WhiteboxTools needed)
  • wsdsmooth: Smooth the boundary of a watershed polygon shapefile
  • showtif: Display a DEM GeoTIFF with an elevation colormap and hillshade
  • showshp: Display one or more shapefiles overlaid on a single map
  • showtable: Print the attribute table of a shapefile or GeoPackage layer

Usage

Command-line

# List all available commands
gisgears-info

# Delineate a watershed from a point outlet
wsdgen --dem dem.tif --outlet outlet.shp

# Delineate a watershed from a line outlet (e.g. a cross-section), keeping intermediates
wsdgen --dem dem.tif --outlet crosssection.shp --all-outputs

# Use a coarser/finer boundary-smoothing filter
wsdgen --dem dem.tif --outlet outlet.shp --smooth-filter 15

# Delineate with pysheds from a pour point shapefile or x/y coordinates
wsdpyshed --dem dem.tif --outlet pourpoint.shp
wsdpyshed --dem dem.tif --outlet crosssections.shp  # line outlets, one watershed per line
wsdpyshed --dem dem.tif --xy 285612.0 2936416.7 --acc-threshold 500 --plot

# Smooth a watershed boundary (default filter 9, written to WSD/<name>_smooth.shp)
wsdsmooth WSD/watershed.shp
wsdsmooth watershed.shp --filter 15 -o basin_smooth.shp

# Inspect a DEM (prints CRS/size/stats, plots elevation + hillshade)
showtif dem.tif

# Overlay shapefiles on one map, labelling features by a column
showshp WSD/watershed.shp outlet.shp -l Station

# Print an attribute table (selected columns, with geometry as WKT)
showtable thiessen.shp -c Station -g
showtable data.gpkg -l roads -n 20
showtable data.gpkg --list-layers

Python API

from gisgears import wsdgen

# Delineate a watershed (written to WSD/watershed.tif, watershed.shp, watershed_smooth.shp)
wsdgen.delineate_watershed(dem="dem.tif", outlet="outlet.shp")

from gisgears import wsdpyshed

# Same idea with pysheds; also writes dem_clipped.tif and streams.gpkg/.geojson to WSD/
wsdpyshed.delineate_watershed(dem="dem.tif", outlet="pourpoint.shp", acc_threshold=200)

from gisgears import wsdsmooth

# Smooth a watershed boundary (written to WSD/watershed_smooth.shp)
wsdsmooth.smooth_watershed("WSD/watershed.shp", filter_size=9)

from gisgears import showtif, showshp, showtable

showtif.show_dem("dem.tif")
showshp.show_shapefiles(["WSD/watershed.shp", "outlet.shp"], label="Station")
table = showtable.show_table("thiessen.shp", columns=["Station"])  # returns a DataFrame
layers = showtable.list_layers("data.gpkg")  # [(name, geometry type), ...]

Notes

  • The outlet layer may be a point shapefile (a single manually-marked outlet) or a line shapefile (e.g. a cross-section at the watershed outlet); wsdgen detects the geometry type automatically.
  • By default only the final watershed.tif, watershed.shp and watershed_smooth.shp are written to the WSD/ output directory; pass --all-outputs to also keep intermediate files (breached DEM, D8 pointer, flow accumulation, snapped outlet, etc.) there instead of a temporary folder.
  • wsdpyshed takes a point or line outlet layer (--outlet, reprojected to the DEM's CRS if needed) or coordinates (--xy, repeatable). Every feature or --xy pair gets its own watershed, labeled 1, 2, ... in order (the cell value in watershed.tif and the id field in watershed.shp); when one outlet is upstream of another, the downstream watershed excludes the upstream one, giving nested sub-basins. Use --outlet-index to delineate a single feature only. Each pour point is snapped to the nearest cell whose flow accumulation exceeds --acc-threshold (default 200, also used for the stream network) unless --no-snap is given. A line outlet (e.g. a cross-section) is rasterized and the watershed is everything draining to any cell it crosses; if it crosses no stream cell, its highest-accumulation cell is snapped like a point. Outputs go to WSD/ by default: watershed.tif, watershed.shp, dem_clipped.tif, streams.gpkg (in the DEM's CRS) and streams.geojson (in WGS84, as GeoJSON requires); --all-outputs adds the conditioned DEM, flow direction and flow accumulation rasters, and --web-map writes streams_map.html (requires folium and mapclassify).

Metadata

Release files for gisgears 0.5.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gisgears 0.5.1
File Size Uploaded Provenance Actions
gisgears-0.5.1.tar.gz 20.1 kB With provenance Details for gisgears-0.5.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for gisgears 0.5.1
File Interpreter ABI Platform Actions
gisgears-0.5.1-py3-none-any.whl Python 3 none any Details for gisgears-0.5.1-py3-none-any.whl

Total release size: 44.1 kB

Release files / gisgears-0.5.1.tar.gz

Download URL gisgears-0.5.1.tar.gz
Size 20.1 kB
Tags Source
SHA-256 checksum
How to use checksums
733e8431f24db47000e68397ea420df8b25497ebc9ff95b488dc672aaf37238a
BLAKE2b-256 checksum
How to use checksums
ee29519cdc18bd3fd0e37ff1c3cbf7bfd8b3a761e45f5c0a2bc22ab2166c2a26
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / gisgears-0.5.1-py3-none-any.whl

Download URL gisgears-0.5.1-py3-none-any.whl
Size 24.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
25582dabbd2344a261e0dc61e6d7898d051e5457caf4fb1eea18a18d9fb28636
BLAKE2b-256 checksum
How to use checksums
934937c0dc706ecd420137d948770520b248df6aecab760082f28fcc7f60ac15
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Security for gisgears 0.5.1

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for gisgears-0.5.1.tar.gz

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 Oct 26, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page