data.consolidate.station

data.consolidate.station is an interface to request data based on variable names (or expressions to match variable names) instead of by complete records. The process of searching and combining records based on this is somewhat time intensive, so data.consolidate should only be used when normal records are not sufficient. Non-exact matching is particularly intensive, so it should be used with care.

Uses records.conf to determine what records might contain the requested variables.

This is a wrapper around data.consolidate, data.multiplex and some glue Perl code.

Command Line Usage

data.consolidate.station [--source=archive] [--regex] [--noautoavg]
                         station1,station2... start end variable [variable...]

Data is output to standard output.

Arguments

start and end

The time specifiers for the data to be retrieved. Start is inclusive while end is exclusive, so all data contained within the half open interval [start,end) will be returned. Any convertible time format is accepted.

station1,station2

A list of station codes, separated by ”;”, ”,” or ”:”. For example 'brw'. Case insensitive.

variable

Variable specification, each argument can contain multiple variables (separated by a comma, semicolon or space. Shell wildcards are allowed but it should be noted that using wildcards incurs a significant search overhead to start in most cases

--source=archive

Select the archive to retrieve data from, with the default being raw.

--regex

Interpret variables are Perl regular expressions instead of simple wildcard searching. All variables are implicitly wrapped in '^variable$', so the expression must match the head and tail of the variable.

--noautoavg

Disable automatic matching of variables produced by data.avg, if not present then the pattern is applied to the base variable as well instead of only the literal names. Note that when using this it is necissary to specify patterns that resolve both the base records and to the produced records (for example “BsG0?_S11” with –regex).

Example Usage

data.consolidate.station brw,sgp,bnd 2008:10 2008:11 BsB_S11 BsG_S11 BsR_S11