Spatial Water stress and Evapotranspiration Assessment for TRISHNA

SWEAT contains several algorithms used in TRISHNA mission to compute evapotranspiration:

• EVASPA
• STIC
• ET time series

Installation

Clone the repository

git clone https://github.com/CNES/sweat.git

Install prerequisites

The prerequisites are installed by pixi.

cd sweat/
pixi install

To activate the environment

pixi shell

Install notebook

pip install .[notebook]

If you encounter any problems during installation, see troubleshooting page.

Usage

Command-line interface

To run SWEAT algorithms, you need to provide an input file in JSON or YAML format.

EVASPA

To run EVASPA

evaspa INPUT_FILE

An example of configuration file:

{
    "input":{
        "path": "tests/data/data_test_20230303T112730.tif",
        "date": "2023-03-03T11:27:30-00:00"
    },
    "output":{
        "path":"out"
    },
    "params":{
        "ef":{
            "models": "default_evaspa"
        }
    }
}

STIC

To run STIC

stic INPUT_FILE

An example of configuration file:

{
    "input":{
        "path": "tests/data/data_test_20230303T112730.tif",
        "date": "2023-03-03T11:27:30-00:00"
    },
    "output":{
        "path":"out"
    }
}

ET time series

To run timeseries

timeseries INPUT_FILE

An example of configuration file:

{
    "input": {
        "dates": [
            "2025-08-23",
            "2025-08-24",
            "2025-08-25",
            "2025-08-26"
        ],
        "et_time_series": [
            "tests/data/timeseries/et_time_series_20250823.tif",
            "tests/data/timeseries/et_time_series_20250824.tif",
            "tests/data/timeseries/et_time_series_20250825.tif"
        ],
        "radiation": [
            "tests/data/timeseries/radiation_20250823.tif",
            "tests/data/timeseries/radiation_20250824.tif",
            "tests/data/timeseries/radiation_20250825.tif",
            "tests/data/timeseries/radiation_20250826.tif"
        ],
        "et_single_date": [
            "tests/data/timeseries/et_single_date_20250826.tif"
        ]
    },
    "output": {
        "path": "out"
    },
    "params": {}
}

ET time series over a period

To run timeseries

window-timeseries INPUT_FILE

An example of configuration file:

{
    "input": {
        "period_start": "2025-08-23",
        "period_end": "2025-08-29",
        "et_single_date_dir": "tests/data/timeseries/",
        "radiation_dir": "tests/data/timeseries/"
    },
    "output": {
        "path": "out"
    }
}

Notebooks

To launch the notebooks

jupyter-lab

License

This project is licensed under the GNU Affero General Public License version 3. See LICENSE for the full text.