Skip to content

Namelists

To run a simulation, a namelist .nml file is required, specifying the value of configuration options in a variety of categories or namelists. A diagnostic table file is also required to specify what diagnostics to save for the experiment.

Each page in this section is devoted to a particular namelist, indicating the source code where it is specified and any relevant pages on Isca's website. There are then two sections, Options and Diagnostics:

Options

This section is related to the namelist .nml file and indicates the available options that can be configured in that particular namelist, as well as their default values.

These options can be found, by looking at the module source code (e.g. idealized_moist_phys.F90 for idealized_moist_phys_nml) and searching for the word namelist. You should then find some code like that below, indicating all the options in the namelist.

namelist / idealized_moist_phys_nml / turb, lwet_convection, do_bm, do_ras, &
                                      roughness_heat, do_cloud_simple,      &
                                      two_stream_gray, do_rrtm_radiation,   &
                                      do_damping
Then just above this code, the options will be initialized with their default values.

Diagnostics

This section is related to the diagnostic table file and indicates the diagnostics relevant to the namelist that can be saved to the data directory.

These diagnostics can be found, by looking at the module source code (e.g. idealized_moist_phys.F90 for idealized_moist_phys_nml) and searching for the word mod_name. You should then find some code like that below, indicating the available diagnostics for the namelist.

id_cond_dt_qg = register_diag_field(mod_name, 'dt_qg_condensation',        &
     axes(1:3), Time, 'Moisture tendency from condensation','kg/kg/s')
id_cond_dt_tg = register_diag_field(mod_name, 'dt_tg_condensation',        &
     axes(1:3), Time, 'Temperature tendency from condensation','K/s')

mod_name

The mod_name used in the diagnostic table file is not always the same as the corresponding namelist associated with it. The table below gives the mod_name associated with each namelist. There is a flowchart on Isca's website which is quite useful for understanding how the modules are related to each other.

Module namelist mod_name
Main
atmos_model.F90 main_nml N/A
atmosphere.F90 atmosphere_nml N/A
hs_forcing.F90 hs_forcing_nml hs_forcing
idealized_moist_phys.F90 idealized_moist_phys_nml atmosphere
spectral_dynamics.F90 spectral_dynamics_nml dynamics
Convection
qe_moist_convection.F90 qe_moist_convection_nml N/A
betts_miller.f90 betts_miller_nml N/A
ras.F90 ras_nml ras
Condensation
lscale_cond.F90 lscale_cond_nml N/A
sat_vapor_pres.F90 sat_vapor_pres_nml N/A
Radiation
two_stream_gray_rad.F90 two_stream_gray_rad_nml two_stream
rrtm_radiation.F90 rrtm_radiation_nml rrtm_radiation
socrates_config_mod.F90 socrates_rad_nml socrates
Surface
mixed_layer.F90 mixed_layer_nml mixed_layer
surface_flux.F90 surface_flux_nml N/A
spectral_init_cond.F90 spectral_init_cond_nml N/A
Damping
damping_driver.F90 damping_driver_nml damping
Turbulence
vert_turb_driver.F90 vert_turb_driver_nml vert_turb
diffusivity.F90 diffusivitiy_nml N/A