Automated Water Supply Model (AWSM)

Execution of the iSnobal snow mass and energy model along with the Spatial Modeling for Resources Framework. iSnobal itself is called via pysnobal and AWSM wraps the interface of both packages into a central execution framework.

Installation

Setting up the model uses the conda environment management software. A setup follows the steps described in the iSnobal instructions

Usage

The installation of this package provides a command line interface to run the model. The command is called awsm.

Examples

Run date range specified by start_date and end_date in the configuration file

awsm -c awsm.ini

Run date range set in the configuration file with the first day not having initialization data

This command is typically used when running a full water year, where the first day has no snow state to initialize from the previous day.

awsm -c awsm.ini --no_previous

Run a single date

This command requires initialization data from the previous day and ignores the date range specified in the configuration file.

awsm -c awsm.ini -sd 2024-12-01

Run a single date individually, ignoring the model state from the previous day

This command will ignore the specified date range in the configuration file and will execute for the given date while not using any initialization data from the previous day. Most cases will use this command when running the first day of a new water year.

awsm -c awsm.ini -sd 2024-10-01 --no_previous

Re-run single date after a model crash

This will only run iSnobal for the given date and requires all forcing data to be prepared (The date range in the configuration file will be ignored). Most cases use this command when the iSnobal crashed and a lower mass threshold value could resolve the issue.

awsm -c awsm.ini -sd 2024-12-01 --threshold

Help

usage: awsm [-h] -c CONFIG_FILE [-sd START_DATE] [-np] [-t] [-mt MEDIUM_THRESHOLD]

Run AWSM with given config file.

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG_FILE, --config_file CONFIG_FILE
                        Path to .ini config file.
  -sd START_DATE, --start_date START_DATE
                        Overwrite the start date in the .ini and force a single day run. Format: YYYYMMDD or YYYY-MM-DD
  -np, --no_previous    Skip finding a previous snow state and storm day file. Usually used when running the first day.
  -t, --threshold       Run iSnobal with different mass threshold
  -mt MEDIUM_THRESHOLD, --medium_threshold MEDIUM_THRESHOLD
                        Set the medium mass threshold. Default: 25

Citation

Each release of AWSM triggers a DOI via Zenodo and all versions can be found here

DOI for all versions is: https://doi.org/10.5281/zenodo.6543918 which always points to the latest release.

History

Fork of the Automated Water Supply Model (AWSM)

This is a fork of the USDA-ARS-NWRC AWSM repo to continue the development of the framework. This repo was used in the following publications

Publications

• Meyer, J., Horel, J., Kormos, P., Hedrick, A., Trujillo, E., and Skiles, S. M.: Operational water forecast ability of the HRRR-iSnobal combination: an evaluation to adapt into production environments, Geosci. Model Dev., 16, 233–250, https://doi.org/10.5194/gmd-16-233-2023, 2023. Zenodo

• Meyer, J., Hedrick, A., and McKenzie Skiles, S.: A new approach to net solar radiation in a spatially distributed snow energy balance model to improve snowmelt timing, Journal of Hydrology, 131490, https://doi.org/10.1016/j.jhydrol.2024.131490, 2024. Zenodo