da.summary.timeline

This is the base summary mode. This determines the results output as well as the method of displaying them.

Default: Instrument coverage

The possible values are:

When enabled a summary of the currently active parameters is output. For example this would output the instruments active if instrument display is enabled.

Default: Determined by base mode

The possible values are:

This is the method that input data is broken down into separate traces or columns. For example in instrument mode all inputs belonging to the same instrument are combined into one output.

Default: Determined by base mode

The possible values are:

When enabled the timeline will incorporate coverage information into the display.

Default: Determined by base mode

This sets any additional data paths to include in the final summary output.

When enabled the current values of the additional data parameters will be incorporated into the output report. This has no effect on symbol based timelines and no effect unless one or more additional data paths are set.

When enabled changes to the additional data specifications will be incorporated into the output. Unless one or more additional data paths are set, this will have no effect.

Default: Enabled

This is the interval that data are displayed at. For example this sets the interval between lines in CSV report mode or the time in each symbol on a timeline. When not set it defaults to the calculation interval for reports or a fixed amount of time determined by the timeline size.

Default: Automatic

The interval must be greater than zero in length.

This is the way change events are displayed.

Default: Determined by base mode

The possible values are:

This is the interval between an event representing absence and the next valid one before anything is displayed. That is, this is them minimum amount of time something must be absent for before the absence is reported.

Default: One day

Undefined intervals are accepted. The interval must be greater than or equal to zero length.

When enabled active instrument information will be incorporated into the output report. This has no effect on symbol based timelines.

When enabled instrument change events will incorporated into the output.

Default: Determined by base mode

This is the interval that continuous parameters are calculated at. For example, all data are binned together at this interval when calculating coverage. This will also set the display interval if none is explicitly set.

Default: One day

The interval must be greater than zero in length.

When set a legend is output when displaying a symbol based timeline.

Default: Enabled

This sets any additional data paths to include in the final summary output. Because these are looked up from metadata values they will usually begin with a "^" indicating a metadata path

When enabled the current values of the additional data parameters will be incorporated into the output report. This has no effect on symbol based timelines and no effect unless one or more additional data paths are set.

When enabled changes to the additional data specifications will be incorporated into the output. Unless one or more additional data paths are set, this will have no effect.

Default: Enabled

When enabled current presence information will be incorporated into the output report. This has no effect on symbol based timelines.

When enabled presence change events will incorporated into the output.

Default: Determined by base mode

When enabled data interval information will be incorporated into the output report. This has no effect on symbol based timelines.

This is the way the timeline is displayed.

Default: Determined by base mode

The possible values are:

When enabled current wavelength information will be incorporated into the output report. This has no effect on symbol based timelines.

When enabled wavelength change events will incorporated into the output.

Default: Determined by base mode

This argument is used to specify the station used to look up variables that do not include a station as part of an archive read specification. The station is the three letter GAW station code of the location, such as BND. The argument accepts multiple stations specified as regular expressions and separated by : or ; or ,. For example BND,MLO and (BND|MLO) are two ways of selecting both the BND and MLO stations.

The special value allstations may also be specified to select all stations.

This argument may be split into multiple actual program arguments. Each part consists of one or more variable specifications separated by , (commas). The station and archive used if none are explicitly given are defined in the other arguments or inferred from system defaults. For example simply BsB_S11 selects the blue scattering from the S11 instrument and returns all cut sizes and metadata. If instead ::BsB_S11:pm10 is used then only PM10 scattering is returned. That is, the selection specifies "any" station and archive (the defaults are set in the other arguments) then requires that it has the "PM10" flavor. A specification such as bnd:BsB_S11,thd:BsB_S11 allows for data selection from multiple stations.

This may also be used to select a "record" type alias such as "S11a". In this mode all the variables defined in the alias are returned.

Finally the special value everything can be used to select all available data for the given station(s) and archive(s).

This argument may be split into multiple actual program arguments. This full list of time arguments defines a time bounds list that sets the range of data queried. The final resulting data are clipped to the given time bounds but any values that intersect them are returned.

This argument is used to specify the archive used to look up variables that do not include an archive as part of an archive read specification. The archive is the internal name, such as raw or clean_meta. The argument accepts multiple archives specified as regular expressions and separated by : or ; or ,. For example raw(_meta)? selects both the raw and raw_meta archives.

The special value allarchives may also be used to select all available archives.

This argument is used to specify the the file to read data from. If it is present and exists then data is read from the given file name instead of from standard input. Alternatively - (a single dash) may be used to explicitly specify standard input.