Skip to main content

LogFormat

Enum LogFormat 

Source
#[non_exhaustive]
pub enum LogFormat {
Show 48 variants PerfectFlitePf2, PerfectFliteCsv, PerfectFliteText, AltosCsv, RavenFipCsv, Rrc3Csv, EggtimerCsv, BlueRavenCsv, FeatherweightGpsCsv, Kml, Nmea0183, PerfectFlitePfa, EggtimerText, AltimeterCloudCsv, EntacoreAimCsv, SillyGooseText, FluctusCsv, Arts2Csv, AerospaceNuFcbCsv, AerospaceNuGroundStationText, PhoneLaunchCsv, EggtimerRtf, RavenFipa, Rrc3Rff, FeatherweightSummaryCsv, RdasText, AltosTelemetry, AltosEeprom, Arts2Odf, Arts2RawCsv, RtxRaw, RtxCsv, RtxText, GenericTable, BinaryRecords, ConsoleCapture, BlueRavenUsb, TeensyTabs, TeensyNamed, RadioPacketText, RadioPacketRtf, AltimaxXls, Marsa, AltosTelemetryCsv, AltimaxAls, EntacoreXtra, EntacoreDump, Gpx,
}
Expand description

A flight log’s file format.

Variants (Non-exhaustive)§

This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
§

PerfectFlitePf2

PerfectFlite’s .pf2, as its software writes a Pnut’s, a StratoLogger’s or a StratoLoggerCF’s flights.

§

PerfectFliteCsv

PerfectFlite’s comma-separated export: a header row such as Time, Altitude, Velocity, Temperature (F), Voltage, then rows in seconds and feet.

§

PerfectFliteText

PerfectFlite’s tab-separated text export: a header row such as Time Altitude Temp. Voltage, then rows in seconds and feet.

§

AltosCsv

AltOS’s CSV, as AltosUI exports a TeleMetrum’s, TeleMega’s, EasyMega’s or EasyMini’s flight: a #version,serial,flight,… header, then rows in SI.

§

RavenFipCsv

The Featherweight Raven’s FIP CSV, as the Featherweight Interface Program exports it: each channel its own Time@ column, its values, and a status column.

§

Rrc3Csv

Missile Works’ mDACS export of an RRC3’s flight: a header row Time, Altitude, Pressure, Velocity, Temperature, Events, Voltages, then rows on one clock.

§

EggtimerCsv

An Eggtimer’s flight data, as its own download writes it: a header row such as T, Alt, VRaw, VFilt, then rows on one clock.

§

BlueRavenCsv

The Featherweight Blue Raven’s CSV, as its phone app exports a flight: a low-rate file of its barometric and inertial figures, or a high-rate file of its inertial sensors, each with a header row such as Year,Month,Day,Time,Flight_Time_(s),….

§

FeatherweightGpsCsv

A Featherweight GPS tracker’s CSV, as its ground station’s app or software writes it: the tracker’s log, with a header row such as UTCTIME,UNIXTIME,ALT,LAT,LON,#SATS,…, or the ground station’s, such as TRACKER,DATE,TIME,LAT,LON,ALT,…. Positions only, no barometer.

§

Kml

A KML file (OGC 07-147r2) holding a GPS track as a path or a gx:Track, as AltOS, Missile Works’ RTx, Big Red Bee’s BeeLine, fw2kml and others write it. Positions only.

§

Nmea0183

A GPS receiver’s NMEA 0183 sentences as it wrote them, such as $GPGGA,…*hh. Positions only.

§

PerfectFlitePfa

PerfectFlite’s older .pfa, as its software saves an Alt15K/WD’s flight: Ground:, Apogee: and NumSamps: lines, then **!!Data: and one altitude a line.

§

EggtimerText

An Eggtimer TRS’s flight as its terminal download prints it: the flight settings and the flight summary, then the table the CSV download writes.

§

AltimeterCloudCsv

AltimeterCloud’s CSV of a Rocketry Ltd Nano V1’s or Mercury’s flight, as a flight page on altimetercloud.com hands it back: a header row such as Time(ms),Altitude(m),….

§

EntacoreAimCsv

Entacore AIM’s CSV, as its software exports a flight: each channel beside its own time column.

§

SillyGooseText

AerospaceNU’s SillyGoose flight computer’s log, as the board writes it: tab-separated text under a header such as timestampMs pressurePa tempK ….

§

FluctusCsv

Silicdyne’s Fluctus flight computer’s CSV: a sep=; line, then a semicolon-separated table whose names carry their units, such as time (ms);baro-altitude (m);….

§

Arts2Csv

Ozark Aerospace’s ARTS2 interpreted data: a # MET Acc Vel iAlt pAlt header, then comma-separated rows from launch.

§

AerospaceNuFcbCsv

AerospaceNU’s flight computer board’s CSV, as the club’s tools write a flight: a header row opening ,packetType,timestamp_ms,… or ,timestamp_s,…, then one row a sample.

§

AerospaceNuGroundStationText

AerospaceNU’s ground station’s text, as it parses the flight computer board’s downlink: a RUN START line, then one packet a line, HH:MM:SS.ffffff: <packet> {…}.

§

PhoneLaunchCsv

A phone app’s launch….csv: a header row opening Seconds,Timestamp,AltitudeMSLGPS,…, then one row a sample. The app isn’t named in its files.

§

EggtimerRtf

An Eggtimer TRS’s terminal download, as LogFormat::EggtimerText reads it, saved inside an RTF document.

§

RavenFipa

The Featherweight Raven’s raw download, .FIPa, as the Featherweight Interface Program saves the altimeter’s memory: a text header, then checksummed binary frames.

§

Rrc3Rff

Missile Works’ RRC3 raw flight file, .rff, as mDACS saves a download: a .NET BinaryFormatter stream holding the altimeter’s 16-bit words.

§

FeatherweightSummaryCsv

A Featherweight summary, as the Featherweight UI app exports a Blue Raven’s or a GPS tracker’s flight beside its data: one name,value row a figure, such as Max Altitude,2500.25 feet, and no samples.

§

RdasText

AED Electronics’ R-DAS raw data, as its Windows software exports a flight to text: a *** Configuration *** section, then a table of the converters’ counts.

§

AltosTelemetry

AltOS radio telemetry, as AltosUI saves the packets a TeleDongle hears to a .telem file: one TELEM line a packet, its bytes in hexadecimal.

§

AltosEeprom

AltOS’s raw flight download, as AltosUI saves a flight computer’s memory to an .eeprom file: a JSON object of the board’s configuration then the memory in hexadecimal, or, from older versions, the configuration as the board prints it then one record a line.

§

Arts2Odf

Ozark Aerospace ARTS2’s flight as its PC software saves it to an .odf file: the board’s settings and calibration, then the sensors’ counts.

§

Arts2RawCsv

Ozark Aerospace ARTS2’s raw data, as its PC software exports a flight: a MET,Acc(HI),Acc/Baro(LO),Baro(HI),State header, then the sensors’ counts.

§

RtxRaw

Missile Works’ RTx/GPS tracker’s fixes, as mDACS saves a download to an .rtx file: a .NET BinaryFormatter stream of one List<Int32>, each slot a 16-bit word mapped modulo 10⁹. Positions only.

§

RtxCsv

The RTx’s fixes as mDACS exports them to CSV: a UTC Time,Latitude,Longitude,Altitude,… header, then one row a fix. Positions only.

§

RtxText

The RTx’s fixes as mDACS exports them to text: a tab-separated UTC Lat Lon Alt … header, then one row a fix. Positions only.

§

GenericTable

A table of samples from a logger no other reader knows, read by what its header states: a header row naming the columns, the units in the names, such as Time (s),Alt AGL (ft), then one row a sample (crate::generic); or read by a column mapping the caller gives.

§

BinaryRecords

A file of binary records end to end, each a run of fields, read by a layout the caller states, since the file states none (crate::records).

§

ConsoleCapture

A serial console’s capture of a flight computer’s shell, its memory dumped as base64 between marker lines such as ----++++//[[( data start )]]\\++++----, each block’s records read by a layout the caller states (crate::capture).

§

BlueRavenUsb

The Featherweight Blue Raven’s flight data as its USB port downloads it to a serial terminal: one @ LOG_LOW or @ LOG_HIR line a sample, each closed by a CRC (crate::blueraven_usb).

§

TeensyTabs

A course’s Teensy data logger, tab-separated: a sensor’s tag, the clock in microseconds, then its values, such as Alt, the clock, P and a pressure, MSL and an altitude (crate::teensy).

§

TeensyNamed

A course’s Teensy data logger with named fields: units lines such as MS5 data in us, deg C, Pa, then lines such as MS5, t, 1330004120, T, 32.90, P, 92185 (crate::teensy).

§

RadioPacketText

One team’s radio telemetry packets as text, one 255:…:254 packet a line, such as 255:T:11:PP:100150:950.12:21.50:3.25:254: the flight computer’s own log, or what a receiver heard (crate::packets).

§

RadioPacketRtf

The same packets in an RTF document a spreadsheet saved as CSV, one 255,…,254 packet a line (crate::packets::read_rtf).

§

AltimaxXls

Rocketronics’ AltiMAX, a flight as its PC software exports it to an .xls worksheet (crate::xls), read as a table headed TIME,PRESS FILTER [hpa],HEIGHT FILTER [m],… (crate::altimax).

§

Marsa

A MARSA altimeter’s flight download: its settings as <NAME> value lines, such as <BARO_ZERO 0> 790, then a row a sample of the time, the altitude in feet and the acceleration in g, such as 0.1,-29.0,8.65; the .dat the altimeter’s software saves, or a spreadsheet’s re-save of it (crate::marsa).

§

AltosTelemetryCsv

AltOS’s radio telemetry decoded to a table, one row a packet under a header of the packet’s fields, serial,tick,ptype,state,…,height,crc (crate::altos_telem_csv).

§

AltimaxAls

Rocketronics’ AltiMAX, a flight’s .ALS file: a header, then a record of 22 bytes a sample, its pressures, acceleration, event and one voltage channel’s count (crate::altimax_als).

§

EntacoreXtra

Entacore AIM XTRA, a flight as its software saves it to an .xtra file, a Boost binary archive of one record a sensor group’s sample (crate::entacore_raw).

§

EntacoreDump

Entacore AIM XTRA, one recording of its memory as its software downloads it, raw: a type byte and big-endian fields a record, between bytes that count the clock’s ticks (crate::entacore_raw::read_dump).

§

Gpx

A GPX file, the GPS Exchange Format, version 1.0 or 1.1 as Topografix publishes it: its tracks’ points, each segment a GPS track (crate::gpx). Positions only.

Implementations§

Source§

impl LogFormat

Source

pub fn altitude_resolution_m(self) -> f64

The altitude’s resolution in the format, m: the smallest step between two altitudes the file can tell apart near the ground. A PerfectFlite and an Eggtimer write whole feet, an Alt15K/WD’s .pfa too, though that sensor’s own resolution is 4 ft at sea level (Alt15K/WD User’s Manual, p. 10): the step the file writes is taken, not the coarser one, so that a tolerance built on it stays tight; AltOS and Entacore AIM write their pressure in whole pascals, 0.083 m of altitude at sea level; AltimeterCloud writes its altitude to the millimeter, and it steps by that, a SillyGoose to the centimeter, a Fluctus to the whole meter, and an ARTS2’s barometric altitude moves by its barometer’s count, 8.8 m at most near the ground among the sample files; AerospaceNU’s flight computer board reads whole pascals, 0.083 m near sea level, in its CSV and in its ground station’s text, where its altitude is a filtered estimate with no step of its own; a phone app’s launch CSV writes its pressure as a 32-bit float, in steps of 2⁻¹⁴ hPa between 512 and 1,024 hPa, 0.000 51 m at sea level: the barometer’s step, as its barometric altitude, the track, is written in finer steps of its own, as small as 0.25 mm; the Raven’s pressure moves in steps of 4 × 10⁻⁵ atm, 0.337 m at sea level, the Blue Raven’s in steps of 2 × 10⁻⁵ atm, 0.169 m, and an RRC3’s export in steps of 0.1 hPa, 0.832 m. Aloft, those from a pressure are larger. A GPS log has no barometric altitude; its formats give the coarsest step its GNSS altitude is written in among the sample files: whole feet in Featherweight’s older tracker log, whole meters in Missile Works’ and Big Red Bee’s KML, and a tenth of a meter in NMEA’s GGA. A receiver’s own error is far larger. A Featherweight summary has no track: its maximum altitude is written to the hundredth of a foot. An R-DAS’s raw text has no altitude either, only its barometer’s counts: one is 0.09 kPa in its maker’s manual, 7.49 m near sea level. AltOS’s telemetry sends the board’s height above the pad in whole meters. An AltOS .eeprom file holds no altitude either: its coarsest pressure is a TeleMetrum v1’s, whose counts move by 4 in the sample files, 13.6 Pa, 1.13 m near sea level. Nor does an ARTS2’s .odf or raw CSV: its barometer’s count is 92.2 Pa, 7.68 m near sea level. Missile Works’ RTx writes its GPS altitude in whole meters in its .rtx file and in whole feet in its exports. A GPX file writes its elevation as a decimal of any length, and no sample log is one to show a step: 0. A table read by its header has no track, and no step: 0; nor do binary records read by a stated layout, or a console capture’s, which are read as such a table. A Blue Raven’s USB download has no track either, and its pressure is written in the CSV’s steps, 1/50,000 atm: the CSV’s step. Nor does a Teensy data logger’s file, whose pressure is written in whole pascals: 1 Pa, 0.083 m near sea level. Nor do the radio packets, whose pressure is written to 0.01 hPa, 1 Pa. An AltiMAX’s raw height follows its raw pressure, written in whole pascals: 1 Pa, 0.083 m near sea level. A MARSA writes its altitude to a tenth of a foot, but it moves by its barometer’s count, 29.3 ft (8.93 m) at most within 300 ft of the pad among the sample files. AltOS’s telemetry decoded to a table keeps the packet’s whole meters of height. An AltiMAX’s .ALS file and Entacore AIM’s .xtra and raw dump hold no altitude, only pressures in whole pascals: 1 Pa, 0.083 m near sea level.

Source

pub fn extension(self) -> &'static str

The format’s usual file extension, with its dot.

Source

pub fn name(self) -> &'static str

The format’s name for people, such as AltOS CSV.

Trait Implementations§

Source§

impl Clone for LogFormat

Source§

fn clone(&self) -> LogFormat

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Copy for LogFormat

Source§

impl Debug for LogFormat

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for LogFormat

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Eq for LogFormat

Source§

impl JsonSchema for LogFormat

Source§

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema. Read more
Source§

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type. Read more
Source§

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type. Read more
Source§

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword. Read more
Source§

impl PartialEq for LogFormat

Source§

fn eq(&self, other: &LogFormat) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Serialize for LogFormat

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl StructuralPartialEq for LogFormat

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.