Check the coordinate pipelines

Run this after installing or upgrading a server, after changing grids, and whenever a coordinate result looks wrong. It proves on this machine that every pipeline gives the official coordinates.

Before you start

• ruumica is installed and PROJ_NETWORK=OFF is set.

Steps

1. Verify one pipeline, or all of them with --all:

   $ asbuilt crs verify --pipeline no.euref89.utm33-nn2000.v1
   …
   no.euref89.utm33-nn2000.v1         official=6  pass=6   fail=0   grid_absent=0   OK
       grid no_kv_HREF2018B_NN2000_EUREF89.tif       ok
   

   Each pipeline line counts its official test points and how many pass; each grid line says whether the grid file is the registered one. The first line names the PROJ version of this machine.

2. If a pipeline needs a grid that is not installed yet, allow that explicitly while you wait for it: asbuilt crs verify --all --allow-grid-absent 'ee.*'. The test points of that pipeline then report GRID_ABSENT instead of failing.

3. Prove that a missing grid stops the program instead of giving positions without height: asbuilt crs verify --missing-grid-must-fail.

4. To convert a single position by hand, use asbuilt crs transform:

   $ asbuilt crs transform --pipeline no.euref89.utm32-nn2000.v1 10.75 59.91 100.0
   597868.381 6642681.510 60.896
   

Check

Every pipeline you deliver with ends in OK, with fail=0.

What can go wrong

You see	Meaning	Do
FAIL	A test point is not reached within tolerance.	Do not deliver from this machine. Check the grids and the PROJ installation.
ABSENT	A grid is not installed.	Install it: the installer for Nordic grids, Install the Estonian geoid model for Estonia.
MISMATCH	A grid file differs from the registered one.	Install the registered file again.
HASH_PENDING	A grid is installed, but its fingerprint is not recorded.	Install it with its script, which records the fingerprint.