Skip to content

Commit b55ab4c

Browse files
committed
add plugin - custom geoid
1 parent 3f44437 commit b55ab4c

18 files changed

Lines changed: 38 additions & 5 deletions

src/gis/elevations/index.md

Lines changed: 36 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ When collecting data in the field, <MobileAppName /> provides information about
1111

1212
An *orthometric* height is a physical height referred to a *geoid*, a special surface that resembles the mean sea level. The difference between ellipsoidal and orthometric height is called the *geoid separation* (also known as geoid height or undulation) and it can be applied to transform between these heights.
1313

14-
When transforming elevations from ellipsoidal to orthometric, <MainPlatformNameLink /> uses the EGM96 geoid model by default. However, it is also possible to use another geoid model as described in the [Using custom geoid](#using-custom-geoid) section. This may be especially useful when conducting more precise surveys or when a specific vertical reference system is required.
14+
When transforming elevations from ellipsoidal to orthometric, <MainPlatformNameLink /> uses the EGM96 geoid model by default. However, it is also possible to use another geoid model as described in the [Using custom geoid](#using-custom-geoid) section. This may be especially useful when conducting more precise surveys or when a specific vertical reference system is required.
1515

1616
:::warning Learn more
1717
Height systems and elevations are complex topics. If you want to get more insight, we recommend going through some explanatory resources, such as [Height Systems](https://geodesy.science/item/height-systems/) by the International Association of Geodesy.
@@ -103,5 +103,39 @@ If there is no [user-defined transformation](#using-custom-geoid) (custom geoid)
103103

104104
The geoid model can be specified in [<MainPlatformName /> Project Properties](../../manage/plugin/#mergin-maps-project-properties) in QGIS. The grid shift file will be packaged with the project based on the selected vertical reference system.
105105

106-
In the <MobileAppNameShort />, the info about the custom geoid model is displayed in [GPS info panel](../../field/mobile-app-ui/#current-position-and-gps-info).
106+
In the <MobileAppNameShort />, the info about the custom geoid model is displayed in the [GPS info panel](../../field/mobile-app-ui/#current-position-and-gps-info).
107107

108+
1. Open your <MainPlatformName /> project and navigate to the <MainPlatformName /> tab in **Project Properties**
109+
110+
2. Check the *Report height in a specific vertical CRS* option :heavy_check_mark:
111+
![Mergin Maps QGIS plugin vertical CRS](./plugin-vertical-crs.webp "Mergin Maps QGIS plugin vertical CRS")
112+
113+
3. Select a vertical CRS from the list or use the **Select CRS** button to choose from predefined CRS.
114+
115+
Use the filter to narrow the search using a keyword or the EPSG code.
116+
117+
Select a CRS and click **OK**.
118+
![Select target vertical CRS in QGIS](./plugin-target-vertical-crs.webp "Select target vertical CRS in QGIS")
119+
120+
4. **Apply** the changes in **Project Properties** and synchronise your changes.
121+
![Mergin Maps QGIS plugin defined vertical CRS](./plugin-set-vertical-crs.webp "Mergin Maps QGIS plugin defined vertical CRS")
122+
123+
When recording and displaying heights in the <MobileAppNameShort />, the custom geoid will be used instead of the default EGM96 model.
124+
125+
### Multiple datum transformation available
126+
For some vertical CRS, there may be multiple datum transformations available. If this is the case, you will get a warning when selecting the CRS.
127+
128+
![Mergin Maps QGIS plugin datum transformation warning](./plugin-transformation-warning.webp "Mergin Maps QGIS plugin datum transformation warning")
129+
130+
To make sure that <MainPlatformName /> uses the correct operation, ensure that the correct datum transformation is defined in the **Transformations** tab in **Project Properties**.
131+
132+
### Downloading grid shift files
133+
Some specific vertical CRS transformations may not be included in QGIS by default (see [custom projections in QGIS](../proj/#custom-projections-in-qgis)). In this the case, the <QGISPluginNameShort /> will display a warning that it needs to download the geoid grid file.
134+
135+
Use the **click here** link to download the grid.
136+
137+
![Mergin Maps QGIS plugin geoid grid download](./plugin-download-grid-shift.webp "Mergin Maps QGIS plugin geoid grid download")
138+
139+
The geoid grid will be downloaded and packaged with your project.
140+
141+
![Mergin Maps QGIS plugin geoid grid download](./plugin-grid-shift-downloaded.webp "Mergin Maps QGIS plugin geoid grid download")
21.8 KB
Loading
63.3 KB
Binary file not shown.
13.8 KB
Loading
46.7 KB
Binary file not shown.
49.1 KB
Loading
213 KB
Binary file not shown.
31.1 KB
Loading
160 KB
Binary file not shown.
20.1 KB
Loading

0 commit comments

Comments
 (0)