How-to Use the Geoid Model Utility program
This How-to describes how to create a geoid model using the Geoid Model Utility program.
To convert a third party geoid file to a binary geoid file which QINSy accepts, a few steps need to be taken:
- Adjust the GEOIDMODELS.XML file, see the Howto document How-to Update Geoid Models.xml
- Convert the geoid file
- Set up a Database containing the correct geodetic settings, including the geoid model to be created
QINSy geoid model files
Most geoid models are available as ASCII files containing height values on a regular geographical grid.
In order to obtain the necessary real-time file seeking speed, QINSy can only use binary files in "LLDLLD" or "NGS" format, except for DLL's or river line models.
Files in other formats must therefore be converted using the Geoid Model Utility which can be found in the QINSy Console.
A geoid file must be a rectangular grid (except for river models), but may contain a so-called mask: grid points where the geoid heights are not defined.
Such geoid heights must be indicated by values less than -999 or larger than 999.
Most geoid files must contain geoid heights on coordinate lines starting at the northern-most latitude (or northing) going from west to east, until the southern-most latitude (or northing), i.e. from the north-west corner to the south-east corner.
One exception is the binary grid file format from NGS, which starts at the south-west corner, going from south to north.
The other exception to this rule are the geoid files containing river models, defined along one or more survey lines.
A list of file formats and files that are supported by the Geodetic Library.
Convert ASCII file to BIN file
After you have changed the GEOIDMODELS.XML file, you may need to convert the ASCII file in the Geoid Model Utility.
This will be the case when you have a model in a format which is not supported by QINSy.
Geoid model files should be located in the <\Geoid > subdirectory of the QINSy installation directory (e.g. <C:\Program Files\QPS\QINSy 8.x0\Geoid>), so it is easiest to put the file that needs to be converted (GEOID.TXT in the example above) also in that directory.
- Open the Geoid Model Utility from the QINSy Console.
(If the utility is not visible yet, right-click with your mouse button, select 'Add/Remove QPS Programs' and add it).
- Open the Computation Mode drop down list and select the 'Convert Geoid File' option.
- Open the Computation Model list and select the 'input file' you just entered in the GEOIDMODELS.XML setup file.
- Make sure the QINSy Database is the template database that contains the proper geodetic conversion settings.
- Make sure the Geoid Data File is the 'input file' you entered in the GEOIDMODELS.XML.
- Click 'Convert' button and wait until the conversion process creates the 'output file'.
- Check if the minimum and maximum values of your file are consistent with the outcome of the Geoid Model Utility.
- Open the Computation Mode dropdown list and select the 'Compute Geoid Height' option.
- Make sure the Geoid Data File is the 'output file' you entered in the GEOIDMODELS.XML.
Enter a known Input Position, click 'Calculate' and check Output Results to see if the conversion went correctly.
Select model in Database Setup
After the binary geoid model file is created, you can select it in the Database Setup program as Mean Water Level Model (in order to compute height aiding observations) or as Vertical Datum (for height results and fixed nodes).
If it is not visible in the drop down lists, the file is probably not located in the <\Geoid > subdirectory of the QINSy installation directory (or status="disabled" is used in GEOIDMODELS.XML).