#acl AdminGroup:read,write,revert EditorsGroup:read,write,revert All:read

##############################################################################
##############################################################################

## DE-EN_Sprachflaggen

{{{#!wiki language_selector/de
[[ de/Waypoint/WP-Generator/Area | {{ http://www.mikrokopter.de/addons/shared_addons/themes/mk3/img/flag_ger.png }}]]
}}}

###########################################################################
<<BR>>
<<BR>>
<<BR>>
<<BR>>
<<TableOfContents>>
<<BR>><<BR>>
###########################################################################
###########################################################################
<<BR>>


= Area =

In the ''Waypoint Generator'' you can select the tab '''"Area"'''.<<BR>><<BR>>

With this feature you can automatically generate an arbitrary rectangular grid with up to 200 waypoints. <<BR>><<BR>>


||< -3 class="MK_THeader" height= 30px>'''Settings:'''||
||< -3 class="MK_TableNoBorder" height= 10px>||
||<class="MK_TableNoBorder" (width= 160px>Symbol - {{ http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/Kamera.jpg?m=1450265992 }}||<class="MK_TableNoBorder">Opens the Camera tool||<|20 class="MK_TableNoBorder" (width= 220px :>{{ http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/_en/WP-Generator-Gebiet_en.jpg?m=1441353322 }}||
||<class="MK_TableNoBorder">Distance X[m]:          ||<class="MK_TableNoBorder">Distance in meters between the waypoints in X-direction||
||<class="MK_TableNoBorder">#WPs in X:              ||<class="MK_TableNoBorder">Number of waypoints in the X-direction||
||<class="MK_TableNoBorder">Distance Y[m]:          ||<class="MK_TableNoBorder">Distance in meters between the waypoints in Y-direction||
||<class="MK_TableNoBorder">#WPs in Y:              ||<class="MK_TableNoBorder">Number of waypoints in the Y-direction||
||<class="MK_TableNoBorder">Grid Rotation [°]       ||<class="MK_TableNoBorder">Orientation of the grid||
||< -2 class="MK_TableNoBorder" height= 10px>||
||<class="MK_TableNoBorder">'''Waypoint:'''         ||
||<class="MK_TableNoBorder">Radius [m]              ||<class="MK_TableNoBorder">Radius around the individual waypoint (should be "10") ||
||<class="MK_TableNoBorder">Altitude [m]            ||<class="MK_TableNoBorder">Altitude of the waypoint||
||<class="MK_TableNoBorder">Heading [°]             ||<class="MK_TableNoBorder">Direction in which the copter looks when it reaches the waypoint||
||<class="MK_TableNoBorder">Cam-Nick [°]            ||<class="MK_TableNoBorder">Tilt of the camera when it reaches the waypoint||
||<class="MK_TableNoBorder">Speed [0.1m/s]          ||<class="MK_TableNoBorder">Flight speed between the waypoints||
||<class="MK_TableNoBorder">Climb rate [0.1m/s]     ||<class="MK_TableNoBorder">Flight speed to change the altitude between the waypoints||
||<class="MK_TableNoBorder">!DelayTime [s]           ||<class="MK_TableNoBorder">Waiting time per waypoint. <<BR>>If you set here an "0", the copter will not stop on the waypoint. He fly directly further to the next waypoint||
||<class="MK_TableNoBorder">WP event                ||<class="MK_TableNoBorder">Switching duration per box of the Bitmask for "Out1" <<BR>>Applies only to the single  waypoint - not for triggering any X Meter! ||
||<class="MK_TableNoBorder">Auto Trigger [m]        ||<class="MK_TableNoBorder">Triggering the switching output "Out1" every X meters<<BR>>(Switching duration per box of the Bitmask = 10ms)||
||<class="MK_TableNoBorder">WP Prefix               ||<class="MK_TableNoBorder">Enter an individual letter. Helpful when a large number of waypoints are planned.<<BR>>INFO: You will see the letter only in the Editor and in the LOG File, not on the Map. In the Map you see still a "P" on each waypoint. ||
||<class="MK_TableNoBorder">Add 1sec Curve !DelayTime||<class="MK_TableNoBorder">Sets a waiting period of 1 sec for the vertices||
||<class="MK_TableNoBorder">Deleting existing WPs   ||<class="MK_TableNoBorder">Deletes existing WPs when you press the button "Generate"||
||<class="MK_TableNoBorder">Generate                ||<class="MK_TableNoBorder">Create the new waypoints||
||<class="MK_TableNoBorder">Convert to !AutoTrigger ||<class="MK_TableNoBorder">Explanation see [[#Sprung1|Convert to !AutoTrigger]]||



###########################################################################
<<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>>



= Example 1 - triggering at each waypoint =

In this example, we fly over an area of approximately 180m x 80m (see also [[#Sprung2|Distance]]). <<BR>>
The starting point on the field is top left (red arrow).

 {{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/WP-Flug-Karte.jpg?m=1450266646 }}

These requirements should be respected:
 * the flight series should go beyond the short side of the field
 * every 10 meters the copter should trigger the camera without stopping at the waypoints
 * the flight rows have a distance of 12 meters
 * the flying height should be 30 meters
 * airspeed 3m / s
 * and the camera to look down in flightdirection

<<BR>><<BR>>

'''Step 1''' <<BR>>

 First we have to mark the starting point in the map. Move the mouse pointer to the place where we will start and press the left mouse button. Now you see a marker there.
<<BR>><<BR>>
 {{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/Marker.png?m=1450270668 }}


<<BR>><<BR>>


'''Step 2''' <<BR>>

 The copter should trigger all 10m and the rows should have a distance of 12 meters. 

 For 80m we need then 9 waypoints in "X" direction (80:10=8 +1=9 => one WP in 0m - 10m - 20m ... 80m) <<BR>>
 and for the 180m we need 16 waypoints in "Y" direction (180:12=15 +1=16 => one WP in 0m - 12m - 24m ... 180m).<<BR>>
 So we have totally '''144 waypoints'''.<<BR>>

 So we have to set: <<BR>>
  * '''DistanceX[m]''' = 10
  * '''#WPs in X''' = 9
  * '''DistanceY[m]''' = 12
  * '''#WPs in Y''' = 16


<<BR>><<BR>>

## Bild rechts

{{{#!html
<div style="float: right; margin: 15px;">
}}}
{{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/Ausrichtung.png?m=1450273689 }}
{{{#!html
</div>
}}}

<<BR>>

'''Step 3''' <<BR>>
 
 In this example the grid for the waypoint flight should be simular with the field. So we have to change the "Rotation". Here we need 170°:<<BR>>
  * '''"Rotation [°]"''' = 170°.

 '''TIP:''' You can point the grid in every direction you need. So you can align the orientation on a road or a field.


<<BR>><<BR>>


'''Step 4''' <<BR>>

 Now we set the altitude (30m), the camera tilt (down = 90°), triggering for Out1 (to get pictures), the airspeed (3m/s) and the line of sight for the copter (straight to the flight path). 

 We have to set: <<BR>>
  * '''Altitude[m]''' = 30
  * '''Cam-Nick[°]''' = 90
  * '''WP event''' = 6
  * '''Speed[0.1m/s]''' = 30
  * '''Heading[°]''' = 170


 The copter should not stop at each waypoint. So we set the !DelayTime to 0:
  * '''!DelayTime:[s]''' = 0

 Finally, we set a value at the Climb rate:
  * '''Climb rate[0.1m/s]''' = 30

 INFO: <<BR>> 
 When you start your copter you will "park" him in any height. When you now activate the waypoint flight the copter can climb automatically to the set altitude when you set a value under Climb rate. If you set here a "0" the copter will not climb up/down to a set altitude. He will hold the altitude where you "park" him.


 Tip: <<BR>>
 To slow down a little bit when the copter reach the waypoint at the end of a line, we can activate "Add 1sec Curve !DelayTime". Then the copter will reach this waypoint softer. 
 

<<BR>><<BR>>


'''Step 5''' <<BR>>

 With a click on the button '''"Generate"''' all 144 needed waypoints will be placed on the map. <<BR>>

 That looks like this: 

 [[  http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/_en/WP-Flug1_en.jpg?m=1452168218 | {{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/_en/WP-Flug1_en.jpg?m=1452168218 }} ]]



 '''INFO'''<<BR>>

 If "Deleting existing WPs" is activated you will clear all already set waypoints on the map and place only the new waypoints. Without you can place the same waypoints one above the other or at different locations on the map. 
<<BR>>

 The entries in the editor for this WP flight look like this:
 
 [[  http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/WP-Flug1-Editor.jpg?m=1450423798 | {{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/WP-Flug1-Editor.jpg?m=1450423817 }} ]]


 Here you can see that the flight have a totally distance of ~1455m and that the flight time is ~11:50.<<BR>>
 These figures are estimates and may vary from the actual flight (e.g wind etc.).



###########################################################################
<<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>>



= Example 2 - triggering every X meters =

In this example, we also fly over the same field with the dimensions approximately 180m x 80m (see also [[#Sprung2|Distance]]). <<BR>>
But here we will not place every 10m a waypoint. Now we will do this with less waypoints and a triggering all X meters.

 {{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/WP-Flug-Karte.jpg?m=1450266646 }}

Also here these requirements should be respected:
 * the flight series should go beyond the short side of the field
 * every 10 meters the copter should trigger the camera without stopping at the waypoints
 * the flight rows have a distance of 12 meters
 * the flying height should be 30 meters
 * airspeed 3m / s
 * and the camera to look down in flightdirection




<<BR>><<BR>>

'''Step 1''' <<BR>>

 First we have to mark the starting point in the map. Move the mouse pointer to the place where we will start and press the left mouse button. Now you see a marker there.<<BR>><<BR>>

 {{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/Marker.png?m=1450270668 }}


<<BR>><<BR>>


'''Step 2''' <<BR>>

 The copter should trigger all 10m and the rows should have a distance of 12 meters.

 For 80m we need now 2 waypoints in "X" direction (Starting point and end point of the line) <<BR>>
 and for the 180m we need 16 waypoints in "Y" direction (180:12=15 +1=16 => one WP in 0m - 12m - 24m ... 180m).<<BR>>
 So we have totally '''32 waypoints''' (remember, in example 1 we need 144 waypoints).<<BR>>

 So we have to set: : <<BR>>
  * '''DistanceX[m]''' = 80
  * '''#WPs in X''' = 2
  * '''DistanceY[m]''' = 12
  * '''#WPs in Y''' = 16


 To trigger the camera automatically all 10m on "Out1" we have to set now "!AutoTrigger[m]":
  * '''!AutoTrigger[m]''' = 10

 '''Info:''' <<BR>>
 The triggering every X meters use a fixed time interval of 10ms per box of the switching output "Out1". 

<<BR>><<BR>>

## Bild rechts

{{{#!html
<div style="float: right; margin: 15px;">
}}}
{{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/Ausrichtung.png?m=1450273689 }}
{{{#!html
</div>
}}}

<<BR>>

'''Step 3''' <<BR>>
 
  Also here the grid for the waypoint flight should be simular with the field:<<BR>>
  * '''"Rotation [°]"''' = 170°.



<<BR>><<BR>><<BR>>
<<BR>>
<<BR>>



'''Step 4''' <<BR>>

 Now we set the altitude (30m), the camera tilt (down = 90°), triggering for Out1 (to get pictures), the airspeed (3m/s) and the line of sight for the copter (straight to the flight path). 

 We have to set: <<BR>>
  * '''Altitude[m]''' = 30
  * '''Cam-Nick[°]''' = 90
  * '''WP event''' = 6 (that the camera will also trigger directly at the waypoint)
  * '''Speed[0.1m/s]''' = 30
  * '''Heading[°]''' = 170

 The !DelayTime is here also 0:
  * '''DelayTime:[s]''' = 0

 Finally, we set a value at the Climb rate:
  * '''Climb rate[0.1m/s]''' = 30

 INFO: <<BR>> 
 When you start your copter you will "park" him in any height. When you now activate the waypoint flight the copter can climb automatically to the set altitude when you set a value under Climb rate. If you set here a "0" the copter will not climb up/down to a set altitude. He will hold the altitude where you "park" him.!


 INFO: <<BR>>
 To slow down a little bit when the copter reach the waypoint at the end of a line, we can activate "Add 1sec Curve DelayTime". Then the copter will reach this waypoint softer.


<<BR>><<BR>>


'''Step 5''' <<BR>>

 With a click on the button "Generate" all 32 needed waypoints will be placed on the map. <<BR>>

 That looks like this: 

 [[  http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/_en/WP-Flug2_en.jpg?m=1452168219 | {{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/_en/WP-Flug2_en.jpg?m=1452168220 }} ]]



 '''INFO'''<<BR>>

 If "Deleting existing WPs" is activated you will clear all already set waypoints on the map and place only the new waypoints. Without you can place the same waypoints one above the other or at different locations on the map.
<<BR>>

 The entries in the editor for this WP flight look like this::
 
 [[  http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/WP-Flug2-Editor.jpg?m=1450423820 | {{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/WP-Flug2-Editor.jpg?m=1450423827 }} ]]


 Here you can see that the flight have a totally distance of ~1460m and that the flight time is ~12:22.
These figures are estimates and may vary from the actual flight (e.g wind etc.).



###########################################################################
<<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>>



= Example 3 - triggering every X meters - in a given overlapped for pictures =

In this example, we also fly over the same field with the dimensions approximately 180m x 80m (see also [[#Sprung2|Distance]]).

The photos should have a predefined overlap in X and Y direction. Every X meters we trigger the camera automatically, matching to the overlap.<<BR>>

'''Step 1''' <<BR>>

 With one "click" on the camera symbol we open the "!CameraTool". {{ http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/Kamera.jpg?m=1450265992 }}

 With the "!CameraTool" we can choose the camera (or set this manually) and set the overlap.


<<BR>><<BR>>

 
'''Step 2''' <<BR>>

 The first thing is now to choose/set the camera. If our camera is not list we can set the dimensions of the sensor chip also manually.

  '''Info:''' <<BR>>
  The "chip dimensions" of the sensor chip are __not__ the pixel. Here you need the dimensions of the chip in "mm". You can find it in the manual of your camera under "technical data".
 
 [[  http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/WPG-KameraAuswahl1.png?m=1450442550 | {{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/WPG-KameraAuswahl1.png?m=1450442551 }} ]]


<<BR>><<BR>>

## Bild rechts

{{{#!html
<div style="float: right; margin: 15px;">
}}}
{{ http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/_en/WP-Generator_CameraTool_en.jpg?m=1441353320 }}
{{{#!html
</div>
}}}

<<BR>>

'''Step 3''' <<BR>>

 Now we can set the flight altitude, the used focal length and the desired overlap in X and Y direction.

 Finally, set a hook at "Use Auto trigger".

 {{ http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/_en/AutoTrigger_en.jpg?m=1452249511 }}


<<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>>
<<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>>


'''Step 4''' <<BR>>

 A "click" on the button "Copy values to generator & close" will close this window and set the needed values to our Waypoint Generator.
 We have only to set manually the distance between the vertices ("DistanceX[m]") and the number of lines in Y direction we will fly

 The result with 26 waypoints looks like this: 

 [[  http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/_en/WP-Flug3_en.jpg?m=1452168220 | {{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/_en/WP-Flug3_en.jpg?m=1452168220 }} ]]
 

 And the entries in the editor for this WP flight look like this:
 
 [[  http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/WP-Flug3-Editor.jpg?m=1450444144 | {{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/WP-Generator-01/WP-Flug3-Editor.jpg?m=1450444144 }} ]]


 Here you can see that the flight have a totally distance of ~1220m and that the flight time is ~10:16.<<BR>>
 These figures are estimates and may vary from the actual flight (e.g wind etc.).



###########################################################################
<<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>>



<<Anchor(Sprung1)>>

= Example 4 - Convert to AutoTrigger =

In this example, we are planning the same waypoint flight as in Example 1.

During this flight, we need the waypoints only to set a point where we will trigger the camera. There is no stop at the single waypoint.
In order to save these waypoints between the endpoints, we use the button "Convert to Auto Trigger" .


 Here are the resultss:

 [[  http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/_en/WP-Flug1_en.jpg?m=1452168218 | {{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/_en/WP-Flug1_en.jpg?m=1452168218 }} ]]

 {{ http://gallery3.mikrokopter.de/var/albums/intern/sonstiges/Button/Pfeil_runter3.png?m=1438161876 }}

 {{ http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/_en/Button-Konvertieren_en.jpg?m=1452252133 }}

 {{ http://gallery3.mikrokopter.de/var/albums/intern/sonstiges/Button/Pfeil_runter3.png?m=1438161876 }}

 [[  http://gallery3.mikrokopter.de/var/albums/intern/KopterTool_ab_V2_0/OSD/_en/WP-Flug2_en.jpg?m=1452168219 | {{ http://gallery3.mikrokopter.de/var/resizes/intern/KopterTool_ab_V2_0/OSD/_en/WP-Flug2_en.jpg?m=1452168220 }} ]]


###########################################################################
<<BR>><<BR>><<BR>><<BR>><<BR>><<BR>>


<<Anchor(Sprung2)>>

<<Include(en/MikroKopterTool-OSD, , from="##include_Entfernungen_begin", to="##include_Entfernungen_end")>>