This is an old revision of the document!
NORESM wiki
NorESM is the Norwegian Earth System model. 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.
The main differences are:
- Aerosol/chemistry scheme
- Ocean model (MICOM)
(See details in Bentsen, M., I. Bethke, J. B. Debernard, T. Iversen, A. Kirkevåg, Ø. Seland, H. Drange, C. Roelandt, I. A. Seierstad, C. Hoose, and J. E. Kristjansson (2012): The Norwegian Earth System Model, NorESM1-M. Part 1: Description and basic evaluation, Geosci. Model Dev., 6, 687-720, doi:10.5194/gmd-6-687-2013)
This wiki contains information shared between NorESM developers and users
Purpose of wiki
The purpose of the wiki is to provide a common place for NorESM users and developers to share information. What tools are you using? Which version should I run for what purpose? etc.
Any questions about the wiki content should be directed to alf.grini@met.no
Obtaining a version of the model
To obtain the current official version: svn checkout https://svn.met.no/NorESM/noresm/branches/noresm-ver1-cmip5. If you are not a registered user, contact trond.iversen@met.no to get the proper authorization.
The main trunk (stable development verison) is available at https://svn.met.no/NorESM/noresm/trunk/noresm/ (svn checkout https://svn.met.no/NorESM/noresm/trunk/noresm/). The latest version of the trunk is upgraded to CESM1.2 (including CAM 5.3).
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
NEW The development version has been moved to git: Obtain a copy through
git clone https://github.com/metno/noresm
You first need to be registered as a noresm user on github (see detailed info in Obtain a copy of the model (using git))
Running / Configuring the model
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 her: 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 (valid before switching to git)
- https://svn.met.no/NorESM/noresm/trunk/ (this is the trunk)
- https://svn.met.no/NorESM/noresm/branches/featureCAM5-OsloDevelopment_trunk2.0-4 (Main development branch for CAM-Oslo aerosol features)
- https://svn.met.no/NorESM/noresm/branches/featureSOAnucleation_featureCAM5-OsloDevelopment-2 (SOA/nucleation aerosol feature branch)
- https://svn.met.no/NorESM/noresm/branches/feature-classnuc-ice_featureCAM5-OsloDevelopment-2 (ice nucleation feature branch)
- https://svn.met.no/NorESM/noresm/branches/featureNitrate_featureCAM5-OsloDevelopment-2/ (aerosol nitrate feature branch)
- https://svn.met.no/NorESM/noresm/branches/featureOnlineOceanEmis_featureCAM5-OsloDevelopment-3 (online emissions of POM/DMS)
NEW: trunk now contains a first version of the Oslo (Production Tagged) aerosol model. There is one compset using those aerosols: NFPTAERO
NorESM1 (valid before switching to git) branches in active development
- https://svn.met.no/NorESM/noresm/branches/noresm-ver1-cmip5/ (Original NorESM1-M CMIP5 version. Only technical updates)
- https://svn.met.no/NorESM/noresm/branches/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
svn checkout $URL myDirectory
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
- Prepare atmospheric output on pressure surfaces (Need working netcdf libraries) pressuresurfaces.tar.gz
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 Archive
Share model results
Model output and derived data products can be shared via the Norwegian Earth System Grid data portal http://noresg.norstore.no (see Simple online sharing for instructions).
Some aerosol and cloud-relevant output for the development version of NorESM2 is available for those with MET Norway affiliation through VpN at /vol/fou/emep/People/alfk/CAM-Oslo-diagnostics/
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