6.16. prescribed_data.nml

This file contains a variable number of namelists that are used to prescribe time-varying input data that is not meteorological forcing. The namelist JULES_PRESCRIBED should occur only once at the top of the file. The value of n_datasets in JULES_PRESCRIBED then determines how many times the namelist JULES_PRESCRIBED_DATASET should occur.

6.16.1. JULES_PRESCRIBED namelist members

JULES_PRESCRIBED::n_datasets
Type:integer
Permitted:>= 0
Default:0

The number of datasets that will be specified using instances of the JULES_PRESCRIBED_DATASET namelist.

6.16.2. JULES_PRESCRIBED_DATASET namelist members

This namelist should occur n_datasets times. Each occurrence of this namelist contains information about a single dataset (i.e. set of related files).

Members used to specify the files containing the data

JULES_PRESCRIBED_DATASET::read_list
Type:logical
Default:F

Switch controlling how data file names are determined for a given time.

TRUE
Use a list of data file names with times of first data.
FALSE
Use a single data file for all times or a template describing the names of the data files.
JULES_PRESCRIBED_DATASET::nfiles
Type:integer
Permitted:>= 0
Default:0

Only used if read_list = TRUE.

The number of data files to read name and time of first data for.

JULES_PRESCRIBED_DATASET::file
Type:character
Default:None

If read_list = TRUE, this is the file to read the list of data file names and times from. Each line should be of the form:

'/data/file', 'yyyy-mm-dd hh:mm:ss'

In this case data file names may contain variable name templating only, with the proviso that either no file names use variable name templating or all file names do. The files must appear in chronological order.

If read_list = FALSE, this is either the single data file (if no templating is used) or a template for data file names. Both time and variable name templating may be used.

Members used to specify the provided variables

JULES_PRESCRIBED_DATASET::nvars
Type:integer
Permitted:>= 0
Default:0

The number of variables that the dataset will provide.

See List of supported variables for the supported variables.

JULES_PRESCRIBED_DATASET::var
Type:character(nvars)
Default:None

List of variable names as recognised by JULES (see List of supported variables). Names are case sensitive.

Note

For ASCII files, variable names must be in the order they appear in the file.

JULES_PRESCRIBED_DATASET::var_name
Type:character(nvars)
Default:None

For each JULES variable specified in var, this is the name of the variable in the file(s) containing the data.

Note

For ASCII files, this is not used - only the order in the file matters, as described above.

JULES_PRESCRIBED_DATASET::tpl_name
Type:character(nvars)
Default:None

For each JULES variable specified in var, this is the string to substitute into the file name(s) in place of the variable name substitution string.

If the file name(s) do not use variable name templating, this is not used.

JULES_PRESCRIBED_DATASET::interp
Type:character(nvars)
Default:None

For each JULES variable specified in var, this indicates how the variable is to be interpolated in time (see Temporal interpolation).

6.16.2.1. List of supported variables

All variables input using prescribed_data.nml must have a time dimension using time_dim_name.

In theory, any variable with an entry in the subroutine populate_var in model_interface_mod (see I/O framework) can be updated via this mechanism, and the use of any of these variables is not explicitly prevented. However, it is up to the user to assess whether using this mechanism to update any particular variable is appropriate or desirable.

The use of the following variables is explicitly supported:

Name Description Levels (z) dimension required in files
ozone

Surface ozone concentration (ppb).

Note

Required if l_o3_damage = TRUE.

None
canht PFT canopy height (m). Dimension of size npft using pft_dim_name.
lai PFT leaf area index. Dimension of size npft using pft_dim_name.
albobs_sw

Observed SW albedo.

Note

Required if l_albedo_obs = TRUE and l_spec_albedo = FALSE.

None
albobs_vis

Observed VIS albedo.

Note

Required if l_albedo_obs = TRUE and l_spec_albedo = TRUE.

None
albobs_nir

Observed NIR albedo.

Note

Required if l_albedo_obs = TRUE and l_spec_albedo = TRUE.

None