A Python package for mesoscale hydrological modeling, designed to work both as a standalone library and as a QGIS plugin.

• Hydrological Modeling: Core functionality for mesoscale hydrological processes
• QGIS Integration: Seamless integration with QGIS 3.0+ as a plugin
• Data Processing: Tools for handling hydrological data and model inputs
• Visualization: Built-in plotting and visualization capabilities
• Extensible: Modular design for easy extension and customization

pip install pymhm

git clone https://github.com/SanjeevBashyal/pymhm.git
cd pymhm
pip install -e .

1. Download the plugin from the QGIS Plugin Manager
2. Or install manually by copying the pymhm folder to your QGIS plugins directory

import pymhm

# Initialize the model
model = pymhm.HydrologicalModel()

# Run simulation
results = model.run_simulation()

1. Open QGIS
2. Go to Plugins → Manage and Install Plugins
3. Search for "PymHM"
4. Install and activate the plugin
5. Access the plugin from the Plugins menu

• User Guide
• API Reference
• Examples

• Python 3.8+
• NumPy >= 1.20.0
• SciPy >= 1.7.0
• Pandas >= 1.3.0
• For QGIS plugin: QGIS 3.0+

git clone https://github.com/SanjeevBashyal/pymhm.git
cd pymhm
pip install -e .[dev]

pytest

pip install -e .[docs]
sphinx-build -b html docs/ docs/_build/

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the GNU General Public License v2.0 - see the LICENSE file for details.

If you use PymHM in your research, please cite:

@software{pymhm2025,
  title={PymHM: Python Mesoscale Hydrological Model},
  author={Sanjeev Bashyal},
  year={2025},
  url={https://github.com/SanjeevBashyal/pymhm},
  version={0.1.0}
}

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: sanjeev.bashyal01@gmail.com

See CHANGELOG.md for a list of changes and version history.

• QGIS Development Team for the excellent platform
• Python Scientific Community for the amazing tools
• Contributors and users of PymHM