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 [2018-04-10 07:07:17] johan.liakka@nersc.no |
noresm:modeldiagnostics [2020-12-22 12:44:09] yanchun.he@nersc.no [NorESM Diagnostic Packages] |
||
---|---|---|---|
Line 8: | Line 8: | ||
via the web: | via the web: | ||
- | http:// | + | http:// |
via the filesystem on nird here: | via the filesystem on nird here: | ||
- | / | + | / |
+ | **NB: The following wiki page for the NorESM diagnostic tools is moved!!** | ||
+ | |||
+ | Last updated: 12-Dec-2020. | ||
+ | |||
+ | Please go to the following NorESM documentation page for the latest description: | ||
+ | |||
+ | https:// | ||
+ | ---- | ||
Line 20: | Line 28: | ||
------------------------------------------------- | ------------------------------------------------- | ||
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: | ||
diag_run -m [model] -c [test case name] -s [test case start yr] -e [test case end yr] # Run model-obs diagnostics | diag_run -m [model] -c [test case name] -s [test case start yr] -e [test case end yr] # Run model-obs diagnostics | ||
diag_run -m [model] -c [test case name] -s [test case start yr] -e [test case end yr] -c2 [cntl case name] -s2 [cntl case start yr] -e2 [cntl case end yr] # Run model1-model2 diagnostics | diag_run -m [model] -c [test case name] -s [test case start yr] -e [test case end yr] -c2 [cntl case name] -s2 [cntl case start yr] -e2 [cntl case end yr] # Run model1-model2 diagnostics | ||
- | nohup / | + | nohup / |
- | + | ||
Command-line options: | Command-line options: | ||
-m, --model=MODEL | -m, --model=MODEL | ||
Line 37: | Line 45: | ||
clm : land package (LMWG) | clm : land package (LMWG) | ||
cice : sea-ice package | cice : sea-ice package | ||
- | | + | |
- | hamocc : geo-bio-chemistry | + | hamocc : biogeochemistry |
all : configure all available packages. | all : configure all available packages. | ||
-c, -c1, --case=CASE1, | -c, -c1, --case=CASE1, | ||
Line 51: | Line 59: | ||
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 | ||
Default is to run both. Note that the time series are computed over the entire simulation. | Default is to run both. Note that the time series are computed over the entire simulation. | ||
-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 -s 21 -e 50 # model-obs diagnostics for MICOM | + | diag_run -m blom -c N1850_f19_tn11_exp1 -t time_series |
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 blom -c N1850_f19_tn11_exp1 -s 21 -e 50 -t climo # model-obs climatology diagnostics (no time series) for BLOM: |
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,hamocc -c N1850OC_f19_tn11_exp1 -s 21 -e 50 # model-obs diagnostics for micom and hamocc. | + | diag_run -m blom,hamocc -c N1850OC_f19_tn11_exp1 -s 21 -e 50 # model-obs diagnostics for BLOM and HAMOCC. |
+ | 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 | ||
+ | |||
+ | *** NOTE: '-m micom' should be used for the ocean component of NorESM version 1 *** | ||
</ | </ | ||
A comprehensive technical summary of diag_run (pdf): {{ : | A comprehensive technical summary of diag_run (pdf): {{ : | ||
- | Report any problems, comments or suggestions to Johan Liakka: [[mailto:johan.liakka@nersc.no|johan.liakka@nersc.no]] | + | Report any problems, comments or suggestions to Yanchun He: [[mailto:yanchun.he@nersc.no|yanchun.he@nersc.no]] |
=== Recent updates === | === Recent updates === | ||
+ | * 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, | ||
+ | * 29.08.18. Update to v5.1: update NCO/NCL versions to support efficient process of compressed netcdf-4 files. | ||
+ | * 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 diagnostics. | ||
+ | * 19.04.18. Update to v4.2: included ability to do time-series diagnostics between two user-specified years. | ||
+ | * 18.04.18. Update to v4.1: improved climatology and time-series calculations in CLM, and introduction of the --no-atm option to enable diagnostics for offline CLM simulations. | ||
* 09.04.18. Update to v4.0: included the HAMOCC diagnostics package. | * 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/ | * 23.02.18. Update to v3.1: added monthly MLD, seasonal SST/SSS and annual meridional heat/ | ||
Line 84: | Line 104: | ||
# 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 92: | Line 112: | ||
It is useful to add diag_run as an alias in $HOME/ | It is useful to add diag_run as an alias in $HOME/ | ||
< | < | ||
- | alias diag_run='/ | + | alias diag_run='/ |
</ | </ | ||
Line 98: | Line 118: | ||
=== NorESM diagnostics on GitHub === | === NorESM diagnostics on GitHub === | ||
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 273: | Line 292: | ||
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: |