CAM vs Obs#

This will be a simple guided demo of running the ADF with sample data for CAM vs CAM comparison. For an example of CAM simulation vs observations/reanalysis, navigate to this demo

Use this as a follow along as you work locally for this example ADF run.

Navigate to where you cloned the ADF:

  • If you followed our instructions earlier, you should have the ADF root directory at: /glade/work/<user>/ADF/

For this guided demo we will first make a copy of the run-time config file and make some changes in that copy.

Configure Run-Time yaml file#

Introduction#

Look for the conifuration yaml file that will be used to run the ADF, `config_baseline_example.yaml`

This is probably the most important file for the ADF. This stores all the necessary information that the ADF needs to run as well as all the relevant information about the case and baseline/observation/cmip runs.

Each section of the yaml file represent grouped subsets of information sent to the ADF and each have variable names that get fed into the ADF in a specific fashion.

We will copy the provided configuration yaml file config_baseline_example.yaml and will do small edits to run an example ADF with sample data.

cp config_baseline_example.yaml config_tutorial_example.yaml

Modify the Copy#

Next open this new copy in your favorite editor: 

emacs config_tutorial_example.yaml

Here we will do just a couple of changes for the output paths and cases/climo years

Subsections#

A quick refresher of the different sections on this yaml file

  • diag_basic_info

    • Basic overall run variables

  • diag_cam_climo

    • Test (experiment) case variables

  • diag_cam_baseline_climo

    • Baseline (control) case variables

    • Note: these are the same variables as diag_cam_climo just for the baseline case

  • diag_cvdp_info

  • time_averaging_scripts

    • Climotology file creation

  • regridding_scripts

    • Regridding of climo files

  • analysis_scripts

    • AMWG statisics tables

  • plotting_scripts

    • Various plotting scripts

  • diag_var_list

    • List of CAM variables for ADF to run

We will be editing the following sections:

  • Global Variables

  • diag_basic_info

  • diag_cam_climo




Global Variables#

In the yaml file, let’s set global variables. These variables will be set above all the subsections so that they can be easily called in anywhere in the file.

Set the user name that will be help set all paths later in the yaml file

  user: richling (YOUR-USER-NAME)

Create a new variable adf_path for the root ADF path. This will be used to house the different directories for the time series, climo, and regridded files as well as where the plots and websites will go

  adf_path: /glade/scratch/${user}/ADF

Also create a variable hist_path for the path to the sample history files

  hist_path: /glade/scratch/richling/ADF/tutorials/data

Attention

This is meerly a suggestion of how to configure the locations of all the files and diagnostic plots. We will stick to this convention for this tutorial, but please feel free to setup your ADF diagnsotics paths/hieracrhy in anyway that makes sense for your actual needs!

diag_basic_info#

This subsection defines necessary variables for the overall ADF run

We can change the paths for the regridded data and plot locations

  cam_regrid_loc: ${adf_path}/regrid

  cam_diag_plot_loc: ${adf_path}/plots

diag_cam_climo#

  cam_case_name: f.cam6_3_106.FLTHIST_v0a.ne30.dcs_non-ogw.001

  cam_hist_loc: ${hist_path}/f.cam6_3_106.FLTHIST_v0a.ne30.dcs_effgw_rdg.001

  cam_climo_loc: ${adf_path}/climo/{diag_cam_climo.cam_case_name}

  start_year: 1995

  end_year: 2000

  cam_ts_loc: ${adf_path}/ts/{diag_cam_climo.cam_case_name}



With all these variables now set, let's take a quick catalogue of the different paths:

Regridded file location:

  /glade/scratch/<user>/ADF/regrid

Diagnostic plot location:

  /glade/scratch/<user>/ADF/plots

   The ADF will output a new directory in the above location named:

    f.cam6_3_106.FLTHIST_v0a.ne30.dcs_non-ogw.001_1995_2000_vs_Obs/

Climatology file locations:

  /glade/scratch/<user>/ADF/climo/f.cam6_3_106.FLTHIST_v0a.ne30.dcs_non-ogw.001

Timeseries locations:

  /glade/scratch/<user>/ADF/ts/f.cam6_3_106.FLTHIST_v0a.ne30.dcs_non-ogw.001