AirData to Google Flight Converter Instructions BETA!!! Litchi Mission Utilities Logo

Instructions

This application will convert a CSV file from AirData into a Google KML file containing a virtual flight corresponding to the AirData mission.

  1. Synchronize your flight log to AirData
    1. Fly your drone.
    2. Synchronize your flight log to AirData.
      1. AirData provides well-written help files describing this process.
    3. Select your flight in the list on the left side of the AirData dashboard.
    4. Select "CSV" under the map of your flight. Save the CSV file to your computer.
  2. In page one of AirData to Google Flight Converter:
    1. Extraction Method: Select the type of data extraction desired:
      • Video only: This type of extraction will detect where any video was recorded and extract waypoints from that section of the log file.
      • Waypoint regions only: This type of extraction will detect where any waypoint path was flown and extract waypoints from that section of the log file.
      • Minimum Distance: This type of extraction will extract waypoints from the entire log file.
    2. Drone: Select the drone type used to fly the mission. Selecting the correct drone will allow the field of view (FOV) to be set appropriately in Google Earth Pro.
    3. Min dist between samples: Select the minimum distance between waypoints. A log file contains data from every few milliseconds of a flight. This is a lot of data. Because waypoint missions do not require waypoints to be extremely close together, this option is used to specify an approximate spacing between them. While lower values may produce more accurate results, higher values are sufficient for this type of simulation.
    4. Distance from Home to WP1: The flight log begins as soon as the drone motors are started (which is usually where the home point is also set). Choose the horizontal distance from the home point where the first waypoint is to be extracted.
    5. Mission Speed: Specify the speed at which the virtual flight is to be executed.
    6. Initial "FlyTo" duration: This is the duration (in seconds) from the current view in Google Earth Pro to the start of the mission. For a simple visual representation of the mission a small value is fine. If the virtual flight is to be captured into a video, a longer duration might be desired.
    7. Apply smoothing: Normally, headings and gimbal pitch angles are taken directly from the flight log. Sometimes, this can result in slightly abrupt changes in the virtual flight. This option can be used to apply a smoothing filter to those angles.
    8. Extend path to ground: The flight path is always drawn. This option visually extends the flight path to the ground. This can also be toggled on and off within Google Earth Pro.
    9. Use the file chooser to upload your CSV file.
    10. Generate the virtual mission and review the resulting parameters.
  3. In page two of AirData to Google Flight Converter:
    1. Review the parameters and calculations.
    2. Download the KML file. Depending on your computer settings, it may directly open the file in Google Earth Pro.
  4. In Google Earth Pro:
    1. The virtual mission will appear in the "Place" window pane to the left.
    2. Double-click on "Virtual Mission" to execute the mission.
    3. Optionally record the virtual mission:
      1. Adjust the current view as desired.
      2. Uncheck the "Flight Path" (optional).
      3. Select Tools -> Movie Maker
      4. Make sure the desired virtual mission is selected.
      5. Choose a location to save the movie file.
      6. Select the desired video parameters.
      7. Select "Create Movie".
A Google Earth Pro screen capture showing a waypoint mission
Google Flight

This utility converts a flight log into a virtual mission that can be viewed as a simulation in Google Earth Pro.

Getting Started

To create a virtual mission, you will need a flight log from the flight you want to recreate. The application supports the following flight log formats:

  • AirData CSV download: If you already sync your flights with AirData, open the desired flight in AirData and download the flight log in CSV format.
  • PhantomHelp CSV download: If you do not use AirData, you can upload a DJI flight log (FlightRecord*.txt) to PhantomHelp's DJI Flight Log Viewer. After processing the log, download the resulting CSV file, which is typically provided as a ZIP file. You can upload that ZIP file directly to this application without extracting the CSV file from it. Keeping the file zipped allows larger flight logs to be uploaded.
  • Litchi flight log: Litchi flight logs and Litchi SDK logs in CSV format are supported.

Uses of a Virtual Mission

A virtual mission provides several ways to review and recreate a previously flown flight. Two primary applications are:

  • Visual Analysis: Review and analyze a previously flown mission from a computer, with the recorded flight path displayed in a three-dimensional environment.
  • Video Integration: Synchronize video footage from a completed flight with a simulated version of the same flight in Google Earth Pro. This can be useful for presentations, flight reviews, and cinematic effects. [Example]

Simulation Options

The software includes multiple data extraction options to focus the simulation on specific segments of a flight. A drone type selection feature ensures that the simulated field of view (FOV) matches the original recording. Additionally, the "Initial FlyTo Duration" setting can be adjusted to create a slower, more cinematic introduction to the converted mission.

Extraction Method:
Drone:
Min dist between samples:
feet/meters
Distance from Home to WP1:
feet/meters
Mission Speed:
m/s
Initial "FlyTo" duration:
s
Apply smoothing:
Extend path to ground:
CSV File Upload:
Litchi Utilities dot Com
by Wes Barris