intensives.conf

The configuration file used by data.aggregate.intensives. It is located in $DB/etc/$STATION/intensives.$STATION.conf or in the default location $DB/etc/intensives.conf. If the station specific file does not exist then the default one is used. It defines the intensive records that can be generated.

Format

Lines beginning with ”#” are treated as comments and ignored. The overall structure consists of nested blocks defining, at the highest level scope the records and time ranges they are valid for. Within that scope the variables and generators for the data are defined. Each line consists of comma separated values, with the first value being the key determining the line type. Leading whitespace is ignored.

The outermost scope defines the records, the line key (the first field) is a regular expression wrapped like /^$record$/ that is matched against the record type requested. The second field, if present, is a regular expression matched similarly against the archive type requested. The final two fields are the optional start and end times in any convertible time format. If either is absent it is treated as infinite. The record definition continues until they key “end” is encountered at the same scope level.

Within a record definition scope the following keys are valid:

Spawn

The second field is a command to spawn to generate data. Within that command the following replacements are available:

  • ${START} - The start time.
  • ${END} - The end time.
  • ${ARCHIVE} - The requested archive name
  • ${RECORDCAP[1-5]} - The Nth capture from the record matching regular expression.
  • ${ARCHIVECAP[1-5]} - The Nth capture from the archive matching regular expression.

Standard Variable Keys

These keys are valid in all variable types.

  • Format - Sets the output format.
  • MVC - Sets the output MVC.
  • FieldDesc - Sets the variable description.

Literal

A scope defining a literal variable. The first value after the key is the variable name. The scope continues until the key “End” is reached. All standard variable keys are valid.

  • Intputs - List of input variables to use, the output value is the first valid one.

Sum

A scope defining a variable that is the sum of multiple inputs. Each “Inputs” line defines one component of the sum, with the first valid value of that line being added to the total. The first value after the key is the variable name. The scope continues until the key “End” is reached. All standard variable keys are valid.

  • Intputs - List of input variables to use, the output is the sum of the first valid value of all input lines.

Fraction

A scope defining a variable that is the fraction of two inputs. The first value after the key is the variable name. The scope continues until the key “End” is reached. All standard variable keys are valid.

  • Numerator - The numerator of the fraction, the first valid variable is the value used.
  • Denominator - The denominator of the fraction, the first valid variable is the value used.

fRH

A scope defining a f(RH) fraction as function of the power of the curve fit. The first value after the key is the variable name. The scope continues until the key “End” is reached. All standard variable keys are valid.

  • Inputs - List of input variables to use, the first valid one is used.
  • Constant - The constant to raise to the power of the input, defaulting to 4.0 for f(RH=85)/f(RH=45)

Albedo

A scope defining a single scattering albedo. The first value after the key is the variable name. The scope continues until the key “End” is reached. All standard variable keys are valid.

  • Absorption - The absorption value to use, the first valid one is what is used.
  • Scattering - The scattering value to use, the first valid one is what is used.

Angstrom

A scope defining an angstrom exponent calculation. The first value after the key is the variable name. The scope continues until the key “End” is reached. All standard variable keys are valid.

  • First - The first input to calculate for. If multiple variables are specified the first valid one is used. Note they must all be at the same wavelength if multiple are specified.
  • Second - The second input to calculate for. If multiple variables are specified the first valid one is used. Note they must all be at the same wavelength if multiple are specified.
  • FirstWL - The wavelength in nm of the first input. May also be a symbolic color code.
  • SecondWL - The wavelength in nm of the second input. May also be a symbolic color code.

If no wavelengths are specified they are attempted to be inferred from the input variable names. If that fails they default to 450 nm for the first and 700 nm for the second.

AsymPoly

A scope defining the asymmetry parameter as defined by a polynomial fit. The first value after the key is the variable name. The scope continues until the key “End” is reached. All standard variable keys are valid.

  • BackScatter - A list of back scattering variables, the first valid one is used.
  • TotalScatter - A list of total scattering variables, the first valid one is used.
  • Coefficients - The polynomial coefficients in ascending power order (starting at zero, the constant). Defaults to: 0.9893, -3.9636, 7.4644, -7.1439.

RFE

A scope defining the radiative forcing efficiency. The first value after the key is the variable name. The scope continues until the key “End” is reached. All standard variable keys are valid.

  • BackScatter - A list of back scattering variables, the first valid one is used.
  • TotalScatter - A list of total scattering variables, the first valid one is used.
  • Absorption - A list of absorption variables, the first valid one is used.
  • BetaCoefficients - The polynomial coefficients of beta in ascending power order (starting at zero, the constant). Defaults to: 0.0817, 1.8495, -2.9682
  • DaylightFraction - Defaults to: 0.5
  • SolarConstant - Defaults to: 1370
  • AtmosphericTransmission - Defaults to: 0.76
  • CloudFraction - Defaults to: 0.6
  • SurfaceAlbedo - Defaults to 0.15