Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
noresm:modeldiagnostics [2017-11-28 10:05:50] johan.liakka@nersc.no [NorESM Diagnostic Packages] |
noresm:modeldiagnostics [2019-08-08 20:49:54] yanchun.he@nersc.no |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== Model Diagnostic Tools====== | ====== Model Diagnostic Tools====== | ||
- | This page links to tools used for NorESM model evaluation. | + | This page links to tools used for the NorESM model evaluation. |
===== NorESM Diagnostic Packages ===== | ===== NorESM Diagnostic Packages ===== | ||
+ | |||
+ | Output from the latest NCAR diagnostic pages can be found on nird here: | ||
+ | |||
+ | via the web: | ||
+ | http:// | ||
+ | |||
+ | via the filesystem on nird here: | ||
+ | / | ||
+ | |||
+ | |||
The diagnostics packages are currently available on NIRD. Each package can be run/ | The diagnostics packages are currently available on NIRD. Each package can be run/ | ||
Line 11: | Line 21: | ||
Program: | Program: | ||
/ | / | ||
- | Version: | + | Version: |
------------------------------------------------- | ------------------------------------------------- | ||
Short description: | Short description: | ||
- | diag_run is used to configure and run the NorESM diagnostic packages. | + | A wrapper script for NorESM diagnostic packages. |
Basic usage: | Basic usage: | ||
Line 24: | Line 34: | ||
-m, --model=MODEL | -m, --model=MODEL | ||
Valid arguments: | Valid arguments: | ||
- | cam : atmospheric package (AMWG) | + | cam : atmospheric package (AMWG) |
- | clm : land package (LMWG) | + | clm : land package (LMWG) |
- | cice : sea-ice package | + | cice |
- | | + | |
+ | hamocc : biogeochemistry package | ||
+ | all | ||
-c, -c1, --case=CASE1, | -c, -c1, --case=CASE1, | ||
-s, -s1, --start_yr=SYR1, | -s, -s1, --start_yr=SYR1, | ||
Line 38: | Line 50: | ||
-i2, --input-dir2=DIR | -i2, --input-dir2=DIR | ||
Default is --input-dir=/ | Default is --input-dir=/ | ||
- | -o, --output-dir=DIR | + | -o, --output-dir=DIR |
- | Default is --output-dir=/ | + | Default is --output-dir=/ |
-p, --passive-mode | -p, --passive-mode | ||
-t, --type=TYPE | -t, --type=TYPE | ||
Line 45: | Line 57: | ||
-w, --web-dir=DIR | -w, --web-dir=DIR | ||
Default is --web-dir=/ | Default is --web-dir=/ | ||
+ | --no-atm | ||
Examples: | Examples: | ||
- | diag_run -m all -c N1850_f19_tn11_exp1 -s 21 -e 50 # model-obs diagnostics of N1850_f19_tn11_exp1 | + | diag_run -m all -c N1850_f19_tn11_exp1 -s 21 -e 50 # model-obs diagnostics of case=N1850_f19_tn11_exp1 (climatology between yrs 21 and 50) for all model components. |
- | diag_run -m cam -c N1850_f19_tn11_exp1 -s 21 -e 50 -w / | + | diag_run -m cam -c N1850_f19_tn11_exp1 -s 21 -e 50 -w / |
+ | diag_run -m micom -c N1850_f19_tn11_exp1 -t time_series # model-obs time-series diagnostics in MICOM for all years represented in the model output directory (/ | ||
diag_run -m cice -c N1850_f19_tn11_exp1 -s 21 -e 50 -p # configure (but do not run) model-obs diagnostics for CICE. | diag_run -m cice -c N1850_f19_tn11_exp1 -s 21 -e 50 -p # configure (but do not run) model-obs diagnostics for CICE. | ||
diag_run -m clm -c N1850_f19_tn11_exp1 -s 21 -e 50 -i / | diag_run -m clm -c N1850_f19_tn11_exp1 -s 21 -e 50 -i / | ||
- | diag_run -m clm -c N1850_f19_tn11_exp1 -s 21 -e 50 -t climo # model-obs climatology diagnostics (no time series) for CLM: | + | diag_run -m micom -c N1850_f19_tn11_exp1 -s 21 -e 50 -t climo # model-obs climatology diagnostics (no time series) for MICOM: |
diag_run -m cam -o /my/dir # install CAM diagnostics in /my/dir with minimal configuration. | diag_run -m cam -o /my/dir # install CAM diagnostics in /my/dir with minimal configuration. | ||
+ | diag_run -m micom, | ||
+ | diag_run -m clm -c N1850_f19_tn11_clmexp1 -s 71 -e 100 --no-atm # model-obs time-series diagnostics for an offline (uncoupled) CLM simulation. | ||
+ | diag_run -m hamocc -c N1850OC_f19_tn11_exp1 -s 31 -e 100 -t time_series # model-obs time-series diagnostics in HAMOCC between yrs 31 and 100. | ||
</ | </ | ||
- | Report any problems, comments or suggestions to Johan Liakka: [[mailto:johan.liakka@nersc.no|johan.liakka@nersc.no]] | + | A comprehensive technical summary of diag_run (pdf): {{ : |
+ | |||
+ | Report any problems, comments or suggestions to Yanchun He: [[mailto:yanchun.he@nersc.no|yanchun.he@nersc.no]] | ||
=== Recent updates === | === Recent updates === | ||
- | * 28.11.17. Update to v2.0: included a set of time series plots in CAM diagnostics. These also have their own html interface, which can be accessed from the index page (sets.htm). | + | * 08.08.19. Note: NS2345K is recovered now, please use the normal / |
- | + | * 08.08.19. Update to v6.0: add support to TS-derived mlts, global averages: tempga, | |
- | === Update to NCL version 6.4.0 === | + | * 29.08.18. |
- | The diagnostics | + | * 29.06.18. Update to v5.0: new fields to HAMOCC and MICOM diagnostics; |
- | < | + | * 20.04.18. Update to v4.3: added new fields to HAMOCC |
- | export NCARG_ROOT=/opt/ncl64 | + | * 19.04.18. Update to v4.2: included ability to do time-series diagnostics between two user-specified years. |
- | export PATH=/ | + | * 18.04.18. Update |
- | </ | + | * 09.04.18. Update to v4.0: included the HAMOCC diagnostics package. |
+ | * 23.02.18. Update to v3.1: added monthly MLD, seasonal SST/SSS and annual meridional heat/salinity fluxes to the MICOM diagnostics. | ||
+ | * 17.01.18. Update to v3.0: the first version of MICOM diagnostics has been included. | ||
+ | * 28.11.17. Update to v2.0: included a set of time series plots in CAM diagnostics, | ||
===Using diag_run with cron=== | ===Using diag_run with cron=== | ||
- | If you want to use diag_run with crontab, you first need to load $HOME/ | + | If you want to use diag_run with crontab, you first need to load $HOME/ |
< | < | ||
# | # | ||
# Min Hour Day Month Weekday Command(s) | # Min Hour Day Month Weekday Command(s) | ||
# | # | ||
- | 50 09 23 11 * . $HOME/ | + | 50 09 23 11 * . $HOME/ |
- | / | + | / |
</ | </ | ||
Line 88: | Line 109: | ||
The NorESM diagnostics packages and diag_run are included in the Git version control repository: | The NorESM diagnostics packages and diag_run are included in the Git version control repository: | ||
[[https:// | [[https:// | ||
- | |||
====== Aerosol and Chemistry, Clouds and Forcing Diagnostics ====== | ====== Aerosol and Chemistry, Clouds and Forcing Diagnostics ====== | ||
Line 262: | Line 282: | ||
http:// | http:// | ||
+ | ====== Post analysis and workup of CAM diagnostics output tables ====== | ||
+ | |||
+ | A tool for post analysis of (multiple) CAM diagnostics ASCII tables can be found in | ||
+ | the following repository: | ||
+ | |||
+ | GitHub https:// | ||
+ | |||
+ | To get started, please follow the instructions in repository README (displayed in repository). Currently, the main | ||
+ | analysis tool is a jupyter IPython notebook called | ||
+ | |||
+ | // | ||
+ | |||
+ | which includes more detailed instructions about setup and options. | ||
+ | |||
+ | Use the notebook | ||
+ | |||
+ | https:// | ||
+ | |||
+ | to download local copies of result tables using a list of URL's. | ||
+ | |||
+ | |||
+ | **Short summary: | ||
+ | The notebook reads multiple diagnostics files (runs) into one long table and creates heatmap plots | ||
+ | of //Bias, RMSE and RMSE relative error// for a subset of variables (rows -> y-axis of heatmap) | ||
+ | vs. the individual runs (columns -> xaxis). | ||
+ | |||
+ | **NOTE:** In the current version, you need to download all tables that you are interested in as csv or | ||
+ | ascii into one directory, that is specified in the header of the notebook. | ||
+ | |||
+ | Variable groups can be defined in this config file: | ||
+ | |||
+ | https:// | ||
+ | |||
+ | **NOTE:** If you add groups to this file in your local copy of the repository, please consider sending | ||
+ | the updated to [[mailto: | ||
+ | remains up to date. | ||
+ | |||
+ | **Troubleshooting** | ||
+ | If you run into problems, please raise an issue in the repository or contact [[mailto: |