Installation

From PyPI

Install the latest stable release:

pip install pydsstools

Install a pre-release version (if available):

pip install --pre pydsstools

For geospatial features (rasterio, geopandas, etc.):

pip install pydsstools[geo]

Clone the repository:

git clone https://github.com/gyanz/pydsstools.git
cd pydsstools

(Optional) Initialise the HEC-DSS C library submodule:

Pre-built static libraries (heclib.lib, heclib.a) are already included in the repository, so this step is only needed if you want to rebuild them from source (e.g. after updating to a newer upstream release).
```
git submodule update --init
```
This clones the hec-dss source tree into pydsstools/src/external/hec-dss/. The submodule tracks the master branch (DSS-6 and DSS-7 support).

To update the submodule to the latest upstream commit later:
```
git submodule update --remote
```
See scripts/build_hecdss.py for the full rebuild workflow.
Build the wheel (requires build tools and a C compiler):
```
pip install build
python -m build
```
Install the built wheel:
```
pip install dist/pydsstools-*.whl
```

Note: On Windows, you need Visual Studio Build Tools with C++ workload. On Linux, you need gcc, gfortran, and development headers.