6.29. 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.29.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.29.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 start, end and period of the data

JULES_PRESCRIBED_DATASET::data_start

JULES_PRESCRIBED_DATASET::data_end

Type:character Default:None

The times of the start of the first timestep of data and the end of the last timestep of data.

Each run of JULES (configured in timesteps.nml) can use part or all of the specified data. However, there must be data for all times between run start and run end (determined by main_run_start, main_run_end, spinup_start and spinup_end).

The times must be given in the format:

"yyyy-mm-dd hh:mm:ss"

JULES_PRESCRIBED_DATASET::data_period

Type:integer Permitted:-2, -1 or > 0 Default:None

The period, in seconds, of the data.

Special cases:

-1: Monthly data

-2: Yearly data

JULES_PRESCRIBED_DATASET::is_climatology

Type:logical Default:F

Indicates whether the data is to be used as a climatology (use the same data for every year).

TRUE

Interpret the data as a climatology. data_start and data_end must be such that exactly one year of data is specified.

FALSE

Do not interpret the data as a climatology.

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:‘’ (empty string)

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

If the empty string (the default) is given for any variable, then the corresponding value from var is used instead.

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).

JULES_PRESCRIBED_DATASET::prescribed_levels

Type:integer(n) where n ranges from 1 (one level prescribed) to sm_levels (all levels prescribed) Default:1, …, sm_levels i.e. all levels prescribed

Indices of the subset of levels to be prescribed. Currently only implemented for var = sthuf and nvars = 1. The numbering of the soil level indices starts at 1 (corresponding to the layer touching the surface). Note that sthuf data must be provided for all soil levels, but can be set to dummy values for the levels that are not prescribed.

6.29.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 dimension(s) required in files
ozone	Surface ozone concentration (ppb). Note Required if l_o3_damage = TRUE.	None
canht	PFT canopy height (m). Note Not possible if l_triffid = TRUE	Single levels dimension of size npft using pft_dim_name.
lai	PFT leaf area index. Note Not possible if l_triffid = TRUE or l_phenol = TRUE	Single levels dimension of size npft using pft_dim_name.
albobs_sw	Observed SW diffuse albedo. Note Required if l_albedo_obs = TRUE and l_spec_albedo = FALSE.	None
albobs_vis	Observed VIS diffuse albedo. Note Required if l_albedo_obs = TRUE and l_spec_albedo = TRUE.	None
albobs_nir	Observed NIR diffuse albedo. Note Required if l_albedo_obs = TRUE and l_spec_albedo = TRUE.	None
co2_mmr	Concentration of atmospheric CO2, expressed as a mass mixing ratio. Note A single value of co2_mmr is applied globally. Data must be supplied for each gridpoint, but only the value of the first grid-point is used.	None
sthuf	Soil wetness for each soil layer. This is the mass of soil water (liquid and frozen), expressed as a fraction of the water content at saturation. Note Soil wetness will be set to the prescribed value at the beginning of each timestep but will be incremented during that timestep. Also, it is recommended that the prescribed sthuf does not exceed one.	Single levels dimension of size sm_levels using soil_dim_name.
frac_agr	Fractional area of agricultural land in each gridbox.	None
tracer_field	Surface concentration of atmospheric chemical tracers in the atmosphere, for calculation of deposition, as mass mixing ratio (kg kg -1).	Single levels dimension of size ndry_dep_species using tracer_dim_name.
bl_height	Height above surface of top of atmospheric boundary layer (m).	None
level_separation	Separation of boundary layer levels (m). The levels are listed starting at the surface and working up.	Single levels dimension of size bl_levels using bl_level_dim_name.