ISTARF-CONUS/README.txt was generated on 2021-03-26 by Sean Turner.
------------------------------------------------------------------

GENERAL INFORMATION
-------------------
Inferred Storage Targets and Release Functions (ISTARF-CONUS) provides parameterization for weekly release decisions for 1,930 large CONUS reservoirs (capacity > 10 MCM) defined in the Global Reservoirs and Dams (GRanD) database (Lehner et al., 2011).

Authors:
Sean Turner (sean.turner@pnnl.gov)

Organization:
Pacific Northwest National Laboratory
902 Battelle Blvd, Richland, WA 99354

Recommended citation:
Turner, S.W.D., Reservoir Operations for the United States Inferred Policies (ISTARF-CONUS) v1.0.0, 2021, PNNL.

****************

ISTARF-CONUS was generated using the `starfit` R package (github.com/IMMM-SFA/starfit) to create operating policies from observational records in ResOpsUS v1.0.0 (Steyaert et al., 2021) reservoir operations data.

****************


DATA DESCRIPTION
----------------

The file `ISTARF-CONUS.csv` contains full parameterization for all 1,930 reservoirs.

The `Demo.R` R script provides a demonstration of converting parameters to storage targets and release decisions using `starfit` R tool: https://github.com/IMMM-SFA/starfit

Column header definitions in ISTARF-CONUS.csv
--------------------------------------------

*General info*
GRanD_ID. ID number from the Global Reservoir and Dams Database.
GRanD_NAME. DAM_NAME variable of the Global Reservoir and Dams Database.
GRanD_CAP_MCM. Reservoir storage capacity (million cubic meters) reported in the Global Reservoir and Dams Database.
GRanD_MEANFLOW_CUMECS. Estimated mean inflow rate (million cubic meters) based on Global Reservoir and Dams Database.
Obs_MEANFLOW_CUMECS. Mean inflow rate (million cubic meters) from ResOpsUS observations.
fit. One of "full" (all parameters fitted from observations), "storage_only" (storage parameters fitted from observations), and "extrapolated" (all parameters extrapolated from another dam).
match. GRanD ID of the reservoir from which policies are extrapolated (if "fit" is either "storage_only" or "extrapolated").

*Storage targets*
NORhi_mu. Intercept parameter for harmonic of the upper bound of Normal Operating Range.
NORhi_alpha. Sine parameter for harmonic of the upper bound of Normal Operating Range.
NORhi_beta. Cosine parameter for harmonic of the upper bound of Normal Operating Range.
NORhi_max. Maximum constraint on the upper bound of Normal Operating Range.
NORhi_min. Minimum constraint on the upper bound of Normal Operating Range.
NORlo_mu. Intercept parameter for harmonic of the lower bound of Normal Operating Range.
NORlo_alpha. Sine parameter for harmonic of the lower bound of Normal Operating Range.
NORlo_beta. Cosine parameter for harmonic of the lower bound of Normal Operating Range.
NORlo_max. Maximum constraint on the lower bound of Normal Operating Range.
NORlo_min. Minimum constraint on the lower bound of Normal Operating Range.

* Release function
Release_alpha1. First sine parameter for release harmonic function.
Release_beta1. First cosine parameter for release harmonic function.
Release_alpha2. Second sine parameter for release harmonic function.
Release_beta2. Second cosine parameter for release harmonic function.
Release_c. Intercept for release adjustment linear function.
Release_p1. Multiplier for storage state variable of release adjustment linear function.
Release_p2. Multiplier for inflow state variable of release adjustment linear function.
Release_max. Maximum release constraint (standardized).
Release_min. Minimum release constraint (standardized).


REFERENCES
----------
Lehner et al., 2011, Fr. in Ec. and the Env., 9: 494-502. https://doi.org/10.1890/100125
Steyaert et al., 2021. ResOpsUS. CyVerse Data Commons. DOI 10.25739/5fnr-1v31


