This program provides an interface to display or edit configuration information as text files. This generally allows for a flat file representation similar to a classif configuration file.

Usage

da.config.text [switches…​] [station] variables [times] [archive]

Switches

--editor=STRING

This is the editor command that will be invoked when in read→modify→write editing mode. If not set then the editor will be selected by what is set in the $EDITOR environment variable. If that is not set then an editor will be selected based on the presence of a GUI environment.

Default: Automatically selected

--file=FILE

This sets the file name to read or write to. By default standard input or output is used.

Default: Disabled, used standard input/output

--flat[=BOOLEAN]

When set, this outputs on a single data indentifer and time bound to be output, instead of the full specification.

--mode=TYPE

This sets the mode the flat file generator works in.

Default: Read data from the archive

The possible values are:

--mode=datainput

Read data from the archive or standard input and generate the flat file as output.

--mode=dataoutput

Read and parse data from the file and generate data on standard output.

--mode=edit

Read data from the archive to a temporary file then open an editor on that file. Once the editor is closed write the changes back to the archive.

--mode=modify

Same as --mode=edit

--mode=read

Read data from the archive and generate a flat file as output.

--mode=write

Write data to the archive from an input flag file.

--mode=xml

Read data from the archive to a temporary file in XML then open an editor on that file. Once the editor is closed write the changes back to the archive.

--output-bounds[=BOOLEAN]

When set, this causes the data bounds to always be output instead of only output when needed.

--output-identifiers[=BOOLEAN]

When set, this causes the data identifiers (station, archive, variable, and flavors) to always be output instead of only output when needed.

--read=TYPE

This sets the mode data are read with. This is used to control what data are displayed for editing.

Default: Accept default metadata

The possible values are:

--read=all

Same as --read=everything

--read=everything

Accept all input data.

--read=metadata

Accept only metadata from the default archive. All read default data are ignored.

--read=nodefault

Do not accept any default station data or metadata.

Arguments

station

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.

variables

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).

times

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.

archive

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.

If the mode is set to read data from standard input, no bare word arguments are required.