This tutorial will provide a step-by-step guide for performing a simple model evaluation with the RCMES CLI.
Here we will use precipitation output from the North American Regional Climate Changes Assessment Program (NARCCAP) RCMs as an example.
If you have not already done so, please go to the RCMES Download Page and install RCMES using either the VM or conda to follow along with this tutorial.
All of the images in this tutorial are clickable and will open in a new tab for a zoomed view.
If you are using the VM for this tutorial, the data file is already located within your data folder in RCMES.
If you are using the Easy OCW to complete this tutorial, you will need to download the file and save to the data folder of RCMES. Go to climate/RCMES/data. Save the downloaded pr_WRFG_monthly_1980-2003.nc file in this folder. You are now ready to continue on to the Getting Started section of this tutorial.
IMPORTANT NOTE: To prevent the CLI App from crashing, please FULLY EXPAND your terminal window now for this tutorial.
In the Terminal application, navigate to the folder containing the RCMES CLI
Then execute the program by inputting
|Top left of the Main Menu is where the user
can interface with the RCMES.
|Bottom left of the Main Menu is the
Notification Bar which notes the progress
of the analysis.
|Bottom right of the Main Menu contains
Main Menu: Manage Model (Option 1)
From the Main Menu,
SELECT Option 1 - Manage Model and PRESS ENTER.
When prompted to select the model, TYPE 0 to select pr_WRFG_monthly_1980-2003.nc and PRESS ENTER.
When prompted to enter variable name,
TYPE "pr" because the file loaded in the previous step contains precipitation data and PRESS ENTER.
The program will ask to confirm the data loaded. Confirm by ENTERING 1 and PRESS ENTER.
Once the model file is successfully loaded,
Enter Option 0 to return to the Main Menu.
Main Menu: Manage Observation (Option 2)
From the Main Menu,
SELECT Option 2 - Manage Observation and PRESS ENTER.
SELECT Option 1 - Select Observation and PRESS ENTER.
Enter Dataset ID (D-ID): 3
Enter Parameter ID (P-ID): 36
Once the observation is successfully selected, SELECT Option 0 to return to the Main Menu.
On the Main Menu, Option 2 should now be noted as completed (C).
Main Menu: Run (Option 3)
NOTE: The terminal window needs to be FULLY EXPANDED, otherwise an error may occur.
From the Main Menu,
SELECT Option 3 - Run and PRESS ENTER.
Important Note: The program will only run if both Options 1 & 2 are completed (C). Also, the terminal window needs to be FULLY EXPANDED before you select Option 3 - Run - otherwise an error will occur.
The left split screen shows the information of the model file, observation, and parameters of both where there is overlap.
The right split screen allows for the user to modify the parameters and run the analysis.
For this tutorial, change the temporal boundaries to January 1, 2000 through December 31, 2000.
To do this,
SELECT Option 1 - Change Temporal Boundaries
Enter Start Time (Format YYYY-MM-DD): 2000-01-01
Enter End Time (Format YYYY-MM-DD): 2000-12-31
To do this, SELECT Option 2 - Change Spatial Boundaries
Enter Minimum Latitude: 23.75
Enter Maximum Latitude: 49.75
Enter Minimum Longitude: -125.75
Enter Maximum Longitude: -66.75
To the run the evaluation,
ENTER r - Run Evaluation and PRESS ENTER.
The progress of the evaluation will be noted on the main screen.
Once the evaluation is done,
PRESS ENTER to return to the Run Menu.
In the working directory (~/RCMES/plots), you will find the model, observation, and evaluation plots as .png image files.
|pr_WRFG_monthly_1980-2003.nc||NASA TRMM||Bias Contour Plot|
RCMES CLI should be viewed with a maximized window to help workflow.
Selecting Option 3 - Run without fully expanding the terminal window may cause errors.
Models and observations can be loaded in any order.
Both Models (Option 1) and Observation (Option 2) must be loaded (completed) in order to access the Run Menu (Option 3).
Long temporal and large spatial boundaries will require more time for the evaluation to be performed.