Improve geolocation docs with rotation diagram and scale explanation

src/blenderbim/docs/users/georeferencing.rst

@@ -81,29 +81,42 @@ Northings, Orthogonal Height, and **Grid North**.
     are trained to work in **Map Coordinates**, it is safer to work with local
     engineering coordinates and consult your surveyor for professional guidance.
 
-**Map Conversions** contain three types of parameters. The **Eastings**,
+**Map Conversions** contain six parameters.
-**Northings** and **Orthogonal Height** parameters define the translation from
+
-the model's XYZ coordinates to map Eastings, Northings, and Heights. The **X
+**Eastings**, **Northings** and **Orthogonal Height** parameters define the
-Axis Abcissa** and **X Axis Ordinate** define the rotation vector from **Project
+translation from the model's XYZ coordinates to map **Eastings**, **Northings**,
-North** to **Grid North**. The **Scale** defines the average combined scale
+and **Heights**.  Your model's local engineering origin at 0, 0, 0, will always
-factor across the small 1km site that converts from the model's surface
+convert exactly to the **Easting**, **Northing**, and **Orthogonal Height**
-distances to map grid distances. Note that the **Scale** is actually not a
+displayed in this panel.
-constant. However, for the small sites dealt with in vertical construction, it
+
-may be approximated to be a constant by your surveyor and will typically be a
+The **X Axis Abcissa** and **X Axis Ordinate** define the rotation vector from
-value close to, but not exactly 1. Your model's local engineering origin at 0,
+**Project North** to **Grid North**. These two numbers combine into a coordinate
-0, 0, will always convert exactly to the **Easting**, **Northing**, and
+vector pointing along the X axis (i.e. **Project East**). The default is an
-**Orthogonal Height** displayed in this panel.
+abscissa of 1 and ordinate of 0. This default (1, 0) vector implies **Project
+East** and **Grid East** coalign, which means there is no rotation between
+**Project North** and **Grid North**.
+
+.. image:: xaxisabscissaordinate.png
 
 .. tip::
     
-   The rotation from **Project North** to **Grid North** are shown using the **X
+   To save you the mental struggle of converting to degrees, a calculated
-   Axis Abcissa** and **X Axis Ordinate**. It sounds strange, but these two
+   rotation is always just below these values. Phew!
-   numbers combine into a coordinate vector pointing along the X axis (i.e.
+
-   East). For example, an abscissa of 1 and an ordinate of 0 gives the vector of
+The distance measured on site, or the "surface distance" is actually not the
-   (1, 0), which points directly in the +X direction, due East. This vector
+same as the distance measured between Eastings and Northings. This difference is
-   means there is no rotation between **Project North** to **Grid North**. To
+provided by the **Scale** parameter. The **Scale** defines the average combined
-   save you the mental struggle of converting this vector to degrees, a
+scale factor across the small 1km site that converts from the model's surface
-   calculated rotation is always just below these values. Phew!
+distances to map grid distances. Note that the **Scale** is actually not a
+constant. However, for the small sites dealt with in vertical construction, it
+may be approximated to be a constant by your surveyor and will typically be a
+value close to, but not exactly 1.
+
+.. note::
+
+    Always check that the surveyor provides a scale factor such that surface
+    distance multiplied by **Scale** equals map grid distances (as opposed to
+    the other way around).
 
 Working with Map Coordinates
 ----------------------------