Introduction¶
NorESM1 is the Norwegian Earth System model used for CMIP5. The model is based on the CCSM framework (http://en.wikipedia.org/wiki/Community_Climate_System_Model). However, NorESM has special features developed by Norwegian researchers.
Main references are:
GMD - Special issue The Norwegian Earth System Model: NorESM; basic development, validation, scientific analyses, and climate scenarios
http://www.geosci-model-dev.net/special_issue20.html [gmd-6-687-2013] [gmd-6-389-2013] [gmd-6-207-2013] [gmd-6-301-2013]
The next version of the model NorESM2 is built on a update version of the CCSM framework, CESM2. (http://www.cesm.ucar.edu/models/cesm2/) ; (https://en.wikipedia.org/wiki/Community_Earth_System_Model). Its aerosol module is based on OsloAero5.3 of NorESM1.2 / CAM5.3-Oslo [gmd-11-3945-2018].
This website contains information shared between NorESM developers and users
Obtaining a version of the model¶
- The development version has been moved to git: Obtain a copy through git clone https://githubUserName@github.com/metno/noresm.git You first need to be registered as a noresm user on github (see detailed info in Obtain a copy of the model (using git).
If you are on a normal ubuntu PC and want the source code, you might see that “svn checkout” complains about “gnome keyring”. If you see this problem, the solution is here: http://askubuntu.com/questions/206604/svn-and-gnome-keyring
- Need access to other versions: Special access document**:
- https://docs.google.com/a/met.no/document/d/1G1ezxtBhzDyNWwrKJYWmp8gn402bOWThe_6gN00PDMQ/edit?usp=sharing
Running / Configuring the model¶
- Newbies guide to running NorESM
- Advanced configuration (NorESM1)
- Advanced configuration of NorESM2
- Fluxes crossing boundaries
- CMIP6 volcanic forcing
- CMIP6 emissions of short-lived components
- CMIP6 greenhouse gas concentrations in NorESM
- Atmospheric output for some commonly used configurations of NorESM2 (Oct 30’th 2018)
Develop the model¶
Setting up at different machines¶
Most developers compile and run NorESM on hexagon (hexagon.bccs.uib.no). That machine uses the portland group fortran compiler. Most developers develop the code on that machine using “develop/compile/run/analyze print statments” on that machine.
Some experiments have also been done with compiling running CAM on a normal Linux PC in order to use interactive debuggers. (see below)
Issue tracker¶
Any development should ideally be agreed with the NorESM development team and be properly described in the issue tracker, see the link below
If you have changed the model and want to merge your changes to the trunk, your model has to pass some tests:
Testing¶
Version control best practices¶
- NEW**: After switching to git (13th november 2015) the
- svn-repository is read-only. Some advice on how to use the new git-repository are available here: Obtain a copy of the model (using git)
Some guidelines for modifying NorESM’s subversion repository: SVN - Best Practice/FAQ
How-to for setting up svn repositories on NorStore: Subversion how-to for NorStore
NorESM2 branches in active development¶
- https://github.com/metno/noresm/: master (this is the trunk/master version)
- https://github.com/metno/noresm/: featureCAM5-OsloDevelopment_trunk2.0-6 (Main development branch for CAM-Oslo aerosol features)
- https://github.com/metno/noresm/: feature-classnuc-ice_featureCAM5-OsloDevelopment-2 (ice nucleation feature branch)
- https://github.com/metno/noresm/: featureNitrate_featureCAM5-OsloDevelopment-2/ (aerosol nitrate feature branch)
NorESM1 branches in active development¶
- https://github.com/metno/noresm/ noresm-ver1-cmip5/ (Original NorESM1-M CMIP5 version. Only technical updates)
- https://github.com/metno/noresm/: noresm-ver1_r112-r169/ (Further development from the CMIP5 version. Include EU-ACCESS project improvements)
You obtain the model code through checking it out. The command would be git clone https://githubUserName@github.com/metno/noresm.git git checkout -b aBranchName origin/aBranchName This gives the code in your directory
Uncertain parameters in the aerosol model¶
Developing the model also involves setting some uncertain numbers into the model. Not all of these are available from namelists. Go to the link below to understand where main uncertainties are.
Uncertain parameters (which can be discussed) in the aerosol model
Analyze model results¶
Several tools are shared among NorESM users
Archive model results¶
Long-term archiving is normally done on NorStore’s disk resources (e.g, in /projects/NS2345K/noresm/cases).
To avoid loss of data, another copy should be placed on tape. For instructions, see Norstore Tape
Data that builds the basis of publications should be migrated to NorStore’s Research Data Archive in order to guarantee preservation and also to offload the project area. For specific NorESM instructions, see NorStore Research Data Archive: Guidelines for ingestion of NorESM output
CMIP5 archive of NorESM results¶
NorStore Research Data Archive: Guidelines for ingestion of NorESM output
Past and ongoing work¶
Several simulations have been performed with NorESM. A list of available simulations and runs can be found here. List of model runs by NorESM. The page also contains an overview of planned simulations. A fairly extensive description of the model and to some extent also the CMIP5 runs can be found at http://pcmdi9.llnl.gov/esgf-web-fe/
Choose one of the links. Search for NorESM1-M CMIP5 in the search fields. Choose the link model documentation
NorESM is also used in several projects: Existing projects
Resources¶
* TaiESM CCliCS workshop in Taipei 2016 - Ingo Bethke
[1] | M. Bentsen, I. Bethke, J. B. Debernard, T. Iversen, A. Kirkevåg, Ø. Seland, H. Drange, C. Roelandt, I. A. Seierstad, C. Hoose, and J. E. Kristjánsson. The norwegian earth system model, noresm1-m – part 1: description and basic evaluation of the physical climate. Geoscientific Model Development, 6(3):687–720, 2013. URL: https://www.geosci-model-dev.net/6/687/2013/, doi:10.5194/gmd-6-687-2013. |
[2] | T. Iversen, M. Bentsen, I. Bethke, J. B. Debernard, A. Kirkevåg, Ø. Seland, H. Drange, J. E. Kristjansson, I. Medhaug, M. Sand, and I. A. Seierstad. The norwegian earth system model, noresm1-m – part 2: climate response and scenario projections. Geoscientific Model Development, 6(2):389–415, 2013. URL: https://www.geosci-model-dev.net/6/389/2013/, doi:10.5194/gmd-6-389-2013. |
[3] | A. Kirkevåg, T. Iversen, Ø. Seland, C. Hoose, J. E. Kristjánsson, H. Struthers, A. M. L. Ekman, S. Ghan, J. Griesfeller, E. D. Nilsson, and M. Schulz. Aerosol–climate interactions in the norwegian earth system model – noresm1-m. Geoscientific Model Development, 6(1):207–244, 2013. URL: https://www.geosci-model-dev.net/6/207/2013/, doi:10.5194/gmd-6-207-2013. |
[4] | J. F. Tjiputra, C. Roelandt, M. Bentsen, D. M. Lawrence, T. Lorentzen, J. Schwinger, Ø. Seland, and C. Heinze. Evaluation of the carbon cycle components in the norwegian earth system model (noresm). Geoscientific Model Development, 6(2):301–325, 2013. URL: https://www.geosci-model-dev.net/6/301/2013/, doi:10.5194/gmd-6-301-2013. |
[5] | A. Kirkevåg, A. Grini, D. Olivié, Ø. Seland, K. Alterskjær, M. Hummel, I. H. H. Karset, A. Lewinschal, X. Liu, R. Makkonen, I. Bethke, J. Griesfeller, M. Schulz, and T. Iversen. A production-tagged aerosol module for earth system models, osloaero5.3 – extensions and updates for cam5.3-oslo. Geoscientific Model Development, 11(10):3945–3982, 2018. URL: https://www.geosci-model-dev.net/11/3945/2018/, doi:10.5194/gmd-11-3945-2018. |