Home

The Water Resources Evaluation Service

The Water Resources Evaluation Service (WRES) is a comprehensive service for evaluating the quality of existing and emerging OWP and RFC models and forecast systems.

What are the general instructions for using the WRES?

See Instructions for Using WRES. That wiki will redirect you to other wikis, as needed, including to the Declaration language wiki for evaluation declaration instructions.

What if I want to download a release and run the WRES as a command-line application?

Make sure you have the correct version of Java, which must be at least Java 17+.

Obtain the latest distribution .zip and install the software locally.

• Navigate to the releases page: https://github.com/NOAA-OWP/wres/releases

• Download the latest core zip from the assets of the most recent deploy

  • Should look like wres-DATE-VERSION.zip

Unpackage the file and execute your evaluation project.

Unzip the release package and change directory to the unzipped wres directory. To execute a project you can run the following command:

bin/wres execute yourProject.yml

What if I want to obtain and build the software, and run my built WRES?

Make sure you have the correct version of Java, which must be at least Java 17+.

Obtain and build the WRES software.

To build WRES for local use, clone the repository, and run the following commands in your preferred terminal (use gradlew.bat on a Windows machine):

./gradlew check javadoc installDist

This is similar to unzipping the production distribution zip locally. The WRES software will be built and installed in build/install/wres directory, as if unzipped.

How do I execute the WRES software for my evaluation project?

Do the following:

cd build/install/wres/

bin/wres execute yourProject.yml

Example Evaluation

Once the software has been installed locally, running the following command (use wres.bat on a Windows machine) will execute a test project using the executable you have created (this running successfully is reliant on being in the wres/build/install/wres directory):

bin/wres ../../../systests/testScenario/evaluation.yml