RAT

Uses satellite remote sensing data to monitor water surface area and water level changes in artificial reservoirs.
https://github.com/uw-saswe/rat

Category: Natural Resources
Sub Category: Water Supply and Quality

Last synced: about 18 hours ago
JSON representation

Repository metadata

Reservoir Assessment Tool

README.md

Reservoir Assessment Tool

Reservoir Assessment Tool (RAT) 3.0

A scalable and easy-to-apply python based software architecture to empower the global water community

The Reservoir Assessment Tool (RAT) uses satellite remote sensing data to monitor water surface area and water level changes in artificial reservoirs. It uses this information, along with topographical information (either derived from satellite data, or in-situ topo maps) to estimate the Storage Change (∆S) in the reservoirs. Additionally, RAT models the Inflow (I) and the Evaporation (E) of each reservoir. Finally, RAT uses the modeled I, and E, and estimated ∆S, to estimate the Outflow (O) from reservoirs.

Current release info

Name Downloads Version Platforms Documentation Release Date
Conda Package Conda Downloads Conda Version Conda Platforms Documentation Status Anaconda-Server Badge

Installing RAT

Installing rat from the conda-forge channel can be achieved by adding conda-forge to your channels with:

conda config --add channels conda-forge
conda config --set channel_priority strict

Once the conda-forge channel has been enabled, rat can be installed with conda:

conda install rat

or with mamba:

mamba install rat

It is possible to list all of the versions of rat available on your platform with conda:

conda search rat --channel conda-forge

or with mamba:

mamba search rat --channel conda-forge

Alternatively, mamba repoquery may provide more information:

# Search all versions available on your platform:
mamba repoquery search rat --channel conda-forge

# List packages depending on `rat`:
mamba repoquery whoneeds rat --channel conda-forge

# List dependencies of `rat`:
mamba repoquery depends rat --channel conda-forge

About RAT

RAT 3.0 makes numerous improvements to the code structure, performance optimizations, added configurations, ability to run RAT for multiple basins, among some introduced features. It also introduces packaging of RAT as a conda package, allowing for quick and easy installation.

It was originally developed by Biswas et al. (2021) at SASWE, University of Washington. The RAT framework developed by Biswas et al. (2021) was a first-of-its-kind open-source reservoir monitoring tool, it is reffered to as the version 1 of RAT, or RAT 1.0. It currently runs for 3 regions - (1) South and South East Asia, (2) Africa, and (3) South America, and can be accessed here.

The Reservoir Assessment Tool (RAT) 2.0 was introduced with numerous improvements over the RAT 1.0. Such as weekly satellite observations (every 1-5 days) using a combination of multiple satellites (Sentinel-2, landsat-8, landsat-9 and Sentinel-1), usage of VIC hydrological model (VIC 5, Hamman et al. (2018)) and MetSim in parallel computation mode, data storage using NetCDF format and explicit representation of Evaporation using the Penman Combination method.

CITATION

If you use this software, please cite #1 and any other depending on the context of the work:

  1. Minocha, S., Das, P., & Hossain, F. (2025). Reservoir assessment tool (RAT): a Python package for monitoring the dynamic state of reservoirs and analyzing dam operations. Digital Water, 3(1), 1–30. https://doi.org/10.1080/28375807.2025.2487762.

  2. Minocha, S., Hossain, F., Das, P., Suresh, S., Khan, S., Darkwah, G., Lee, H., Galelli, S., Andreadis, K., and Oddo, P.: Reservoir Assessment Tool version 3.0: a scalable and user-friendly software platform to mobilize the global water management community, Geosci. Model Dev., 17, 3137–3156, https://doi.org/10.5194/gmd-17-3137-2024, 2024.

  3. Das, P., Hossain, F., Khan, S., Biswas, N.K., Lee, H., Piman, T., Meechaiya, C., Ghimire, U. and Hosen, K., 2022. Reservoir Assessment Tool 2.0: Stakeholder driven improvements to satellite remote sensing based reservoir monitoring. Environmental Modelling & Software, 157, p.105533.

  4. Biswas, N.K., Hossain, F., Bonnema, M., Lee, H. and Chishtie, F., 2021. Towards a global Reservoir Assessment Tool for predicting hydrologic impacts and operating patterns of existing and planned reservoirs. Environmental Modelling & Software, 140, p.105043.

LICENSE

RAT 3.0 is distributed under the GPL v3 license. You may copy, distribute and modify the software as long as you track changes/dates in sourcefiles. Any modifications to or software including GPL-licensed code must also be made available under the GPL along with build & install instructions.
For more information, please see LICENSE.


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 2 days ago

Total Commits: 816
Total Committers: 4
Avg Commits per committer: 204.0
Development Distribution Score (DDS): 0.48

Commits in past year: 109
Committers in past year: 1
Avg Commits per committer in past year: 109.0
Development Distribution Score (DDS) in past year: 0.0

Name Email Commits
Sanchit Minocha s****r@g****m 424
Pritam Das p****7@g****m 376
SarathUW s****6@g****m 15
George Darkwah 6****h 1

Issue and Pull Request metadata

Last synced: about 1 month ago

Total issues: 23
Total pull requests: 132
Average time to close issues: about 1 month
Average time to close pull requests: 5 days
Total issue authors: 6
Total pull request authors: 4
Average comments per issue: 0.48
Average comments per pull request: 0.12
Merged pull request: 110
Bot issues: 0
Bot pull requests: 0

Past year issues: 4
Past year pull requests: 11
Past year average time to close issues: about 4 hours
Past year average time to close pull requests: about 17 hours
Past year issue authors: 3
Past year pull request authors: 2
Past year average comments per issue: 0.5
Past year average comments per pull request: 0.18
Past year merged pull request: 9
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/uw-saswe/rat

Top Issue Authors

  • SanchitMinocha (9)
  • pritamd47 (8)
  • jamesYu365 (2)
  • gdarkwah (2)
  • shahzaib1007 (1)
  • SarathUW (1)

Top Pull Request Authors

  • SanchitMinocha (78)
  • pritamd47 (42)
  • SarathUW (11)
  • gdarkwah (1)

Top Issue Labels

  • bug (7)
  • edge case (2)
  • help wanted (1)
  • enhancement (1)

Top Pull Request Labels

  • duplicate (2)

Package metadata

proxy.golang.org: github.com/UW-SASWE/RAT

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/UW-SASWE/RAT#section-documentation
  • Licenses: gpl-3.0
  • Latest release: v3.0.19+incompatible (published 7 months ago)
  • Last Synced: 2026-06-12T15:03:11.378Z (4 days ago)
  • Versions: 17
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
proxy.golang.org: github.com/uw-saswe/rat

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/uw-saswe/rat#section-documentation
  • Licenses: gpl-3.0
  • Latest release: v3.0.19+incompatible (published 7 months ago)
  • Last Synced: 2026-06-12T15:03:11.303Z (4 days ago)
  • Versions: 17
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
pypi.org: rat

Resevoir Monitoring using Satellite Remote Sensing

  • Homepage: https://github.com/UW-SASWE/RAT
  • Documentation: https://rat.readthedocs.io/
  • Licenses: MIT License
  • Latest release: 3.0.19 (published 7 months ago)
  • Last Synced: 2026-06-12T15:03:05.961Z (4 days ago)
  • Versions: 25
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 200 Last month
  • Rankings:
    • Dependent packages count: 10.126%
    • Downloads: 12.131%
    • Stargazers count: 14.892%
    • Average: 15.565%
    • Forks count: 19.143%
    • Dependent repos count: 21.535%
  • Maintainers (2)

Dependencies

.github/workflows/python-package-pypi.yaml actions
  • actions/checkout v3 composite
  • actions/download-artifact v3 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
  • pypa/gh-action-pypi-publish release/v1 composite
docs/requirements.txt pypi
  • Babel ==2.12.1
  • Jinja2 ==3.1.2
  • Markdown ==3.3.7
  • MarkupSafe ==2.1.2
  • PySocks ==1.7.1
  • PyYAML ==6.0
  • Pygments ==2.14.0
  • brotlipy ==0.7.0
  • certifi ==2022.12.7
  • cffi ==1.15.1
  • charset-normalizer ==2.1.1
  • click ==8.1.3
  • colorama ==0.4.6
  • cryptography ==40.0.1
  • ghp-import ==2.1.0
  • idna ==3.4
  • importlib-metadata ==6.1.0
  • mergedeep ==1.3.4
  • mkdocs ==1.4.2
  • mkdocs-markdownextradata-plugin ==0.2.5
  • mkdocs-material ==9.1.4
  • mkdocs-material-extensions ==1.1.1
  • mkdocs-rtd-dropdown ==1.0.2
  • packaging ==23.0
  • pip ==23.0.1
  • pyOpenSSL ==23.1.0
  • pycparser ==2.21
  • pymdown-extensions ==9.10
  • python-dateutil ==2.8.2
  • python-markdown-math ==0.8
  • pytz ==2023.2
  • pyyaml_env_tag ==0.1
  • regex ==2023.3.23
  • requests ==2.28.2
  • setuptools ==67.6.0
  • six ==1.16.0
  • typing_extensions ==4.5.0
  • urllib3 ==1.26.15
  • watchdog ==3.0.0
  • wheel ==0.40.0
  • zipp ==3.15.0
pyproject.toml pypi
  • dask *
  • earthengine-api *
  • gdown *
  • geopandas *
  • netcdf4 *
  • numpy *
  • pandas *
  • rasterio *
  • rioxarray *
  • ruamel_yaml *
  • scikit-learn *
  • scipy *
  • xarray *
  • yaml *
setup.py pypi
environment.yml conda
  • conda-build
  • dask
  • earthengine-api
  • gdown
  • geopandas
  • netcdf4
  • numpy
  • pandas
  • rasterio
  • rioxarray
  • ruamel_yaml
  • scikit-learn
  • scipy
  • xarray
  • yaml

Score: 10.22586086477784