This component provides a parser and control to acquire DMT Backscatter Cloud Probe data. This includes both offline parsing and online control.
Usage
da.acquire.dmt.bcp [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: Single time field
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=singletime
-
CSV input with a single time field
- --mode=twotime
-
CSV input with a two part time field
- --mode=yeardoy
-
Same as --mode=twotime
- --record-index=INTEGER
-
The index, starting from one, of the record data.
This option only accepts integers greater than or equal to 1.
- --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.
- --q=NUMBER
-
This is the flow rate of the CPC at lpm measured at ambient conditions.
Default: 1.4210 lpm
This option only accepts numbers strictly greater than 0.
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.bcp --mode=cpd1
- Discard the first field and ingest year and DOY times
-
da.acquire.dmt.bcp --mode=twotime --record-index=4 --time-index=2 --time-index2=3
- Convert data using the default flow rate
-
da.acquire.dmt.bcp
- Explicitly set flow rate.
-
da.acquire.dmt.bcp --q=25.78