pySWAP is a Python wrapper (not Python implementation) for the SWAP hydrological model (link to the model website). It simplifies the creation of input files, execution of the SWAP model, and analysis and visualization of results. Users can set up and document their models in Jupyter notebooks, enhancing transparency, collaboration, and facilitating community-supported debugging.

pySWAP is in the early stages of development so any contributions are highly encouraged. You can open issues, submit pull requests, or initiate discussions on GitHub. For more details on how you can contribute, visit the CONTRIBUTE section and get involved!

Consult pySWAP documentation page for detailed instructions.

The easiest way to install the package is through pip:

pip install pyswap

You can also clone the repository from github:

git clone --recurse-submodules https://github.com/zawadzkim/pySWAP.git

Notice, that there is the recurse-submodules flag that makes sure additional libraries are also cloned.

For consistent execution across different systems, you can use Docker:

docker build -t pyswap .
docker run -it --rm -v "$PWD":/workspace pyswap
python your-script.py

For detailed Docker instructions, see the Docker documentation.