360° Panorama Mission Creator Instructions BETA!!! Litchi Mission Utilities Logo

Instructions

This application will convert a series of Litchi waypoints Litchi mission CSV file containing the instructions to generate 360° panoramas centered on those Litchi waypoints.

  1. Create one or more waypoints using Litchi's Mission Hub
    1. Specify an appropriate height for each of the waypoints.
    2. Export these waypoints as a CSV file.
  2. In page one of 360 Panorama Creator:
    1. Select the drone type that will be used to fly the mission. Each drone has a different field of view (FOV). This value is necessary in order to determine the number of photos required.
    2. Litchi is able to store and execute up to 15 camera actions per waypoint. DJI Fly is not able to do the same. If it will be desired to convert this partial panorama mission to a DJI Fly mission, select the "Enable DJI Fly Compatibility" checkbox. This will create more waypoints, but will make the mission flyable with DJI Fly.
    3. Select the desired horizontal and vertical image overlaps.
    4. Select the CSV file containing the waypoints from Litchi's Mission Hub.
    5. Select the "Generate 360 Panorama Waypoint Mission for Litchi" button.
  3. In page two of 360 Panorama Creator:
    1. Review the parameters and calculations.
    2. Based on the type of drone and the minimum overlaps requested, both the headings and gimbal pitch angles will be computed to capture the 360° panorama component photos. The actual overlaps (which are generally greater than the minimums requested) will be computed. Review these headings and angles.
    3. Download the Litchi csv file.
  4. Optionally, download the kml preview file for Google Earth Pro. This will allow one to preview each of the 360° panorama component photo views in Google Earth Pro.
  5. In Litchi's Mission Hub:
    1. Use the Missions menu to import the csv file created by 360° Panorama Creator.
    2. The imported mission will have a cluster of "dummy" waypoints around each photo-capture waypoint as shown in the image below.

      Panorama Mission Snapshot

      The component photos must be captured within the following constraints:
      • A maximum of 15 camera actions can be defined at each waypoint.
      • The "Tilt Camera" camera action does not accept positive pitch angles.
      • Sequential waypoints must be separated by at least 0.6 meters.
      As a result, there will be several "dummy" waypoints around each photo-capture waypoint location.
    3. IMPORTANT: Configure the following mission parameters:
      • Mission Settings: Heading Mode: Custom (WD)
      • Mission Settings: Path Mode: Straight Lines
      • Mission Settings: Cruising Speed: ~10mph (16km/h)
      • Litchi App Settings: Gimbal Extension (+30°): On (NOTE: This setting defaults to "Off" every time you start the Litchi app with some drones.)
    4. Go capture some 360° panorama photos!
  6. Manually stich the photos together to create a 360° panorama.
    • There are many stiching programs available.
    • I have used Autopano Giga with success.
Partial Panorama Example
Partial Panorama Example

This web applcation will allow one to upload a CSV file containing a simple waypoint mission (maximum of 10 waypoints). It will then generate a new Litchi mission (CSV file) with the necessary waypoints and camera actions to capture photos that can be used to create a 360° panorama at each of the waypoints in the original, uploaded mission.

The orientation of photos captured in row-major order at each waypoint will be computed based on:

  • The camera field of view (FOV)
  • The requested horizontal and vertical overlap percentage

After creating this new CSV file, import it as a new mission into Litchi's Mission Hub configured with the following settings:

  • Heading Mode: Custom (WD)
  • Path Mode: Straight Lines
  • Gimbal Extension (+30°): On (Litchi app settings, for older drones only)

NOTE: If using the "DJI Fly Compatibility" mode, this mission will be created with the drone flying in a small circle taking one photo per waypoint. This is done to accommodate a bug in DJI Fly which prevents the use of a large number of "dummy" waypoints.

Drone/Camera:
Enable DJI Fly Compatibility:
Minimum Horizontal overlap:
%
Minimum Vertical overlap:
%
Litchi CSV File Upload:

About DJI Fly Compatibility

In Litchi, it is possible to assign up to 15 actions per waypoint. For example, in Litchi, one can define these actions at one waypoint:

  • Rotate aircraft to 0 degrees
  • Take photo
  • Rotate aircraft to 45 degrees
  • Take photo
  • Rotate aircraft to 90 degrees
  • Take photo
  • Rotate aircraft to 135 degrees
  • Take photo
  • etc.

When converting such a mission into WPML, a series of actions, such as those displayed above, can be defined for a given waypoint and those actions can be configured to be executed sequentially. However, DJI Fly will only execute the first of a series of actions. DJI's implementation of waypoints in DJI Fly does not support multiple actions per waypoint despite the fact that the WPML language does support multiple actions executed sequentially.

When using the "Enable DJI Fly Compatibility" option, this utility will generate a mission in the shape of a small circle where one photo is captured at each waypoint with a given heading and gimbal pitch angle. Each waypoint is two feet (0.6 m) away from each other. This results in many more waypoints than are required for Litchi, but is the only way to capture the necessary photos with a panorama waypoint mission using DJI Fly.

Litchi Utilities dot Com
by Wes Barris