dilution.conf

This file controls the dilution corrections applied to data as part of the editing chain by data.edit.dilution. Note that data.edit.dilution is NOT part of the normal edit chain and must be enabled for the station with edit.filters.conf. It is located in $DB/etc/$STATION/dilution.$STATION.conf.

Format

Lines beginning with '#' are treated as comments. Each line consists of a start time in any convertible time format for which the subsequent fields apply. The start time can be zero or omitted to indicate the start of all time.

If the field after the time is the word “DISABLE” then all dilution corrections from that time onwards or until a time when more are added are disabled. This allows the entire dilution system to be turned off with a single line. It can be re-enabled at a later time by re-adding the defining lines.

Otherwise, the field after the time is the record being processed. Note that later variables are not required to reside in this record but they must reside in a record (even if the line for that record defines no variables). The record name is only used to tie a set of variables to a time period and to indicate that a record is needed to correct data.

If the field after the record is the word “DISABLE” then from the time onwards or until another definition of the record occurs, then that record is not loaded and any prior corrections associated with it are not applied. That is, if a prior definition indicated flows associated with it, then they are disabled.

Otherwise, the next two fields are a list of dilution flows and instrument flows to add (overrides anything added by any prior definition of the record). The total flow is the sum of all the dilution and instrument flows. See data.edit.get. Each list is a semicolon separated set of flow values as defined below.

All further fields are considered as variables for which the final dilution factor should be applied. For example, all scattering variables.

Flow Value Format

Every flow value is a set of up to four values: base flow, temperature, pressure, and scaling factor and offset. The flow, temperature, and pressure can be either a numeric constant or a variable name (which must appear in some record being loaded). If absent or not specified they default to 0.0 lpm, 273.15 K, and 1013.25 hPa respectively. The temperature and pressure will be used to correct the flow to STP if needed. The scaling factor must be numeric and defaults to 1.0 (no scaling done), the offset defaults to zero.