OptiDamTool 0.1.1

A Python package for analytics in dam management workflows.

OptiDamTool

Status	Description
PyPI
GitHub
Codecov
Read the Docs
PePy
License

OptiDamTool is a Python package designed for analytics and decision-making in dam management. Conceptualized and released on May 29, 2025, the package offers tools for modeling and analyzing hydrological flow across a network of connected dams.

Leveraging functionalities from the open-source GeoAnalyze package, OptiDamTool provides classes that that assist users in preparing inputs for simulating water erosion and sediment transport, and supports decision-making in dam network deployment aimed at environmental sustainability.

Classes

OptiDamTool.WatemSedem

Provides methods to prepare inputs for simulating the WaTEM/SEDEM model, which predicts soil erosion, sediment transport capacity, and sediment delivery to stream networks at the watershed scale. This class currently provides the following feature:

• Converts Digital Elevation Model (DEM) data into the stream files required for the WaTEM/SEDEM model, with the river routing = 1 extension enabled.
• Generates effective upstream drainage polygons for selected dam locations within a stream network.

OptiDamTool.Network

Offers methods for establishing hydrological and sedimentation flow connectivity between dams using the stream network. This class currently provides the following feature:

• Identifies connectivity between adjacent upstream and downstream dams.
• Computes the effective upstream drainage area values for selected dam locations within a stream network.

Easy Installation

To install, use pip:

pip install OptiDamTool

Quickstart

A brief example of how to start:

>>> import OptiDamTool
>>> watemsedem = OptiDamTool.WatemSedem()
>>> network = OptiDamTool.Network()

Documentation

For detailed information, see the documentation.

Support

If this project has been helpful and you'd like to contribute to its development, consider sponsoring with a coffee! Support will help maintain, improve, and expand this open-source project, ensuring continued valuable tools for the community.