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 exampleBND,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 simplyBsB_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 asbnd: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
orclean_meta
. The argument accepts multiple archives specified as regular expressions and separated by:
or;
or,
. For exampleraw(_meta)?
selects both theraw
andraw_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.