Major rundeck parameters

A number of parameters are critical in setting up a simulation via the rundeck. These include:

• Definition of the year(s) to be simulated

Definition of the year(s) to be simulated

In order to select which year to simulate, the variable master_yr must be defined in the rundeck. The model will not run without it. This variable can equal to a) the numerical year of simulation, e.g. master_yr=1850 where the year in question will be repeated for every simulation year, or b) master_yr=0 where the model will perform a transient simulation, starting from the year defined by the variable YEARI in the rundeck and ending at the year defined by YEARE. The year currently being simulated in the model code can be accessed via the variable JYEAR.

One can run a simulation with mixed year configurations. When this is the case, master_yr defines the basic configuration, and several other variables declare the deviations from the master_yr setting. Similar with the master_yr case, they can either take the numeric value of a specific year that will be repeated every year, or the value zero, meaning a transient simulation. These are:

• aero_yr: Tropospheric aerosol distribution year for radiation. This applies when aerosols and radiation are not coupled, or for non-tracer simulations.
• aer_int_yr: Aerosol emissions year.
• albsn_yr: Year of BC deposition used for snow albedo.
• crops_yr: Crops distribution year.
• ghg_yr: Greenhouse gases concentrations year.
• o3_yr: O3 precursor emissions year.
• s0_yr: Solar constant year.
• volc_yr: Stratospheric volcanic aerosol year. Other options are: -1, for a 150-year mean (1850-1999); -2010, for the current year up to 2010 and then repeat volcanoes from 100 years ago; -2000, for using the old way of creating future volcanoes.
• orb_par_year_bp: Offset from 1950 for orbital calculations when a single year is being repeated in every simulated year (case variable_orb_par=0; see next point), or zero for transient.
• variable_orb_par: Equals to 0 for constant orbital parameters, 1 for transient orbital parameters. Other options are -1, where orbital parameters from the rundeck (variable orb_par) are being used, and -2 for selecting the in-code orb_par defaults.
• PI_run: Equals to 1 for a preindustrial (year 1850) simulation, and to 0 otherwise. This sets scaling factors of initial conditions for long-lived gases taken from the rundeck (PIratio_XXXX).
• aircraft_Tyr1: Define the first year of data in the aircraft emissions file. If aircraft_Tyr1 == aircraft_Tyr2, the file is assumed to not be transient.
• aircraft_Tyr2: Define the first year of data in the aircraft emissions file. If aircraft_Tyr1 == aircraft_Tyr2, the file is assumed to not be transient.
• biomass_Tyr1: Define the first year of data in the biomass emissions file. If biomass_Tyr1 == biomass_Tyr2, the file is assumed to not be transient.
• biomass_Tyr2: Define the first year of data in the biomass emissions file. If biomass_Tyr1 == biomass_Tyr2, the file is assumed to not be transient.

In addition to the year definition, three parameters have also day-of-year definitions. These are the solar constant (s0_day), greenhouse gases (ghg_day) and stratospheric volcanic aerosols (volc_day). These can be explicitly defined from the rundeck, or not. When not defined, they take their default value defined in the model's code (182 - the middle of the year) or zero when their corresponding _yr value is zero.

Please be aware that this process is NOT smart enough to alter the input files provided by the used via the rundeck. One should take additional care in providing to the model the appropriate input files for the desired simulation (e.g. SST, sea ice, emissions, etc.) via the rundeck.

Consider the following example case:

master_yr=0
aero_yr=1850
O3_yr=1850
variable_orb_par=0
orb_par_year_bp=2000