Skip to content

Commit

Permalink
Help updated
Browse files Browse the repository at this point in the history
  • Loading branch information
mauroalberti committed Oct 1, 2017
1 parent 06a3eb8 commit 259adb3
Show file tree
Hide file tree
Showing 8 changed files with 26 additions and 30 deletions.
56 changes: 26 additions & 30 deletions help/help.html
Original file line number Diff line number Diff line change
Expand Up @@ -83,8 +83,8 @@ <h2>1. General workflow</h2>
<h2>2. Topographic profile creation</h2>

<div>
It is possible to create a topographic profile, by first defining its source (in the "Topographic data sources" section).
After the profile definition, its statistics are calculated ("Profile statistics" section) and then the profile can be visualised ("Profile plot" section).
It is possible to create a topographic profile, by first defining its source.
After the profile definition, its statistics are calculated ("<i>Profile statistics</i>" section) and then the profile can be visualised ("<i>Profile plot</i>" section).
</div>

<div style="text-align:center;margin: 20px;font-size: 90%;font-style:italic;">
Expand All @@ -101,7 +101,7 @@ <h3>2.1 Definition of topographic data sources</h3>
<li>a GPX file storing track points.</li>
</ol>

The orientation of the profile, be it from DEMs or from a GPX file, can be reversed by checking the "Invert orientation" checkbox: the start will become the end and vice versa.
The orientation of the profile, be it from DEMs or from a GPX file, can be reversed by checking the "<i>Invert orientation</i>" checkbox: the start will become the end and vice versa.
</div>

<h4>2.1.1 Topographic profile creation from DEM(s) and line traces</h4>
Expand Down Expand Up @@ -165,12 +165,12 @@ <h5>2.1.1.3 Line from numeric input</h5>
<h5>2.1.1.4 Definition of input DEMs</h5>

<div>
By clicking on "Define source DEMs" the user can choose which of the loaded DEMs to use, also choosing the color that will represent it in the resulting profile.
By clicking on "<i>Define source DEMs</i>" the user can choose which of the loaded DEMs, one or more, to use.
</div>
<br />
<div style="text-align:center;margin: 20px;font-size: 90%;font-style:italic;">
<img src="images/f04.png" style="align:middle; max_width: 80%"/>
<br /><br />Fig. 4. Definition of source DEMs.
<br /><br />Fig. 6. Definition of source DEMs.
</div>

<h5>2.1.1.5 Definition of line densify distance</h5>
Expand All @@ -183,34 +183,31 @@ <h4>2.1.2 Topographic profile creation from GPX</h4>

<div>
Topographic profiles can be created also using a GPX file as a source. The original latitude-longitude values are automatically converted to a WGS84-based cartesian metric values, and from those values the topographic profile is constructed.
Beware that in the current version, only profile lines with just two points (start and end points) may be used for further geological data projections and intersections. So if you just want to create a topographic profile, GPX profile sources are fine.
In future releases, the only-two-points constraint for geological intersections should be removed.
</div>

<div style="text-align:center;margin: 20px;font-size: 90%;font-style:italic;">
<img src="images/f05.png" style="align:middle; max_width: 80%"/>
<br /><br />Fig. 5. The window for input GPX file choice.
<br />Beware that in the current version, only profile lines with just two points (start and end points) may be used for further geological data projections and intersections. So if you just want to create a topographic profile, GPX profile sources are fine.
</div>

<h3>2.2 Profile statistics</h3>

<div>
The elevation statistics along the profile for each chosen DEM may be calculate with the "<i>Calculate profile statistics</i>" button.
These statistics can be used as a help in the definition of the profile plot minimum and maximum elevations ("<i>plot z min value</i>"
The elevation statistics along the profile for each chosen DEM may be calculate with the "<i>Calculate profile statistics</i>" button. Statistics are subdivided by profile and DEM.
<br />These statistics can be used as a help in the definition of the profile plot minimum and maximum elevations ("<i>plot z min value</i>"
and "<i>plot z max value</i>" options). Otherwise, automatic values will be applied.
</div>

<h3>2.3 Profile plot</h3>

<div>
The profile plot is created by using the "<i>Create profile</i>" button.
The profile plot is created by using the "<i>Create topographic profile</i>" button.
Values for the vertical exaggeration and minimum and maximum elevation in the plot are precomputed, however the user may modify them.

<br /><br />

Both height and slope can be plotted. Slopes are in degrees, and can be computed a absolute or direction values. When directional, positive values indicate upslope segments in the profile direction, while negative values indicate downslope segments.

<br /><br />
Within the window activated by the "<i>Elevation layer visibility and colors</i>" button it is possible to define the colors, as well as the visibilities, of the distinct elevation layers sources.

<br /><br />

With the option "<i>Flip x-axis direction</i>", the start of the x-axis in the plot will be at the right, not at the left, so that distances will increase from left to right.

Expand All @@ -222,7 +219,7 @@ <h3>2.3 Profile plot</h3>
<br />
<div style="text-align:center;margin: 20px;font-size: 90%;font-style:italic;">
<img src="images/f06.png" style="align:middle; max_width: 80%"/>
<br /><br />Fig. 6. The window for the definition of the plot parameters.
<br /><br />Fig. 7. The window for the definition of the plot parameters.
</div>


Expand All @@ -243,22 +240,20 @@ <h3>3.1 Projection of geological attitudes</h3>
<br />
<div style="text-align:center;margin: 20px;font-size: 90%;font-style:italic;">
<img src="images/f07.png" style="align:middle; max_width: 80%"/>
<br /><br />Fig. 7. The plugin interface for geological attitude projections on the profile.
<br /><br />Fig. 8. The plugin interface for geological attitude projections on the profile.
</div>
<br />
<div>
The geological attitudes can be projected on the section plane according to three methods:
<ol>
<li>nearest point;</li>
<li>projection along a common axis;</li>
<li> projection along individual axes, for each geological record.</li>
<li>nearest intersection: data are projected perpendicular to the profile line</li>
<li>projection along a common axis, defined through its trend and plunge: the projection axis for all data is the same</li>
<li>projection along individual axes for each geological record, defined in the trend and plunge fields</li>
</ol>
When choosing the <i>axes from</i> option, <i>trend</i> and <i>plunge</i> fields,
storing the fold axis values along which to project each observation, are required in the source point layer.
</div>
<div style="text-align:center;margin: 20px;font-size: 90%;font-style:italic;">
<img src="images/f08.png" style="align:middle; max_width: 80%"/>
<br /><br />Fig. 8. Example of geological attitudes projection along a profile in the eastern sector of Mt. Alpi zone (Basilicata, Southern Italy).
<br /><br />Fig. 9. Example of geological attitudes projection along a profile in the eastern sector of Mt. Alpi zone (Basilicata, Southern Italy).
</div>

<br />
Expand All @@ -275,21 +270,22 @@ <h3>3.2 Projection of geological lines</h3>
</div>
<div style="text-align:center;margin: 20px;font-size: 90%;font-style:italic;">
<img src="images/f09.png" style="align:middle; max_width: 80%"/>
<br /><br />Fig. 9. The plugin interface for geological lines projections on the profile.
<br /><br />Fig. 10. The plugin interface for geological lines projections on the profile.
</div>
<br />
<div>
The "<i>Id field</i> is used to label the project lines in the resulting plot, as evident in Fig. 7.
The "<i>Id field</i>" is used to label the project lines in the resulting plot, as evident in Fig. 11.
</div>
<div style="text-align:center;margin: 20px;font-size: 90%;font-style:italic;">
<img src="images/f10.png" style="align:middle; max_width: 80%"/>
<br /><br />Fig. 10. Example of geological line projections on a profile in the Mt. Alpi zone (Basilicata, Southern Italy).
<br /><br />Fig. 11. Example of geological line projections on a profile in the Mt. Alpi zone (Basilicata, Southern Italy).
</div>

<br />
<h2>4. Intersections of geological elements</h2>
<div>
It is possible to determine the intersections of the profile (composed by just two points) with lines ("<i>Intersect line layer</i>") or with polygons ("<i>Intersect polygon layer</i>"), representing geological features.
With the polygon intersection tool, the colors for the resulting intersection will be chosen in an ad.hoc window.
</div>
<br />
<div>
Expand All @@ -301,12 +297,12 @@ <h2>4. Intersections of geological elements</h2>
<br />
<div style="text-align:center;margin: 20px;font-size: 90%;font-style:italic;">
<img src="images/f11.png" style="align:middle; max_width: 80%"/>
<br /><br />Fig. 11. Window for line intersection.
<br /><br />Fig. 12. Window for polygon intersection.
</div>
<br />
<div style="text-align:center;margin: 20px;font-size: 90%;font-style:italic;">
<img src="images/f12.png" style="align:middle; max_width: 80%"/>
<br /><br />Fig. 12. Example of geological polygon intersection on a profile in the Mt. Alpi zone (Basilicata, Southern Italy).
<br /><br />Fig. 13. Example of geological polygon intersection on a profile in the Mt. Alpi zone (Basilicata, Southern Italy).
</div>

<br />
Expand All @@ -329,7 +325,7 @@ <h2>5. Result export</h2>
<br />
<div style="text-align:center;margin: 20px;font-size: 90%;font-style:italic;">
<img src="images/f13.png" style="align:middle; max_width: 80%"/>
<br /><br />Fig. 13. The plugin interface for result export.
<br /><br />Fig. 14. The plugin interface for result export.
</div>


Expand All @@ -339,7 +335,7 @@ <h2>5. Result export</h2>
<div style="font-size: 85%; font-style: italic;">
-----
<br /><br />
Doc version 2016-08-28, by Mauro Alberti - <a href="mailto:[email protected]">[email protected]</a>
Doc version 2016-10-01, by Mauro Alberti - <a href="mailto:[email protected]">[email protected]</a>
</div>

<br /><br />
Expand Down
Binary file modified help/images/f04.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed help/images/f05.png
Binary file not shown.
Binary file modified help/images/f06.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified help/images/f07.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified help/images/f09.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified help/images/f11.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified help/images/f13.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 259adb3

Please sign in to comment.