AVAPS Metadata

Named AVAPS metadata fields, definitions, and errata

Documentation Information

Purpose

This document is a proposal and contract on many of the named metadata fields along with meanings intended usages, and terminology used within AVAPS infrastructure equiptment, software, and data set. This document, though a living document, should contain the entirity of defined meaning for named metadata parameters. Please voice all concerns, questions, and potential conflicts to the appropriate NCAR staff.

Release History

This document is a living document that is created from a set of version controlled configuration files and some crude parsing tools. The configuration is meant to be machine read, and various output sources, and documentation bits emitted, of which this document is one. The intent is that changes, whether small spelling corrections, or adding additional metadata parameters, require little manual tinkering, and the modifications can be disseminated automatically to necessary users.

This document has undergone the following releases:

ReleaseDateResponsible PartySummary of Changes
1 - npotts Initialize collection of fields and assembly of documentation

Creation

  • Generation Date: 2024-10-23T11:08:08-06:00
  • Repository Version: 1

Document Creation

This document is a living document that is created from a set of version controlled configuration files and some crude parsing tools. The configuration is meant to be machine read, and various output sources, and documentation bits emitted, of which this document is one. The intent is that changes, whether small spelling corrections, or adding additional metadata parameters, require little manual tinkering, and the modifications can be disseminated automatically to necessary users.

This document has undergone the following releases:

ReleaseDateResponsible PartySummary of Changes
1 - npotts Initialize collection of fields and assembly of documentation

Metadata Field Definitions and Rules

Requirements and Intents

Long term archival of any sort of data necessitates the collection and retention of associated metadata (data about the data) in order for the data to be of any long term use. This problem is neither AVAPS, nor NCAR specific - your general library is only as useful as the information about the contents in the books is organzied and correct. In effect, the library is only as good as its metadata is. If your local library has all the books in the world in a heaping pile on the floor, it is mostly useless for any sort of actual inquiry. The intent of the AVAPS-Metadata project is to name and accurately define common metadata fields that can be known about AVAPS sondes, soundings, and maintain the list for perpetuity to aid in the utility of the data itself.

Once this proposal is accepted (eg, a formally released version), the definitions and meanings of each field may not change, but the meaning may be clarified, made obsolete, or marked as invalid as needed. The intent is that more fields may be added in order to address new functionality, concerns, or changes in meaning. If there exists a field named "MSL" which is defined as Mean Sea Level based on WGS84, and a new MSL, which is defined as Mean Seal Level based on a better model (say EGM2008), these are two distinct metadata values, and should be treated as such - values using the second definition SHALL NOT commedier the first and keep going - they should further define the first definition and create a new field.

The initial design requirements had the following stated definitions, which should be followed in the spirit of intent.

  • Single format of metadata to be shared at all levels of usage (sonde, production, data logging, and post-drop analysis).
  • Format should be extendable in the future. EG: We should be able to add more fields without touching sonde firmware.
  • Adding more fields is as simple as adding more #defines in code or alteration of the source documentation.
  • If old code sees new fields, it should not misbehave/segfault/complain/die - It should make allowance for fields that may exist but may be unknown in functionality or meaning.
  • Structure should map nicely into language constructs
  • byte-dense, but not at the cost of readability

Formatting Rules

The format chosed is a simple string which is built by key=value pairs seperated by | symbols. key is a unsigned integer > 1, value is a string not containing any | characters, and multiple key=value fields are seperated by | characters. Generally speaking:

  • key is an an unsigned integer > 0
    • ASCII encoded ("1", eg not 0x1)
    • Must match the following regex: `[1-9][0-9]+[\w]*?=`
    • Unique and well defined meaning. EG. 94 may be defined as 'launch pressure via a algorithm X', and "95" may be defined as 'launch pressure via algorithm Y'.
    • Definition for a key may optionally have a unit. (s, m/s)
  • value is defined as:
    • A string not consisting of a '|' including escaped versions of '|' such as '\|'
    • ALL values explicitly match the following regex: `[^|]*`
    • Can contain newlines (\n) carriage returns (\r) and other various bits of binary information
    • A regex validator should be provided for each key that validates the contents of _value_

The follow is an example of a valid metadata formatted string 1=1|2=124435242|3=G5|4=2.05|5=20120718T160823|6=RD94|7=RSS904|8=Ublox NEO-6Q|9=845.79|10=845.053

The follow is an example of an invalid metadata string 0=invalid key|1=cannot escape|symbols

Table Definitions

For the sake of clarity and uniformity, the following metadata fields have the following definitions:

LabelMeaning
Human NameHuman readable abbreviated name for a field. This will be used in compiled code as named variables. Should be CamelCase, cannot start with a number, avoid underscores & hyphens
IDThe key assigned to this value. Once set, it cannot be ever reused, even in case of mistakes or mis-counting
VerVersion when this field was officially defined
UnitPhysical unit, if applicable, such as seconds, meters per second, or grams
OriginatorSource, or creating entity of this metadata field, if known
Validator Regular expression to validate the incoming field, expressed as a string. Regular expressions, when referred to by this document, are Perl-style match-only regular expression. The dot operator (.) should match everything, inclusive of carriage returns, newlines, and the like. This is akin to the perl \m modifier. The following code example give examples for known languages:
// Qt5
QRegularExpression re(".*", QRegularExpression::DotMatchesEverythingOption);

// Golang
re := regexp.MustCompile(`?(m).*`)
DefinitionTechnical definition for what the field contains, implications, or otherwise useful notes.

Metadata Fields

Format

IDValidatorAdded in VersionOriginator
1 ^1$ 1 This Document
Metadata table format - Any changes will increment this value by one

DropCommandSet

IDValidatorAdded in VersionOriginator
2 ^[\d]+$ 1 sonde
Sonde controlled command set to use. Corresponds to the returned value of SRCS in the Sonde ICD

SerialNumber

IDValidatorAdded in VersionOriginator
3 ^[0-9]{9} 1 sonde
Dropsonde serial number. This serial number is defined by the sensor module serial number assigned by Vaisala. It must be a 9 digit integer number and must include leading 0s where applicable.

TelemetryType

IDValidatorAdded in VersionOriginator
4 ^[1-3]{1}$ 1 sonde
Dropsonde Telemetry message Type, currently 1, 2, or 3.

FactorySndFirmware

IDValidatorAdded in VersionOriginator
5 .* 1 sonde
Sonde micro-controller Firmware version, as recorded at the time of production

PtuSensorFirmware

IDValidatorAdded in VersionOriginator
6 .* 1 sonde
PTH Sensor module firmware version.

GpsSensorFirmware

IDValidatorAdded in VersionOriginator
7 .* 1 sonde
The output emitted by the GPS unit in response to a UBX::MON::VER request. It usually looks like "EXT CORE 3.0 (107900) HW: 0000080000" or similar

FactoryGPSInitMsg

IDValidatorAdded in VersionOriginator
8 .* 1 sonde
* Field not stored on sonde * Initial GPS Generated messages

DropFrequency

IDValidatorUnitsAdded in VersionOriginator
9 ^[\d]+.[\d]{3}$ MHz 1 sonde
Telemetry frequency chosen for drop. Data logging software is responsible for setting the frequency, but the change is reflected by the sonde.

GpsCuttoffAngle

IDValidatorUnitsAdded in VersionOriginator
10 ^[.\d]+$ ø 1 sonde
Cut off for the elevation of GPS transmitting satellites, which are being used by the GPS module. The default (of missing) is 5 degrees above the horizon.

SstFirmware

IDValidatorAdded in VersionOriginator
11 .* 1 sonde
* Field not stored on sonde * Version code of the in situ sea surface sensor.

GpsNavigationMode

IDValidatorAdded in VersionOriginator
12 .* 1 sonde
* Field not stored on sonde * GPS Navigation mode (0-8) per the GPS

TCheckDelta

IDValidatorUnitsAdded in VersionOriginator
13 .* °C 1 sonde
Measured temperature difference from temperature self check which is defined in sensor module Literature, is not well understood by NCAR, but yields useful information to the sensor manufacturer.

RHCheckDelta

IDValidatorUnitsAdded in VersionOriginator
14 ^1$ %RH 1 sonde
Humidity self check which is defined in sensor module Literature, is not well understood by NCAR, but yields useful information to the sensor manufacturer.

DropHeatingAlgorithm

IDValidatorAdded in VersionOriginator
15 ^[\d]+ 1 sonde
Heating algorithm for the RS41 humidity sensor (currently only one algorithm exists, others may come). Sensor module operates in either a "raw" or "cooked" modes. Raw means raw measurments that has not been corrected are emitted where the end user (data logging software) will need to manually apply corrections. Cooked means the PTU sensor module performs best guess corrections for the environment, and further corrections are not to be performed. The returned value have the following meanings:
-0: cooked, or pre-computed, RH values
-1: raw, or non-altered, RH values, and require more proceesing before actual air RH can be retrieved.

DropHeatingUsed

IDValidatorAdded in VersionOriginator
16 ^[\d]{1} 1 sonde
The sensor module's internal heater is either enabled or disabled. The output value has the following meanings - 0: RH heater is "off", or disabled - 1: RH heater is "on", or enabled

AppliedPressureOffset

IDValidatorAdded in VersionOriginator
17 .* 1 sonde
This is the applied offset in the sonde firmware to the value emitted by the pressure sensor. This transmitted (RF) value is defined such that
P_sensor + AppliedPressureOffset = P_transmitted
This value is stored in the sonde as an IEE754 float, and the sonde freely emits this as part of its metadata.

LastRegeneration

IDValidatorUnitsAdded in VersionOriginator
18 .* timestamp 1 sonde
Timestamp of last regeneration, given in YYYY-MM-DDTHH:mm format. This field should be set to "unknown" if not known.

LastRegenerationError

IDValidatorAdded in VersionOriginator
19 .* 1 sonde
Boolean flag indicating if there was an error on the most recent regeneration.
- 0 / false / False: should be understood that the most recent regeneration completed successfully.
- 1 / true / True: should be understood that the most recent regeneration encountered an error, or did not successfully complete.

PreDropPwrLvl

IDValidatorAdded in VersionOriginator
20 ^[\d]+$ 1 acs & sonde
RF Transmitter Power Level. Current dropsonde transmitters have been in the range of 0-63. Default is 63 or max power level. The data logging server may alter this per the requested user config. This is the value the sonde uses before launch is detected / set. The value is controlled by acs, but the sonde emits it as part of its metadata

RfPowerLvl

IDValidatorUnitsAdded in VersionOriginator
21 ^[\d]+.[\d]{3}$ dBm 1 sonde
The RF transmit power level of the sonde once it transistions to full run mode. Again, this is not the current power level, but the level once the sonde enters run mode. The current power level can be deduced if launch detect has occurred or not. This field is also recorded as part of the production process as the power level as it left the factory.

FactoryRfOffset

IDValidatorUnitsAdded in VersionOriginator
22 ^[\d]$ Hz 1 sonde
* Field not stored on sonde * Production adjusted frequency offset, in Hz, as measured at 403.00MHz

ShutoffDuration

IDValidatorAdded in VersionOriginator
23 ^[\d]+$ 1 sonde
Shutoff duration - how long the sonde will run, in frame counts, until self-terminating. 65536 / / missing means run until the battery dies.

BatteryVoltage

IDValidatorUnitsAdded in VersionOriginator
24 ^[\d]+.[\d]{3}$ Volts 1 sonde
Sonde reported battery voltage, captured at the time of detection in ACS.

NominalBatteryVoltage

IDValidatorUnitsAdded in VersionOriginator
25 ^[\d]+.[\d]{3}$ Volts 1 sonde
Sonde's self-reported ideal / nominal voltage. (eg 6V, 9V, etc)

FactoryRevisionCode

IDValidatorAdded in VersionOriginator
26 ^[a-zA-Z0-9]{2}$ 1 factory / snd
Sonde manufacturing Revision Control Code. Currently it consists of a letter and a number. This value is emitted by the sonde, but controlled by the factory.

LaunchDetectThreshold

IDValidatorAdded in VersionOriginator
27 ^[\d]{5}$ 1 sonde
Threshold for triggering launch detect, RD41 only.

LaunchDetectCount

IDValidatorAdded in VersionOriginator
28 ^[\d]{5}$ 1 sonde
Current value from the launch detect proximity sensor, RD41 only.

TransmitterPartNumber

IDValidatorAdded in VersionOriginator
29 ^[\d]{4}$ 1 sonde
Part number for transmitter RFIC. Currently either 4464 or 4463.

TransmitterRevision

IDValidatorAdded in VersionOriginator
30 ^[a-zA-Z0-9]+$ 1 sonde
Revision for transmitter RFIC. Differentiates B1B with C2A.

PICPartNumber

IDValidatorAdded in VersionOriginator
31 ^[a-zA-Z0-9]+$ 1 sonde
Part number for PIC microcontroller. Currently either PIC18F46K20 or PIC18F46K22.

ProductionDate

IDValidatorUnitsAdded in VersionOriginator
51 ^[\d]{9}T[\d]{3}Z$ timestamp 1 factory
Production date. The date is stored in RFC3339 UTC ISO 8601 date format, YYYYMMDDThhmmssZ

FactoryProductCode

IDValidatorAdded in VersionOriginator
52 .* 1 factory
Product code. Currently defined to be one of the following
RD94 - Vaisala produced large dropsonde,
NRD94 - NCAR Research Dropsonde (aka mini)
RD41 - Large form factor dropsonde with RSS941 module
NRD41 - Small form factor dropsonde with RS941 module

PtuSensorPartNumber

IDValidatorAdded in VersionOriginator
53 ^R[S]{1,2}[\d]{3}$ 1 factory
PTH Sensor module part number. Currently defined options are RSS904, RSS903, or RSS941.

GpsSensorPartNumber

IDValidatorAdded in VersionOriginator
54 .* 1 factory
GPS receiver manufacturer's Part Number.

FactoryCalPressAvg

IDValidatorUnitsAdded in VersionOriginator
55 ^[\d]+.[\d]+$ hPa 1 factory
Reference Calibration Pressure during production. Resolution should be 0.1 hPa.

FactoryCalPressCnt

IDValidatorAdded in VersionOriginator
56 ^[\d]+$ 1 factory
* Field not stored on sonde * Number of samples takes in the above average

FactoryCalPressStdDev

IDValidatorUnitsAdded in VersionOriginator
57 ^[\d]+.[\d]+$ hPa 1 factory
Standard Deviation of the pressure samples taken during the time of production

FactoryCalTempAvg

IDValidatorUnitsAdded in VersionOriginator
58 ^[\d]+.[\d]{3}$ °C 1 factory
Reference Calibration Temperature during production. Resolution should be 0.1 °C.

FactoryCalTempCnt

IDValidatorAdded in VersionOriginator
59 ^[\d]+$ 1 factory
* Field not stored on sonde * Number of Temperature samples taken during the time of production

FactoryCalTempStdDev

IDValidatorUnitsAdded in VersionOriginator
60 ^[\d]+.[\d]{3}$ °C 1 factory
Standard Deviation of the temperature samples taken during the time of production

FactoryCalRHAvg

IDValidatorUnitsAdded in VersionOriginator
61 ^[\d]+.[\d]{3}$ %RH 1 factory
Reference relative humidity during production. Resolution should be 1 %RH

FactoryCalRHCnt

IDValidatorAdded in VersionOriginator
62 ^[\d]+$ 1 factory
* Field not stored on sonde * Number of calibrated RH samples taken

FactoryCalRHStdDev

IDValidatorUnitsAdded in VersionOriginator
63 ^[\d]+.[\d]{3}$ %RH 1 factory
Standard Deviation of RH samples

FactorySndPressAvg

IDValidatorUnitsAdded in VersionOriginator
64 ^[\d]+.[\d]+$ hPa 1 factory
Sonde Calibration Pressure during production. Resolution should be 0.1 hPa. Samples should be free of checksum errors and are representative of over-the-air transmission.

FactorySndPressCnt

IDValidatorAdded in VersionOriginator
65 ^[\d]+$ 1 factory
* Field not stored on sonde * Count of samples in the average

FactorySndPressStdDev

IDValidatorUnitsAdded in VersionOriginator
66 ^[\d]+.[\d]+$ hPa 1 factory
Standard deviation of the error-free samples

FactorySndTempAvg

IDValidatorUnitsAdded in VersionOriginator
67 ^[\d]+.[\d]{3}$ °C 1 factory
Sonde Temperature during production. Resolution should be 0.1 °C. Samples should be free of checksum errors and are representative of over-the-air transmission.

FactorySndTempCnt

IDValidatorAdded in VersionOriginator
68 ^[\d]+$ 1 factory
* Field not stored on sonde * The number of samples taken to generate FactorySndTempAvg

FactorySndTempStdDev

IDValidatorUnitsAdded in VersionOriginator
69 ^[\d]+.[\d]{3}$ °C 1 factory
The standard deviation of the samples taken from the sonde.

FactorySndRHAvg

IDValidatorUnitsAdded in VersionOriginator
70 ^[\d]+.[\d]{3}$ %RH 1 factory
Sonde Calibration humidity during production. Resolution should be 1 %RH. Samples should be free of checksum errors and are representative of over-the-air transmission.

FactorySndRHCnt

IDValidatorAdded in VersionOriginator
71 ^[\d]+$ 1 factory
* Field not stored on sonde * The number of samples used to calculate FactorySndRHAvg

FactorySndRHStdDev

IDValidatorUnitsAdded in VersionOriginator
72 ^[\d]+.[\d]{3}$ %RH 1 factory
The standard deviation of the sonde's RH samples

FactoryVersion

IDValidatorAdded in VersionOriginator
73 .* 1 factory
Production software version tag

FactoryRfError

IDValidatorUnitsAdded in VersionOriginator
74 ^[\d]+.[\d]{3}$ Hz 1 factory
* Field not stored on sonde * Frequency error measured at 403.00MHz and defined as Freq_reference - Freq_sonde

FactoryRfDev

IDValidatorUnitsAdded in VersionOriginator
75 ^[\d]+.[\d]{3}$ kHZ 1 factory
* Field not stored on sonde * FM Deviation as measured during the production cycle, at 403.00MHz

FactoryRfERP

IDValidatorUnitsAdded in VersionOriginator
76 ^[\d]+.[\d]{3}$ dBm 1 factory
* Field not stored on sonde * Effective Resonated Power, as measured at the production facility, at 403.00MHz

ParachuteArea

IDValidatorUnitsAdded in VersionOriginator
77 ^[\d]+$ cm^2 1 factory
Surface area of the inverted pyramid parachute.

SondeWeight

IDValidatorUnitsAdded in VersionOriginator
78 ^[\d]+$ g 1 factory
Total sonde weight being launched.

SstPartNumber

IDValidatorAdded in VersionOriginator
79 .* 1 factory
* Field not stored on sonde * Manufacturer's part number of infrared sea surface sensor.

FactoryAddendum

IDValidatorAdded in VersionOriginator
80 .* 1 factory
Extra sensors or concise production-lot notes from time of production. Usually it is a string like "dev", "prototype" or "SSTv4" for additional sensors, experimental variants, or prototype runs. In normal production lots, this field should be empty / missing. Even for normal NCAR production runs, this should be empty.

FactoryName

IDValidatorAdded in VersionOriginator
81 .* 1 factory
* Field not stored on sonde * Common name of the producer, Vaisala, NCAR, Garage-Shop Ltd, etc

FactoryTTFF

IDValidatorUnitsAdded in VersionOriginator
82 ^[\d]+.[\d]{1}$ s 1 factory
* Field not stored on sonde * Time to First Fix during production.

FactoryGpsAntenna

IDValidatorAdded in VersionOriginator
83 .* 1 factory
* Field not stored on sonde * Identifying information for the GPS antenna - usually a model number, serial number, or similar

FactoryBatteryDateCode

IDValidatorAdded in VersionOriginator
84 .* 1 factory
* Field not stored on sonde * Battery's Datecode (in lieu of a serial number)

FactoryPcbMfg

IDValidatorAdded in VersionOriginator
85 .* 1 factory
* Field not stored on sonde * Manufacturer of the PCB

FactoryPCBDateCode

IDValidatorAdded in VersionOriginator
86 .* 1 factory
* Field not stored on sonde * Manufacturer's PCB Date Code

FactoryPcbRevision

IDValidatorAdded in VersionOriginator
87 .* 1 factory
* Field not stored on sonde * Controlled PCB revision. Ideally this is a version string that comes directly off the silkscreen that is maintained by version control packages, not the human named

FactoryComments

IDValidatorAdded in VersionOriginator
88 .* 1 factory
Any comments input by the factory floor personnel. Stripped of \| symbols.

SondeDetectionTime

IDValidatorUnitsAdded in VersionOriginator
89 .* timestamp 1 factory
Time when sonde was first detected and metadata extracted.

MetadataExtractionCmds

IDValidatorAdded in VersionOriginator
90 .* 1 factory
UUID of the command set used to extract metadata

DropUUID

IDValidatorAdded in VersionOriginator
91 .* 1 factory
UUID of soundings. All metadata and data associated with this sounding is tagged with this UUID

DropCreationDate

IDValidatorUnitsAdded in VersionOriginator
92 .* timestamp 1 factory
Creation time of sounding - timestamp when channel was started and data recording starts

DropEndDate

IDValidatorUnitsAdded in VersionOriginator
93 .* timestamp 1 factory
Final time when channel was closed.

DropCompleted

IDValidatorAdded in VersionOriginator
94 .* 1 factory
Should be true if the channel was closed successfully. If there was some serious errors and the data logger quit, this field would be missing

DropOperator

IDValidatorAdded in VersionOriginator
95 .* 1 factory
Operator responsible for launch (an email / username)

DropAddendum

IDValidatorAdded in VersionOriginator
96 .* 1 factory
DEPRECATED -- use OperatorComments instead.
Standard operator notes - Free form text that has been manually processed to remove any | symbols that may be present

DropBattery

IDValidatorUnitsAdded in VersionOriginator
97 .* V 2 factory
DEPRECATED -- use BatteryVoltage instead.
Self-reported battery voltage at time of detection. Queried via SRBV command in ACS.

DropSoftwareVersion

IDValidatorAdded in VersionOriginator
98 .* 1 factory
ACS or AVAPS Launch software version tag

DropLaunchDetect

IDValidatorUnitsAdded in VersionOriginator
99 .* timestamp 1 factory
Reported time when launch detect occurred This is not corrected for false launch detects

DropChannelDuration

IDValidatorUnitsAdded in VersionOriginator
100 .* s 1 factory
Number of seconds channel was active

DropTerminationCond

IDValidatorAdded in VersionOriginator
101 .* 1 factory
Reason sounding was terminated. Currently, possible options are:
ChannelStoppedMaxTime - Stopped because the channel was open for a maximal amount of time
ChannelStoppedSounding - Stopped after nominal amount of time for a sounding has occurred
ChannelStoppedNoData - No data after a defined timeout
ChannelStoppedDataReconnect - Stopped because daemon was unable to reconnect to the data stream
ChannelStoppedRcvrReconnect - Stopped because the low level hardware became unavailable
ChannelStoppedManual - Manually halted

ChannelType

IDValidatorAdded in VersionOriginator
102 .* 1 factory
Type of Channel responsible for recording data. Currently, only type "1" is implemented, which wraps around a MGAUS / 400MHz receiver. It is anticipated that type "2" will designate the planned SDR chassis.

ChannelSerialNumber

IDValidatorAdded in VersionOriginator
103 .* 1 factory
Serial number or identifier of receiver hardware

ChannelRxDial

IDValidatorAdded in VersionOriginator
104 .* 1 factory
Dial string (eg tcp://192.168.1.1:2000 or similar) used to connect to the Receiver

ChannelDmdDial

IDValidatorAdded in VersionOriginator
105 .* 1 factory
Dial string (eg tcp://192.168.1.1:2000 or similar) used to connect to the Demod stream

ChannelNumber

IDValidatorAdded in VersionOriginator
106 ^[\d]+$ 1 factory
Self-assigned channel number (N of M channels). One based counting system (1, 2, 3, ..., M)

ChannelTermMax

IDValidatorAdded in VersionOriginator
107 .* 1 factory
Maximal amount of time the channel would have stayed open. In units like "1h12m32s"

ChannelTermSounding

IDValidatorAdded in VersionOriginator
108 .* 1 factory
Maximal amount of time the channel would have run after launch detect had occurred

ChannelTermNoData

IDValidatorAdded in VersionOriginator
109 .* 1 factory
Maximal amount of time the channel would have stayed open with no data

ChannelTermRecon

IDValidatorAdded in VersionOriginator
110 .* 1 factory
Maximal amount of time the channel would have stayed open when unable to reconnect to underlying hardware

ChannelRSSIPeriod

IDValidatorAdded in VersionOriginator
111 .* 1 factory
How often was the RSSI info off the receiver gathered

ChannelDataPeriod

IDValidatorAdded in VersionOriginator
112 .* 1 factory
How often would data be pulled off the demodulator

ChannelConnPeriod

IDValidatorAdded in VersionOriginator
113 .* 1 factory
Duration to wait for initial setup connection to complete

DropStreamType

IDValidatorAdded in VersionOriginator
114 .* 1 factory
StreamType chosen at Time of Drop. Should match FactoryStreamType, but that is not always true

ChannelChassisType

IDValidatorAdded in VersionOriginator
115 .* 1 factory
ACS standard chassis configuration files identify a number of known chassis configurations, such as chassis used by NOAA and NCAR, chassis for small airframes, and green vs blue chassis which feature respectively a green or blue backplane PCB. This field is the name of the specific configuration that was used.

DropProject

IDValidatorAdded in VersionOriginator
116 .* 1 factory
Human named project, usually a well-known named funded project such as OLYMPEX or CONCORDIASI

DropMission

IDValidatorAdded in VersionOriginator
117 .* 1 factory
Human named flight: NCAR usually uses names like RF01, TF02, whereas NOAA and NASA use slight variations on this.

DropPlatform

IDValidatorAdded in VersionOriginator
118 .* 1 factory
Human Readable Name for the aircraft / airframe used. Usually items like "NCAR G-V" or "NOAA P3"

DropTailNumber

IDValidatorAdded in VersionOriginator
119 .* 1 factory
Registered Tail Number of the aircraft AVAPS is residing on.

DropLaunchObs

IDValidatorAdded in VersionOriginator
120 .* 1 factory
IWGADTS1 message at the time of drop. Should be altered by algorithms in case of late launch detect, or obvious delays in data messages.

DropPressureAddition

IDValidatorUnitsAdded in VersionOriginator
121 .* hPa 1 factory
Operator Supplied Pressure Delta. Defined as P_reference - P_sonde

DropActivateCommand

IDValidatorAdded in VersionOriginator
122 .* 1 factory
UUID of the command that was responsible for the activation sequence

DropLaunchCommand

IDValidatorAdded in VersionOriginator
123 .* 1 factory
UUID of command responsible for the launch sequence

SuggestedMinGpsSats

IDValidatorAdded in VersionOriginator
124 ^[\d]+$ 1 factory
Suggested number of GPS satellites to consider as nominative

SuggestedMinBattery

IDValidatorAdded in VersionOriginator
125 .* 1 factory
Suggested minimal battery voltage. Values below this should be considered suspect

GpsAidingUsed

IDValidatorAdded in VersionOriginator
126 .* 1 factory
Flag indicating automated upload of GPS aiding information. True indicates aiding was used. False indicates aiding was not used.

FramesRecorded

IDValidatorAdded in VersionOriginator
127 .* 1 factory
Total number of frames recorded by the channel

LaunchOperator

IDValidatorAdded in VersionOriginator
128 .* 1 factory
DEPRECATED -- use DropOperator instead.
User ID and email of the user responsible for launching the sonde

BinSondeFrom

IDValidatorAdded in VersionOriginator
129 ^[\d]+$ 1 factory
The bin the sonde originated from

GpsAidingCommands

IDValidatorAdded in VersionOriginator
130 .* 1 acs
The UUID which is tagged as the parent to any GPS Aiding information that has been sent to the sonde.

SuggestedOperatorOffset

IDValidatorAdded in VersionOriginator
131 .* 1 acs
This is the operator suggested pressure offset, defined as
??P_sensor + SuggestedOperatorOffset = P_transmitted??

DropHumanName

IDValidatorAdded in VersionOriginator
132 .* 1 acs
(Deprecated usage: DropHumanName is an autogenerated name for the sounding. The intent is that a string such as 'fuzzy-rodent' or 'lovely-apple' are easier names to refer to soundings than a proper UUID. There might be name collisions over time, but should not be over the course of a single or running ACS instance.) Current usage: Sonde serial number is used as the "name".

ConfirmedLaunchTime

IDValidatorUnitsAdded in VersionOriginator
133 .* timestamp 1 acs
This is the timestamp of the confirmed launch detect that has been checked by some algorithm during the QC process. If this time is different than the one given by DropLaunchDetect, it is due to a human correcting the launch time, or some software bit altering the launch time.

DropHitSurface

IDValidatorAdded in VersionOriginator
134 .* 1 acs
True or false flag that indicates if the sounding hit the surface

ObservationNumber

IDValidatorAdded in VersionOriginator
135 [1-9]+[0-9]* 1 operator
The relic refered to a 'obnumber' or observation number. This is a value that is assigned by a human operator, and it's exact meaning is totally uncontrolled, unvalidated, or otherwise used by ACS. The single constraint is that it is an integer greater than zero.

ObservationType

IDValidatorAdded in VersionOriginator
136 .* 1 operator
Much like ObservationNumber, this is a uncontrolled values used by some agencies. Its exact meaning and acceptable values is unknown to AVAPS infrastructure, but exists so that end users can use this as necessary.

OperatorComments

IDValidatorAdded in VersionOriginator
137 .* 1 operator
Freeform comment field to be utilized by ACS end users. The contents of this field are not controlled nor suggested. The end user can change or alter this field in any way that suits them.

SndifCardSerialNumber

IDValidatorAdded in VersionOriginator
138 .* 1 production
Serial number of the sonde interface card. Gets entered into the chassis during production.

AccountingCode

IDValidatorAdded in VersionOriginator
139 .* 1 operator
User-defined code for accounting purposes; e.g., funding entity, usage intent, etc.

MarkedAsDeleted

IDValidatorAdded in VersionOriginator
140 .* 1 operator
If this metadata field is present, the operator has indicated this sounding should be deleted. Training/test-dropping sondes is a typical use-case for why a sounding might be discarded.

MetadataString

IDValidatorAdded in VersionOriginator
141 .* 1 sonde
The raw metadata string, as returned from querying the individual metadata data-banks of the sonde and concatenating the results together. I.e., "1=1|2=1|3=190510743|4=3|5=03.06.0|6=00.01.10|9=404.200|7=SW:ROM CORE 3.01 (107888),HW: 00080000|...".

LastPacketLength

IDValidatorUnitsAdded in VersionOriginator
142 ^[\d]+$ bytes 1 acs & sonde
The length, in bytes, of the last packet received from a sounding.

ChannelFirmware

IDValidatorAdded in VersionOriginator
143 ^[\d]+$ 1 factory
Firmware version of the chassis receivers.