Skip to content

Latest commit

 

History

History
82 lines (63 loc) · 3.13 KB

README.md

File metadata and controls

82 lines (63 loc) · 3.13 KB
Raw

Drone Flightplan

HOT

Generates waypoints for drone and creates a flightplan

📖 Documentation: https://hotosm.github.io/drone-flightplan/

🖥️ Source Code: https://github.com/hotosm/drone-flightplan

Overview

The Drone Flightplan Generator is a Python package designed to automate the creation of flight plans for drones. This tool is essential for users needing efficient and precise aerial surveys, mapping, and imagery collection.

Installation

To install the package, use pip

pip install drone-flightplan

Usage

To get the drone waypoints for a given Geojson Polygon AOI, we can do this:

from drone_flightplan.waypoints import create_waypoint

create_waypoint(
        polygon_geojson,
        altitude_above_ground_level,
        forward_overlap,
        side_overlap,
        generate_each_points,
        generate_3d,
    )

Parameters:
  - polygon_geojson = Geojson Polygon AOI
  - altitude_above_ground_level = The height at which you want to fly the drone from ground level
  - forward_overlap = Forward Overlap you want in the imageries
  - side_overlap = Desired Side Overlap you want in the imageries
  - generate_each_points (bool) : True if you want waypoints and False if you want waylines
  - generate_3d : True if you want to generate 3d imageries. False if you just want 2d imageries. 3d imageries will take photos ad 3 different angles (-90, -45 and lateral 45 degree angle)

Waypoint File

DJI drones requires waypoint file. WPML route files all end with a ".kmz" suffix and are essentially archive files packed in ZIP format. After decompression of a standard WPML route file, its file structure is as follows

image

You can find more on this from the documentation here.

You can get the waypoint file following this steps:

from drone_flightplan import flightplan

flightplan.generate_flightplan(
  project_area,
  altitude_above_ground_level,
  forward_overlap,
  side_overlap,
  generate_each_points,
  generate_3d,
  output_file_path
)

Parameters:
  - polygon_geojson = Geojson Polygon AOI
  - altitude_above_ground_level = The height at which you want to fly the drone from ground level
  - forward_overlap = Forward Overlap you want in the imageries
  - side_overlap = Desired Side Overlap you want in the imageries
  - generate_each_points (bool) : True if you want waypoints and False if you want waylines
  - generate_3d : True if you want to generate 3d imageries. False if you just want 2d imageries. 3d imageries will take photos ad 3 different angles (-90, -45 and lateral 45 degree angle)
  - output_file_path: The path where you want your output flightplan