Single Case Comparison
\n", "Multiple Case Comparison**
\n", "** In progress, will not be part of this tutorial currently :(
\n", "\n", "## Available Comparison Cases\n", "\n", "There are essentially 3 types of comparisons:\n", "\n", "* CAM vs CAM\n", "* CAM vs Observations/Reanalysis\n", "* CAM vs CMIP\n", "\n", "Each have their own requirements for the run-time config file (eg `config_cam_baseline_example`). The requirements for each type of comparison will be addressed in their respective sections of this tutorial.\n" ] }, { "cell_type": "markdown", "id": "7efb79a7-b054-4f0c-a34d-5b1f38c580bc", "metadata": {}, "source": [ "\n", "\n", "The ADF requires 2 different yaml configuration files: \n", "\n", "`config_cam_baseline_example.yaml` and `adf_variable_defaults.yaml`\n", "\n", "NOTE: Throughout this tutorial we will reference these as the run-time and variable default yaml files respectively.\n", "\n", "\n", "If yaml files are new to you, they are just specialized text files that python (and other languages) can read in and use as configuration files. In the case of the ADF, the variables set in the yaml files will be parsed into Python dictionaries and will accessable throughout the ADF workflow.\n", "\n", "A couple of notes about using the ADF yaml files: config_cam_baseline_example.yamlThis is the most important file for the ADF, it stores all the necessary information that the ADF needs to run including all the relevant information about the case and baseline/observation/cmip runs.
\n", "\n", "It is also broken up into subsections with each subsection of the yaml file representing grouped sets of information sent to the ADF each having their own variable names.
\n", "\n", "###### Subsections\n", "\n", "* diag_basic_info\n", " - Basic overall run variables\n", " \n", "* diag_cam_climo\n", " - Test (experiment) case variables\n", " \n", "* diag_cam_baseline_climo\n", " - Baseline (control) case variables\n", " - Note: these are the same variables as `diag_cam_climo` just for the baseline case\n", " \n", "* diag_cvdp_info\n", " - For running the Climate Variability Diagnostics Package https://www.cesm.ucar.edu/projects/cvdp\n", " - This will run in the background of the ADF\n", " \n", "* time_averaging_scripts\n", " - Climotology file creation\n", " \n", "* regridding_scripts\n", " - Regridding of climo files\n", " \n", "* analysis_scripts\n", " - AMWG statisics tables\n", " \n", "* plotting_scripts\n", " - Various plotting scripts\n", " \n", "* diag_var_list\n", " - List of CAM variables for ADF to run\n", "\n", "\n", "CAVEAT: using variables in this yaml file/glade/work/${user}/ADF/data/climos/ -> /glade/work/richling/ADF/data/climos/\n",
"\n",
"```{tip}\n",
"Please see the config yaml file reference section for more details about this config file including how to use defined variables and more information about the config variables.
\n", "```\n", "\n" ] }, { "cell_type": "markdown", "id": "eb815026-db7c-46e7-9fe4-8f5e92b97875", "metadata": {}, "source": [ "---" ] }, { "cell_type": "markdown", "id": "925db366-c934-4b0c-87f6-b7bf146691ce", "metadata": {}, "source": [ "##### Variable Default yaml\n", "\n", " lib/adf_variable_defaults.yamlPlease see the variable defaults yaml file reference section for more details of the contents.
\n", "\n", "Also visit the exercise example for using a custom variable defaults file.
\n", "```\n", "---" ] }, { "cell_type": "raw", "id": "26f023fe-be02-4abb-9492-e2f4eb42b358", "metadata": {}, "source": [ "Please see the reference section for the variable defaults file for more details of the contents. \n", "\n", "Also see the exercise example for using a custom variable defaults file." ] }, { "cell_type": "raw", "id": "a4cf5de1-531a-4715-9f28-2fda7b4cb88f", "metadata": {}, "source": [ "###### Custom Set\n", "\n", "::::{Warning}\n", "Please do not modify this file unless you plan to push your changes back to the ADF repo!\n", " \n", "If you would like to modify this file for your personal ADF runs then it is recommended to make a copy of this file, make modifications in that copy, and then point the ADF.