Deployed 98d086a with MkDocs version: 1.5.3

mwp-los-tool/index.html

@@ -1208,11 +1208,12 @@ <h2 id="invocation">Invocation<a class="headerlink" href="#invocation" title="Pe
 <p>LOS is invoked from any waypoint using the right mouse button. There are two specific options:</p>
 <p><img alt="Menu Options" src="../images/los-menu.png" width="30%" /></p>
 <ul>
-<li><strong>LOS Analysis</strong> : The user can select locations on the mission via a slider and run an analysis. A LOS calculation is performed, a graphical view is shown and a red (no LOS) or green (LOS) line is displayed on the map from the observer (home location) to the chosen location. This may be repeated as required.</li>
+<li><strong>LOS Analysis</strong> : The user can select locations on the mission via a slider and run an analysis. A LOS calculation is performed, a graphical view is shown and a red (no LOS), orange (LOS below a user defined margin) or green (unconditional LOS) line is displayed on the map from the observer (home location) to the chosen location. This may be repeated as required.</li>
 <li><strong>Auto LOS</strong> : The calculation is performed automatically with 1% increments of the mission length. A set of resulting red or green LOS lines is displayed om the map. This requires that the user has <a href="#user-bing-key">applied their own Bing API key</a>.</li>
 </ul>
+<p>Note that both options are also available from the LOS analysis window; the "Auto LOS" menu option is merely a convenience.</p>
 <h2 id="examples">Examples<a class="headerlink" href="#examples" title="Permanent link">#</a></h2>
-<p>Note that when the LOS slider is displayed, the only UI actions available are:</p>
+<p>When the LOS slider is displayed, the only UI actions available are:</p>
 <ul>
 <li>Scroll the map</li>
 <li>Zoom the map</li>
@@ -1221,15 +1222,16 @@ <h2 id="examples">Examples<a class="headerlink" href="#examples" title="Permanen
 <p>This restriction means that the mission cannot be changed while a LOS Analysis is being performed.</p>
 <h3 id="manual-los-analysis">Manual LOS Analysis<a class="headerlink" href="#manual-los-analysis" title="Permanent link">#</a></h3>
 <p>In the image below, the user has selected "LOS Analysis" from the right mouse menu at WP9. The slider is positioned appropriate to WP9. Note that if the mission contains JUMP WPs, these are executed once only (regardless of the mission setting). This is why the slider might appear less advanced compared to the mission length if the JUMP is ignored. The user can reposition the WP using the slider.</p>
-<p>When "Perform LOS" is clicked, the LOS is calculated between planned home (brown icon, lower left) and the red "⨁" "Point of Interest" (POI) icon. This is displayed as a terrain plot with the LOS line superimposed over the terrain elevation. The line is red as there is no LOS (it would be green where there is LOS). A red "dot-dash" is also displayed on the map.</p>
-<p>The user may repeat the "move slider" / "Perform LOS" action as required. The prior terrain plot is removed each time "Perform LOS" is selected; the lines on the map are removed when the slider dialog is closed.</p>
+<p>When "Point LOS" is clicked, the LOS is calculated between planned home (brown icon, lower left) and the red "⨁" "Point of Interest" (POI) icon. This is displayed as a terrain plot with the LOS line superimposed over the terrain elevation. The line is red as there is no LOS (and it would be green where there is LOS). A red "dot-dash" is also displayed on the map. If a margin is specified, then LOS lines with clearance between the terrain and the margin value are shown in orange.</p>
+<p>The user may repeat the "move slider" / "Point LOS" action as required. The prior terrain plot is removed each time "Point LOS" is selected; the lines on the map are removed when the slider dialog is closed. "Auto LOS" may be used to run a continuous analysis from the currently selected location.</p>
+<p>When an analysis results in an orange or red LOS line, the first point where the LOS break is detected is shown on the line as a coloured blob. This is apparent in the Auto image below.</p>
 <p><img alt="Manual LOS" src="../images/los_manual.png" /></p>
 <h3 id="auto-los">Auto LOS<a class="headerlink" href="#auto-los" title="Permanent link">#</a></h3>
 <p>If the user has specified a <a href="#user-bing-api-key">user supplied Bing API key</a>, then an Auto LOS analysis can be run. The analysis is iterated along the mission path automatically.</p>
 <p><img alt="Auto LOS" src="../images/auto-los.png" /></p>
-<p>The image shows the state at the end of the analysis. While the analysis is running, the slider and "Perform LOS" are not sensitive; once the run has completed, these controls are available if the user wishes to investigate further.</p>
-<p>Here we can see that there is an area of the mission (SE quadrant) where there is no LOS.</p>
-<iframe width="1032" height="607" src="https://www.youtube.com/embed/UnejePWHMuM" title="mwp LOS (Line of Sight) Tool" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
+<p>The image shows the state after a complete "Auto" analysis. While the analysis is running, the slider and "Point LOS" are not sensitive; once the run has completed, these controls are available if the user wishes to investigate further. The user can stop (and restart) Auto  using the "Auto LOS" / "Stop" button.</p>
+<p>Here, the user has subsequently used "Point LOS" to examine a point in the orange region. As expected, there is very little clearance between the LOS line and the terrain. This is confirmed on the map plot where the "blobs" indicate the point where LOS is compromised.</p>
+<iframe width="768" height="634" src="https://www.youtube.com/embed/EIm8vksK1Pg" title="mwp LOS (Line of Sight) Tool" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
 
 <h2 id="user-bing-api-key">User Bing API Key<a class="headerlink" href="#user-bing-api-key" title="Permanent link">#</a></h2>
 <p>In the same way that the INAV Configurator requires the user to have their own Bing API key, this is also required for the <a href="#auto-los">Auto LOS</a> option. Details on now to obtain a key can be found in the <a href="https://github.com/iNavFlight/inav-configurator#how-to-get-the-bing-maps-api-key">INAV Configurator README</a>.</p>
@@ -1248,7 +1250,7 @@ <h2 id="user-bing-api-key">User Bing API Key<a class="headerlink" href="#user-bi
   <small>
 
       Last update:
-      2023-11-09
+      2023-11-10
 
   </small>
 </div>