Home

The Water Resources Evaluation Service

The Water Resources Evaluation Service (WRES) is a comprehensive service for evaluating the quality of hydrologic 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, and wikis specific to how you want to execute the evaluation (via command-line execution, long-running local-server, or full WRES web-service).

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

Running the WRES as a command-line application may be the simplest way to execute it, but its also not as robust nor as well supported. If a WRES web-service instance is available, its highly recommended that you use it. Still, instructions for downloading and executing are below.

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.

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

2. Download the latest core zip from the assets of the most recent deployment. That .zip should follow the pattern, 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?

Obtaining and running a locally built WRES may be important for developers, but, if you just want to run it, using a release package is recommended, as described above. Instructions for building the WRES are below.

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.

Navigate to the built and installed software and execute your evaluation project.

Do the following:

cd build/install/wres/
bin/wres execute yourProject.yml

Example Evaluation

Once the software has been built and 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