====== Newbies guide to running NorESM ======

The purpose of this page is to be able to set up and run the model within 15 minutes. For more advanced configuration, please consult http://www.cesm.ucar.edu/models/ccsm4.0/ccsm_doc/ug.pdf

This guide assumes that you have properly checked out the model to some directory which will call $NORESM. This directory will contain subdirectories "models" and "scripts".

=== Go to scripts directory ===
cd $NORESM/scripts

=== Create the case ===
./create_newcase  -case ../cases///casename/// -mach //machinename// -res f19_g16 -compset //compsetname// 

(where //casename//, //machinename// and //compsetname// are user input. Res is imodel resolution. The user can //not// give any resolution since input data are not prepared for any resolution in NorESM.)

To see a list of available composets type

./create_newcase -list

The simplest case which runs production tagged aerosols and data ocean in a VERY coarse resolution is 

./create_newcase -case /path/to/where/I/store/the/case -compset NFPTAERO -mach hexagon -res f10_f10

=== Configure the case ===
cd $NORESM/cases///casename//

edit any configuration files (understand env_conf.xml and env_run.xml)

./configure -case (in NorESM1 / CAM4)

or 

./cesm_setup (in NorESM2 / CAM5)

After these two commands, the case is configured

=== Build the case ===

.///casename//.//machinename//.build (NorESM1 / CAM4)

.///casename//.build (NorESM2 / CAM5)

=== Run the case ===

qsub //casename//.//machinename//.run

=== Example ====

There are already several pre-defined compsets. They all have long and short names. As and example we can use the compset N_2000_AEROSLO_CN (with short name N2000AERCN). Thus a valid command on the machine //hexagon// is: 

./create_newcase  -case /path/to/my/case/directory/ -mach hexagon -res f19_g16 -compset N2000AERCN

(will run a "year 2000" CAM4/NorESM1 case with the Oslo-aerosols) 

./create_newcase  -case /path/to/my/case/directory/ -mach hexagon -res f19_g16 -compset FAMIPC5

(will configure the "default" atmoshere-only simulation of CAM5)

===Important files===

The most important files to understand in your case-directory are: 
  * env_run.xml (model run type, how long time to run etc)
  * env_conf.xml (model configuration)

===More information===

Go to [[NORESM::RunModel::Advanced]] for more information