https://github.com/dronedeploy/flight-log-parser
JavaScript library for parsing DroneDeploy flight logs
https://github.com/dronedeploy/flight-log-parser
dronedeploy owner-flight tier3
Last synced: 5 months ago
JSON representation
JavaScript library for parsing DroneDeploy flight logs
- Host: GitHub
- URL: https://github.com/dronedeploy/flight-log-parser
- Owner: dronedeploy
- License: mit
- Created: 2018-05-19T01:27:06.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2025-08-06T18:17:47.000Z (10 months ago)
- Last Synced: 2025-10-13T02:26:30.696Z (8 months ago)
- Topics: dronedeploy, owner-flight, tier3
- Language: TypeScript
- Homepage: https://www.dronedeploy.com
- Size: 23.6 MB
- Stars: 6
- Watchers: 55
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Flight log parser
Flight log parser is a JavaScript library for parsing [DroneDeploy flight logs](https://support.dronedeploy.com/docs/gathering-flight-logs).
## Installation
```bash
$ npm install @dronedeploy/flight-log-parser
```
## How to use
To use the DroneDeploy flight log parser, include it as normal:
```js
const { parseLog } = require ('@dronedeploy/flight-log-parser');
```
##### Example file:
```js
const { promisify } = require('util');
const fs = require('fs');
const path = require('path');
const { parseLog } = require ('@dronedeploy/flight-log-parser');
const readFileAsync = promisify(fs.readFile);
const filePath = path.join(__dirname, 'YOUR_LOG_FILE_PATH');
readFileAsync(filePath, {encoding: 'utf8'})
.then((text) => {
// parseLog() returns a FlightLog object
const parsedFlightLog = parseLog(text);
})
.catch((err) => {
console.log('ERROR:', err);
});
```
You can run the provided example file by:
```bash
$ node dist/__example__/index.js
```
### Function method
The `parseLog` method of `Flight log parser` takes in a `String` that is generated from a DroneDeploy flight log and it returns a `FlightLog` object.
### Type objects
##### FlightLog
`FlightLog` object separates a flight log to two parts: `metaData` and `rows`.
```js
// Type definitions
FlightLog = {
metaData: FlightLogMetaData;
rows: FlightLogRow[];
}
```
##### FlightLogMetaData
`FlightLogMetaData` groups related information from the log file to subcategories: appVersion, device, aircraft, battery ...
```js
FlightLogMetaData = {
appVersion: string;
session: {
id: string;
start: Date;
end: Date,
elapsed: number;
};
device: {
model: string;
os: string;
platform: string;
};
aircraft: {
model: string;
name: string;
firmware: string;
};
battery: {
cells: number;
chargeVolume: number;
discharges: number;
remainingLifePercent: number;
firmware: string;
serialNumber: string;
};
flightController: {
serialNumber: string;
firmware: string;
};
gimbal: {
firmware: string;
};
remoteController: {
serialNumber: string;
firmware: string;
};
camera: {
serialNumber: string;
};
user: {
userId: string;
organizationId: string;
};
};
```
##### FlightLogRow
DJI flight log creates a row of current flight info at every 0.1s. `FlightLogRow` is an array that contains all the rows DJI flight log created.
If you want to retrieve information at 10s after the drone took off, you can do so by asking for the row at index 100.
```js
readFileAsync(filePath, {encoding: 'utf8'})
.then((text) => {
const parsedFlightLog = parseLog(text);
const log10sAfterTookOff = parsedFlightLog.rows[100];
})
```
##### FlightLogHeader
`FlightLogHeader` is an enum object that contains all the column names of a row.
For example :
```js
enum FlightLogHeader {
DateTime = 'Date/Time (UTC)',
ElapsedTime = 'Elapsed Time (sec)',
Info = 'Info',
DeviceLatitude = 'Device Latitude (Degrees)',
DeviceLongitude = 'Device Longitude (Degrees)',
DeviceLocationLastUpdated = 'Device Location Last Updated (ms)',
AircraftBatteryPowerPercent = 'Aircraft Battery Power (%)',
AircraftBatteryCharge = 'Aircraft Battery Charge (mAh)',
AircraftBatteryCurrent = 'Aircraft Battery Current (mA)',
AircraftBatteryVoltage = 'Aircraft Battery Voltage (mV)',
...
}
```
##### Example output
```js
{
metaData : {
appVersion: '2.75.0',
session:
{ id: '12345678',
start: 2018-06-05T05:29:00.000Z,
end: 2018-06-05T05:31:40.000Z,
elapsed: 160.408 },
device: { model: 'iPhone', os: 'iOS 11.4', platform: 'iOS' },
aircraft:
{ model: 'Inspire 1 Pro',
name: 'inspire pro',
firmware: '1.11.01.50' },
battery:
{ chargeVolume: 4287,
remainingLifePercent: 83,
discharges: 69,
cells: 6,
firmware: '03.09.00.00',
serialNumber: '12345678' },
flightController: { serialNumber: 'N/A', firmware: '02.04.20.50' },
gimbal: { firmware: '01.31.01.67' },
remoteController: { serialNumber: '12345678', firmware: '1.2.0.17' },
camera: { serialNumber: 'N/A' },
user: { userId: '5fac2b9256338b4d7fd43852', organizationId: '5fac2c0dd27ea76caff42e9f' }
},
rows: [
{ 'Date/Time (GMT)': '06/04/2018 20:32:36',
'Elapsed Time (sec)': 6.675,
Info: "[{'message': 'Mission did take off'}]",
'Aircraft Battery Power (%)': 95,
'Aircraft Battery Charge (mAh)': 3944,
'Aircraft Battery Current (mA)': -13688,
'Aircraft Battery Voltage (mV)': 23736,
'Aircraft Battery Temperature (Fahrenheit)': 26,
'Aircraft Battery Last Updated (ms)': '999',
'Aircraft Battery Cell 1 Voltage (mV)': '',
'Aircraft Battery Cell 2 Voltage (mV)': '',
'Aircraft Battery Cell 3 Voltage (mV)': '',
'Aircraft Battery Cell 4 Voltage (mV)': '',
'Aircraft Battery Cell 5 Voltage (mV)': '',
'Aircraft Battery Cell 6 Voltage (mV)': '',
'Aircraft Latitude (Degrees)': 37.771803179308414,
'Aircraft Longitude (Degrees)': -122.40742532970359,
'Aircraft Barometric Altitude (ft)': 6.599999904632568,
'Aircraft Heading (Degrees)': 48.6,
'Aircraft Pitch (Degrees)': -1.3,
'Aircraft Roll (Degrees)': -16.4,
'Aircraft Satellites': 14,
'Aircraft Motors On': true,
'Aircraft Flying': true,
'Aircraft Flight Mode': 'NAVI',
'Aircraft Flight Mode Value': 14,
'Aircraft IMU Preheating': false,
'Aircraft Ultrasonic On': true,
'Aircraft Ultrasonic Altitude (ft)': 6.5,
'Aircraft Vision On': false,
'Aircraft GPS Signal': 'Very strong',
'Aircraft GPS Signal Value': 5,
'Aircraft No-Fly': 'null',
'Aircraft No-Fly Value': '0',
'Aircraft No-fly Latitude (Degrees)': 0,
'Aircraft No-fly Longitude (Degrees)': 0,
'Aircraft No-fly Radius (ft)': 0,
'Home Latitude (Degrees)': 37.77181085673832,
'Home Longitude (Degrees)': -122.4074317468288,
'Aircraft Smart Go-home Flight Time Remaining (sec)': 0,
'Aircraft Smart Go-home Flight Return Time (sec)': 0,
'Aircraft Smart Go-home Landing Time (sec)': 0,
'Aircraft Smart Go-home Return Power (%)': 0,
'Aircraft Smart Go-home Landing Power (%)': NaN,
'Aircraft Smart Go-home Radius (ft)': 0,
'Aircraft Smart Go-home Countdown (sec)': 0,
'Aircraft Smart Go-home State': 'IDLE',
'Aircraft System State Last Updated (ms)': '101',
'Gimbal Pitch (Degrees)': -89.0999984741211,
'Gimbal Roll (Degrees)': 0,
'Gimbal Yaw (Degrees)': 47.79999923706055,
'Gimbal Mode': 'YawFollowMode',
'Gimbal Mode Value': 2,
'Gimbal Pitch at Stop': 0,
'Gimbal Roll at Stop': 0,
'Gimbal Yaw at Stop': 0,
'Gimbal State Last Updated (ms)': '101',
'Landing Gear is Movable': true,
'Landing Gear Status': 'Retracting',
'Landing Gear Status Value': 4,
'Landing Gear Mode': 'Auto',
'Landing Gear Mode Value': 1,
'RC State': 'null',
'RC State Value': 0,
'RC Left Horizontal': true,
'RC Left Vertical': true,
'RC Right Horizontal': true,
'RC Right Vertical': true,
'RC Left Wheel': '0',
'RC Right Wheel': '0',
'RC Landing Gear': 'Not present',
'RC Landing Gear Value': 254,
'RC Go Home': false,
'RC Record': '0',
'RC Shutter': false,
'RC Playback': false,
'RC Pause': false,
'RC Custom 1': false,
'RC Custom 2': false,
'RC State Last Updated (ms)': '0',
'RC Battery (%)': 0,
'RC Satellites': '0',
'RC Horizontal Accuracy (ft)': '0.0',
'RC Latitude (Degrees)': 0,
'RC Longitude (Degrees)': 0,
'RC GPS Last Updated (ms)': '0',
'RC Signal 1 (%)': '-41',
'RC Signal 2 (%)': '-42',
'RC Signal Last Updated (ms)': '100',
'LB Signal 1 (%)': '-41',
'LB Signal 2 (%)': '-42',
'LB Signal Last Updated (ms)': '100',
'Aircraft Camera Mode': 'null',
'Aircraft Camera Mode Value': 0,
'Aircraft Camera Overheated': false,
'Aircraft Camera Sensor Error': false,
'Aircraft Camera Recording': false,
'Aircraft Camera Raw Capture': false,
'Aircraft Camera Interval Capture': false,
'Aircraft Camera Burst Capture': false,
'Aircraft Camera Single Capture': false,
'Aircraft Camera Storing Photo': false,
'Aircraft Camera SD Card Exists': true,
'Aircraft Camera SD Card Remaining (%)': 0,
'Aircraft Camera Lens Installed': false,
'Aircraft Camera Lens Type': '0',
'Aircraft Camera Lens Type Value': '0',
'Aircraft Camera Lens AF Enabled': false,
'Aircraft Camera Lens Focus Mode': 'N/A',
'Aircraft Camera Lens Focus Mode Value': 0,
'Aircraft Camera Lens Focus Status': 'N/A',
'Aircraft Camera Lens Focus Status Value': 0,
'Aircraft Camera Lens MF Assistant': false,
'Aircraft Camera Lens AF Assistant': false,
'Aircraft Camera Lens Assistant Working': false,
'Device > Aircraft Distance - XY (ft)': 0,
'Aircraft Vel - X': '0.670820415019989',
'Aircraft Vel - Y': '-0.6000000238418579',
'Aircraft Vel - Z': '0.30000001192092896',
'Aircraft Speed (mph)': -4.300000190734863 },
...
]
}
```
## Contributing
1. **Fork** the repo on GitHub
2. **Clone** the project to your own machine
3. **Run the repo**
```bash
$ npm install
$ npm run build
```
4. **Run tests**
```bash
$ npm run test
```
5. **Commit and Push** changes to your own branch
5. Submit a **Pull request** so that we can review your changes
License
-------
The code is available under the terms of the [MIT License](http://opensource.org/licenses/MIT).