Package pyrdnap

A pure Python implementation of the 2018 version of Netherlands' RD NAP specification to convert between GRS80 (ETRS89) geodetic lat-, longitudes and height and local RijksDriehoeksmeeting (RD) coordinates and Normaal Amsterdams Peil (NAP) quasi-geoid-height.

See module pyrdnap.rdnap2018 for further information and usage, implementation details.

See modules pyrdnap.v1grid and pyrdnap.v2grid for the original RDNAPTRANS2018_v220627, unmodified .txt grid files for each variant, but compressed as .txt.zip.

See function pyrdnap.validation3 for self-validation testing details.

See file testresults/Z001_ETRSandRDNAP_v1_results.txt for the self-validation test results of the RDNAP2018v1 transformer, especially the final, summary lines.

Note: PyRDNAP and pyrdnap have not been formally validated and are not certified to carry the trademark RDNAPTRANS(tm).

Version: 26.05.26

Submodules

pyrdnap.__main__: Run a RD NAP 2018 forward or reverse conversion example or run the NSGI or RD NAP 2018 validation test set in "round-trip" fashion.
pyrdnap.__pygeodesy: (INTERNAL) pyrdnap access to some private pygeodesy attributes.
pyrdnap.rd0: (INTERNAL) RijksDriehoeksmeting _RD and reference _RD0 constants and classes RDNAP7Tuple and LqRD.
pyrdnap.rdnap2018: Main classes RDNAP2018v1 and RDNAP2018v2 follow variant 1 respectively variant 2 of the RDNAPTRANS(tm)2018_v220627 specification.
pyrdnap.v1grid: Extract from the original, compressed, variant 1 grid files nlgeo2018.txt.zip and rdcorr2018.txt.zip the NAP_..., lat_corr_ and lon_corr_ columns only and encode each in Python as a row-order matrix, a 481-tuple of 301-arrays of single- or double precision floats.
pyrdnap.v2grid: Extract from the original, compressed, variant 2 grid files naptrans2018.txt.zip and rdtrans2018.txt.zip the NAP_..., lat_corr_ and lon_corr_ columns only and encode each in Python as a row-order matrix, a 481-tuple of 301-arrays of single- or double precision floats.
pyrdnap.v_grids: (INTERNAL) RD NAP 2018 v#grid utilities.
pyrdnap.v_self: Function validation3 to run the RD NAP 2018 self-validation tests .../RDNAPTRANS2018_v220627/.../Z001_ETRS89andRDNAP.txt obtainable from NSGI.NL after registration.

Classes
	Bounds4Tuple 4-Tuple `(latS, lonW, latN, lonE)` with the bounds' lower-left `(LatS, LowW)` and upper-right `(latN, lonE)` corner lat- and longitudes.
	Datum Ellipsoid and transform parameters for an earth model.
	Ellipsoid Ellipsoid with equatorial and polar radii, flattening, inverse flattening and other, often used, cached attributes, supporting oblate and prolate ellipsoidal and spherical earth models.
	LatLon2Tuple 2-Tuple `(lat, lon)` in `degrees90` and `degrees180`.
	LqRD Like pygeodesy.LqRD but with methods `forward` and `reverse` returning an RDNAP7Tuple with `NAPh` replaced by local `z`, the perpendicular distance to the local tangent plane (LTP).
	PhiLam2Tuple 2-Tuple `(phi, lam)` with latitude `phi` in `radians[PI_2]` and longitude `lam` in `radians[PI]`.
	RDNAP2018v1 Transformer implementing `variant 1` of RD NAP 2018 v220627.
	RDNAP2018v2 Transformer implementing `variant 2` of RD NAP 2018 v220627.
	RDNAP7Tuple 7-Tuple `(RDx, RDy, NAPh, lat, lon, height, datum)` with local `RDx`, `RDy` and `NAPh` quasi-geoid_height, geodetic `lat`, `lon`, `height` and `datum` with `lat` and `lon` in `degrees` and `RDx`, `RDy`, `NAPh` and `height` in `meter`, conventionally.
	RDNAPError Error raised for `RD`, `NAP` and unzip issues.
	Similarity Similarity transformation.
	Vector2Tuple 2-Tuple `(x, y)` of (geocentric) components, each in `meter` or the same `units`.
	Vector3Tuple 3-Tuple `(x, y, z)` of (geocentric) components, all in `meter` or the same `units`.

Functions

validation3(self_txt, R, all_=False, in_out=True, _print=None, _printest=None)
Run the official RD NAP 2018 self-validation tests.

Variables
	pyrdnap_abspath = `'..../PyRDNA...`
	Datums = `Datums.Sphere: Datum(name='Sphere', ellipsoid=Ellipso...`

Function Details

validation3 (self_txt, R, all_=False, in_out=True, _print=None, _printest=None)

Run the official RD NAP 2018 self-validation tests.

Arguments:

self_txt - Name of the file containing the RD NAP 2018 self-validation tests (str), .../RDNAPTRANS2018_v220627/.../Z001_ETRS89andRDNAP.txt.
R - An RDNAP2018v# transformer (RDNAP2018v1 or RDNAP2018v2 instance).
all_ - If True print all tests and test results, otherwise only failing tests (bool).
in_out - If True test only points inside the RD region, if False only points outside (bool).
_print - A Python 3+ print-like callable or None to not print the header and the final, summary lines.
_printest - A Python 3+ print-like callable or None to not print all_ in_out tests or only the failing ones.

Returns:

3-Tuple (failed, total, in_outside) with the number of FAILED tests, the total number of tests and the number of points in_out the RD region.

Variables Details

pyrdnap_abspath

Value:

'..../PyRDNAP/pyrdnap'

Datums

Value:

Datums.Sphere: Datum(name='Sphere', ellipsoid=Ellipsoids.Sphere, trans
form=Transforms.WGS84),
Datums.NAD83: Datum(name='NAD83', ellipsoid=Ellipsoids.GRS80, transfor
m=Transforms.NAD83),
Datums.OSGB36: Datum(name='OSGB36', ellipsoid=Ellipsoids.Airy1830, tra
nsform=Transforms.OSGB36),
Datums.WGS84: Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transfor
m=Transforms.WGS84),
...