ed2_variable_info: ED2 output variable table

In FoRTExperiment/ed4forte: FoRTE-specific utilities for working with ED2

Description

Table of variable information extracted from the ED2 source code (ed_state_vars.f90).

Usage

ed2_variable_info(variables = NULL)

Arguments

variables

Optional character vector of parameters to query

Details

Columns in the output are as follows:

• variable – The variable name as it appears in the HDF5 output

• description – Variable description

• unit – Variable unit. NA indicuates unitless quantities. Some units are unspecified.

• dimensions – What dimensions the variable has in the output. For instance, (n_pft,n_dbh,ipoly) means the variable is stored in an array with one row (first dimension) per PFT, one column (second dimension) per DBH class, and polygons in the third dimension. Dimension value codes are as follows:

  • npolygons – Number of polygons. For site-level runs, should be 1.

  • ndcycle – Number of steps in the diurnal cycle output. See output variable NDCYCLE as well as IQOUTPUT documentation in the ED2IN file.

  • nzg – Number of soil levels. Defined by the NZG variable in ED2IN (and in the output).

  • n_pft – Number of plant functional types (PFTs). Should be hard-coded to 17. See the INCLUDE_THESE_PFT table in the ED2IN file for (defualt) PFT definitions.

  • n_dbh – Number of DBH classes, in 10cm increments (11 values total). First value is for all plants with DBH <= 10cm, second value is 10 < DBH <= 20, third value is 20 < DBH <= 30, etc., and the last value is DBH > 100cm.

  • nsites – Number of sites. For site-level runs, should be 1.

  • n_dist_types – Number of anthropogenic disturbance classes. There are 8, as follows:

    • 1: Pasture

    • 2: Forest plantation

    • 3: Tree fall

    • 4: Fire

    • 5: Forest regrowth

    • 6: Logged forest (felling)

    • 7: Logged forest (skid trail + road)

    • 8: Cropland

  • npatches – Number of patches. Typically 1, unless multiple patches have been specified.

  • nzs – Number of snow or water layers.

  • ff_nhgt – Number of height classes. If ED2IN flag IFUSION is 0 (default) then 8; otherwise, 19.

  • ncohorts – Number of cohorts. Changes on a monthly timestep.

  • n mort – Number of mortality classes. Hard coded to 5, as follows:

    • 1: Aging (PFT-dependent parameter)

    • 2: Negative carbon balance

    • 3: Treefall mortality

    • 4: Cold weather mortality

    • 5: Disturbance mortality.

  • n_radprof – Radiation profile identifiers. Hard coded to 10, with values corresponding to the following (PAR is "photosynthetically active radiation", ~400-700nm wavelength; NIR is "near-infrared", ~700-2500nm wavelength. "Beam" is direct radiation. Thermal radiation is diffuse by definition):

    • 1: PAR, Beam, Down

    • 2: PAR, Beam, Up

    • 3: PAR, Diffuse, Down

    • 4: PAR, Diffuse, Up

    • 5: NIR, Beam, Down

    • 6: NIR, Beam, Down

    • 7: NIR, Diffuse, Down

    • 8: NIR, Diffuse, Up

    • 9: Thermal, Down

    • 10: Thermal, Up

  • A number (e.g. 5) – The hard-coded literal dimension size.

• code_variable – The variable name used in the ED2 source code

• in_<*> – Whether or not the variable is included in the corresponding output file (unless noted otherwise, the file letter code corresponds to the second letter in the ED2IN output type, so, for instance, ISOUTPUT produces files with the -S- identifier):

  • history – History restart files. ED2IN tag ISOUTPUT.

  • analysis – Instantaneous output ("fast analysis") files, one per time step. ED2IN tags IFOUTPUT and IOOUTPUT.

  • daily – Daily averages. ED2IN tag IDOUTPUT.

  • monthly – Monthly averages. ED2IN tag IMOUTPUT. File tag -E-.

  • diurnal – Monthly averages of the diurnal cycle. ED2IN tag IQOUTPUT.

  • yearly – Yearly averages. ED2IN tag IYOUTPUT.

  • tower – "Tower" files; fast output, but aggregated to one file per year.

• glob_id – Not sure, but might be useful?

• info_string – The raw file information string from which the variable name and output file was derived. Mostly for debugging.

Value

data.frame of ED2 variable information. See "Details".

Author(s)

Alexey Shiklomanov

FoRTExperiment/ed4forte documentation built on March 21, 2020, 6:54 p.m.