From bcf162b413a51a293a1ff18bef609c1cf05ff39f Mon Sep 17 00:00:00 2001
From: spwoodcock <sam.woodcock@protonmail.com>
Date: Wed, 30 Oct 2024 14:12:08 +0000
Subject: [PATCH] docs: info for creating wpml flightplan manually

---
 docs/manuals/generate-flightplans.md | 53 ++++++++++++++++++++++++++++
 mkdocs.yml                           |  2 ++
 2 files changed, 55 insertions(+)
 create mode 100644 docs/manuals/generate-flightplans.md

diff --git a/docs/manuals/generate-flightplans.md b/docs/manuals/generate-flightplans.md
new file mode 100644
index 00000000..ce0e7db6
--- /dev/null
+++ b/docs/manuals/generate-flightplans.md
@@ -0,0 +1,53 @@
+# Generating Flightplans
+
+## Manually Via Command Line
+
+1. Calculate Flight Parameters:
+
+```python
+python calculate_parameters.py \
+    --forward_overlap 70 \
+    --side_overlap 70 \
+    --altitude_above_ground_level 115 \
+    --image_interval 2
+```
+
+> This will output a JSON that can be used in step 5 below.
+
+2. Creating Waypoints:
+
+```python
+python waypoints.py \
+    --project_geojson_polygon aoi.geojson \
+    --altitude_above_ground_level 115 \
+    --forward_overlap 70 \
+    --side_overlap 70 \
+    --generate_each_points \
+    --take_off_point LON,LAT \
+    --output_file_path ./waypoints.geojson
+```
+
+3. Add Eleveation Data From A DEM File:
+
+```python
+python add_elevation_from_dem.py dsm.tif waypoints.geojson waypoints_with_elevation.geojson
+```
+
+> Here we need a DEM in .tiff format.
+
+4. Create Placemark File (For KMZ File):
+
+```python
+python create_placemarks.py \
+    --waypoints_geojson waypoints_with_elevation.geojson \
+    --parameters '{"forward_photo_height": 84.0, "side_photo_width": 149.0, "forward_spacing": 20.95, "side_spacing": 44.6, "ground_speed": 10.47, "altitude_above_ground_level": 115}' \
+    --outfile placemarks.geojson
+```
+
+5. Create WMPL Flightplan:
+
+```python
+python wpml.py \
+    --placemark placemarks.geojson \
+    --outfile flightplan.wpml
+```
diff --git a/mkdocs.yml b/mkdocs.yml
index 92392fd7..079dd326 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -74,6 +74,8 @@ nav:
       - Code of Conduct: https://docs.hotosm.org/code-of-conduct
       - FAQ: about/faq.md
       - The Team: about/team.md
+  - User Manuals:
+      - Flightplans: manuals/generating-flightplans.md
   - Developer Guide:
       - Setup: dev/setup.md
   - Timeline: timeline.md