This component provides a parser and control to acquire data from a DMT CCN. This includes both offline parsing and online control.
Usage
da.acquire.dmt.ccn [switches…] [file]
Switches
- --mode=TYPE
-
This is the base import mode. It defines the defaults for other options. Thos defaults may be overridden by setting those options.
Default: Raw data
The possible values are:
- --mode=cpd1
-
CPD1 raw data recorder output
- --mode=cpd2
-
CPD2 raw data recorder output
- --mode=doy
-
Same as --mode=twotime
- --mode=raw
-
Raw data input, with implicit times
- --mode=singletime
-
CSV input with a single time field
- --mode=twotime
-
CSV input with a two part time field
- --mode=yeardoy
-
Same as --mode=twotime
- --basetime=TIME
-
When dealing with files without a full timestamp on each record, this time is used to reconstruct the full time from the time of day on the H records.
- --model-interval=INTERVAL
-
This is the interval the model is executed at. This defines the amount of data averaged together to make a single request for the model to generate a supersaturation for.
Default: One minute
The interval must be greater than zero in length.
- --processing-interval=INTERVAL
-
This is the interval the that general processing is executed at. This defines the amount of time that enters into the reported dT standard deviation.
Default: One minute
The interval must be greater than zero in length.
- --record-index=INTEGER
-
The index, starting from one, of the record data.
This option only accepts integers greater than or equal to 1.
- --stability=SMOOTHER
-
This is the smoother that is used to by the acquisition system to determine if T3-T1 is stable.
Default: Always stable
The smoother is used for stability and spike detection.
- --station=STRING
-
The station code to assign to data values.
Default: NIL
- --suffix=STRING
-
The instrument suffix (e.x. "S11") to use when completing variables.
Default: Automatically determined
- --time-index=INTEGER
-
The index, starting from one, of the first (and only unless using multiple fields) time field in each record.
This option only accepts integers greater than or equal to 1. Undefined values are permitted, to indicate that the option is set but not to a specific value.
- --time-index2=INTEGER
-
The index, starting from one, of the second time field.
This option only accepts integers greater than or equal to 1. Undefined values are permitted, to indicate that the option is set but not to a specific value.
Arguments
- file
-
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.
If no file is supplied then the input is read from standard input.
Examples
- Ingest CPD1 raw data record output
-
da.acquire.dmt.ccn --mode=cpd1
- Discard the first field and ingest year and DOY times
-
da.acquire.dmt.ccn --mode=twotime --record-index=4 --time-index=2 --time-index2=3
- Convert data
-
da.acquire.dmt.ccn