data.segmentation.get
data.segmentation.get is the interface to retrieve station segmentation. data.segmentation.get takes a specification of the archives desired and the start and end times. It will retrieve all comments affecting that time period (including ones that may originate or end outside of it). A segment consists of a type (“flight” for example) and data (“20000 feet”).
Command Line Usage
data.segmentation.get [--time-yeardoy] [--time-iso] [station] start end [types]
Arguments
start and end
The time specifiers for the data to be retrieved. Start is inclusive while end is exclusive, so all segments intersecting within the half open interval [start,end) will be returned. Any convertible time format is accepted. Additionally either or both can be “none” to denote positive or negative infinity (all time up until or after).
station
The station identifier code. For example 'brw'. Case insensitive.
types
List of types to get segments for, defaulting to all types. Multiple archives types may be separated by ”,”, ”;” or ”:”. Note that this is a single argument and that spaces are not allowed.
--time-yeardoy
Output times in Year:DOY format.
--time-iso
Output times in ISO 8601 format.
Output
All output is to standard output. The format is a series of comma separated lines, each representing a single segment.
start,end,type,data
start and end
The start and end of this segment in epoch time. If the field is null (zero length), then that parameter does not apply, so a null start with a valid end indicates all data up until (but excluding) the end time. Likewise a null end but a defined start is all data including and after the start. Both being defined is the half-open interval of time [start,end). Both null defines all time.
type
Segment type.
data
Segment data, interpretation depends on the segment type.
Example Usage
All flight segments for a given time
data.segmentation.get aao 2008:10 2008:20 flight
All segments before a given time
data.segmentation.get sgp none 2008:20