Skip to content

v0.2.47..v0.2.48 changeset ProjectionErrors.asciidoc

Garret Voltz edited this page Sep 27, 2019 · 1 revision
diff --git a/docs/algorithms/ProjectionErrors.asciidoc b/docs/algorithms/ProjectionErrors.asciidoc
index bd34d11..1fd2b42 100644
--- a/docs/algorithms/ProjectionErrors.asciidoc
+++ b/docs/algorithms/ProjectionErrors.asciidoc
@@ -68,10 +68,10 @@ Below are a number of examples showing the error results with the Sinusoidal pro
 ==== Sinusoidal Results
 
 Below the Sinusoidal test case is used as an example showing how the distance and angle errors manifest.
- 
+
 [[ProjectionErrorsSinusoidal1]]
-.Distance error values for sinusoidal viewed as unprojected (WGS84). The black values are within 10% error. Light green values are well below the expected value (< 900m). Dark green values are well above the expected values (>1100m). Blue is greater than three times the expected value (>3000m). This uses the Almost Globe test case, -89.5, -180 to 89.5,180. 
-image::algorithms/images/ProjectionErrorsSinusoidal1.png[]
+.Distance error values for sinusoidal viewed as unprojected (WGS84). The black values are within 10% error. Light green values are well below the expected value (< 900m). Dark green values are well above the expected values (>1100m). Blue is greater than three times the expected value (>3000m). This uses the Almost Globe test case, -89.5, -180 to 89.5,180.
+image::images/ProjectionErrorsSinusoidal1.png[]
 
 [NOTE]
 ======
@@ -84,41 +84,41 @@ Maybe show with http://en.wikipedia.org/wiki/Tissot's_indicatrix[Tissot's indica
 
 [[ProjectionErrorsSinusoidal2]]
 .Above is an image of the sample points in a Sinusoidal projection. This is the same data as displayed in <<ProjectionErrorsSinusoidal1>>.
-image::algorithms/images/ProjectionErrorsSinusoidal2.png[]
- 
-The largest errors tend to occur near the edges of the projection, or more specifically when the latitude and longitude move away from zero. One particularly extreme example is shown below which is found at 62.65, 180 (pointed to by the red arrow in <<ProjectionErrorsSinusoidal2>>).   
- 
+image::images/ProjectionErrorsSinusoidal2.png[]
+
+The largest errors tend to occur near the edges of the projection, or more specifically when the latitude and longitude move away from zero. One particularly extreme example is shown below which is found at 62.65, 180 (pointed to by the red arrow in <<ProjectionErrorsSinusoidal2>>).
+
 [[ProjectionErrorsSinusoidal3]]
 .Zoom in of distance error at 62.65, 180. The region is pointed to by the red arrow in <<ProjectionErrorsSinusoidal2>>.
-image::algorithms/images/ProjectionErrorsSinusoidal3.png[]
+image::images/ProjectionErrorsSinusoidal3.png[]
 
 The above image only shows half of the testing “star pattern”; the test point is on the edge of the map and all rays that extend past 180E are discarded. The values on each of the rays are the distance of the ray. The expected pattern is a star with exactly 1000m long rays creating a half circle.
- 
+
 Similar to distance errors, the values closer to 0 longitudes and 0 latitudes have less angular error.
 
 [[ProjectionErrorsSinusoidal4]]
 .Image of angle error in the sinusoidal projection. Black is less than 1 degree error, greens are higher and blue is 55 to 69 degrees error.
-image::algorithms/images/ProjectionErrorsSinusoidal4.png[]
+image::images/ProjectionErrorsSinusoidal4.png[]
 
 Similar to distance errors, the values closer to 0 longitudes and 0 latitudes have less angular error.
 
 [[ProjectionErrorsSinusoidal5]]
 .Zoom in of angle error at 62.65, 180. The values are the number of degrees off from the expected angle measurement. The zoom area is pointed to by the red arrow in <<ProjectionErrorsSinusoidal4>>.
-image::algorithms/images/ProjectionErrorsSinusoidal5.png[]
+image::images/ProjectionErrorsSinusoidal5.png[]
 
 The desired star pattern is a point with equally spaced rays radiating out with 20deg spacing creating a half circle instead of an ellipse. The star patterns closer to 0 longitudes and latitudes look much more like a circle.
 
 === Summary Test Results
- 
+
 [[ProjectionErrorsGraph1]]
 .Distance errors for various test cases. The expected results are 1km for each of the measured values. A value of zero is no error (perfect). The box plots show the minimum, Q1, median, Q3 and maximum error. AEAC is Alber’s Equal Area Conic)
-image::algorithms/images/ProjectionErrorsGraph1.png[]
+image::images/ProjectionErrorsGraph1.png[]
 
 The above test case shows the distance error results for six different projections. There can be dramatic differences in distance error from one region to another. The Alber’s Equal Area Conic (AEAC) and Orthographic projections do not support all the test bounding boxes. When the bounding box is not supported the test results are omitted.
- 
+
 [[ProjectionErrorsGraph2]]
 .Angle errors for various test cases. A value of zero denotes no difference from the expected results (perfect). The box plots show the minimum, Q1, median, Q3 and maximum error.
-image::algorithms/images/ProjectionErrorsGraph2.png[]
+image::images/ProjectionErrorsGraph2.png[]
 
 The above test case shows the angle error results for six different projections. Similar to the distance results there can be dramatic differences in angle error from one region to another. The Alber’s Equal Area Conic (AEAC) and Orthographic projections do not support all the test bounding boxes. When the bounding box is not supported the test results are omitted.
 
@@ -164,7 +164,7 @@ score = max distance error / 10m + max angle error / 2deg
 --------------------------------------
 endif::HasLatexMath[]
 
-The projection with the lowest score that also meets the threshold requirements is picked as the best. If none of the projections meet the threshold requirements then a prominent warning message is presented to the user . 
+The projection with the lowest score that also meets the threshold requirements is picked as the best. If none of the projections meet the threshold requirements then a prominent warning message is presented to the user .
 
 Running an experiment against all the above projections takes approximately 40ms on circa 2012 hardware (AMD FX-8150). Since a projection is generally selected once or twice per conflation run it is unlikely that this will add a significant cost to the overall runtime.
 
Clone this wiki locally