This component provides a parser and control to acquire data from a Magee Aethalometer, models AE16, AE21, or AE31. This includes both offline parsing and online control.
Usage
da.acquire.magee.aethalometer162131 [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
- --bcunits=TYPE
-
This specifies the units that the instrument is set to report the EBC in.
Default: Autodetect from the data
The possible values are:
- --bcunits=ng
-
ng/m³
- --bcunits=ug
-
μg/m³
- --p=NUMBER
-
This is the sample pressure the aethalometer is set to. The value is used to convert to an STP of zero °C and 1013.25 hPa.
Default: 1013 hPa
This option only accepts numbers strictly greater than 10.
- --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
- --t=NUMBER
-
This is the sample temperature the aethalometer is set to. The value is used to convert to an STP of zero °C and 1013.25 hPa.
Default: 20 °C
- --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.
- --timebase=INTEGER
-
This is the number of minutes expected between records.
Default: 5 minutes
This option only accepts integers greater than or equal to 1.
- --spot=NUMBER
-
This is the sampling area of the filter spot. If it is greater than 0.1 it is assumed to be in mm², otherwise it is treated as being in m².
Default: 50.0 mm²
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.magee.aethalometer162131 --mode=cpd1
- Discard the first field and ingest year and DOY times
-
da.acquire.magee.aethalometer162131 --mode=twotime --record-index=4 --time-index=2 --time-index2=3
- Ingest completely raw data
-
da.acquire.magee.aethalometer162131 --mode=raw
- Convert data using the default high sensitivity spot size.
-
da.acquire.magee.aethalometer162131
- Explicitly set the sample spot size.
-
da.acquire.magee.aethalometer162131 --spot=42.12