Package pyrdnap :: Module rdnap2018 :: Class RDNAP2018v2

Class RDNAP2018v2

            object --+            
                     |            
pygeodesy.named._Named --+        
                         |        
pygeodesy.named._NamedBase --+    
                             |    
                    _RDNAPbase --+
                                 |
                                RDNAP2018v2

Transformer implementing variant 2 of the RDNAPTRANS(tm)2018_v220627 specification.

Note: Method RDNAP2018v2.reverse returns by default validated Bessel1841 (RD-Bessel) geodetic lat-, longitude and datum.

Instance Methods

__init__(self, a_ellipsoid=None, f=None, raiser=False, **name)
New RDNAP2018v1 or -v2 instance.

forward(self, lat, lon, height=0, raiser=None, name='forward')
Convert GRS80 (ETRS98) geodetic (lat, lon) and height to local (RDx, RDy) coordinates and NAPh quasi-geoid-height.

forward3(self, lat, lon, name='forward3')
Datum-transform (lat, lon) from GRS80 (ETRS98) to Bessel1841 (RD-Bessel) as specified by RDNAPTRANS(tm)2018_v220627.

isinside(self, lat, lon, asRD=True, eps=0)
Is geodetic (lat, lon) inside the RD or ETRS region?

rdNAPh(self, lat, lon, raiser=False)
Interpolate the NAPh quasi-geoid-height for a point (lat, lon) within the RD region.

region4(self, asRD=True)
Get the South, West, North and East bounds of the RD or ETRS region.

reverse(self, RDx, RDy, NAPh=0, asRD=True, **raiser_name)
Convert a local (RDx, RDy) point and NAPh height to Bessel1841 (RD-Bessel) geodetic (lat, lon, height) by default.

reverse3(self, lat, lon, name='reverse3')
Datum-transform (lat, lon) from Bessel1841 (RD-Bessel) to GRS80 (ETRS98) as specified by RDNAPTRANS(tm)2018_v220627.

similarity(self, *unused)
Get the similarity transform, always None.

Inherited from _RDNAPbase: toStr

Inherited from pygeodesy.named._NamedBase: __repr__, __str__, others, toRepr

Inherited from pygeodesy.named._Named: __format__, __imatmul__, __matmul__, __rmatmul__, attrs, classof, copy, dup, methodname, rename, renamed, toStr2

Inherited from object: __delattr__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __setattr__, __sizeof__, __subclasshook__

Properties

variant

Inherited from _RDNAPbase: forwardDatum, region, reverseDatum

Inherited from pygeodesy.named._Named: classname, classnaming, iteration, name, named, named2, named3, named4, sizeof, typename

Inherited from object: __class__

Method Details

init (self, a_ellipsoid=None, f=None, raiser=False, **name)
(Constructor)

New RDNAP2018v1 or -v2 instance.

Arguments:

a_ellipsoid - An ellipsoid (Ellipsoid) or the ellipsoid's equatorial radius (scalar, conventionally in meter), see f or a datum (Datum). Default Datums.GRS80 for ETRS89.
f - The flattening of the ellipsoid (scalar) if a_ellipsoid is specified as scalar, ignored otherwise.
raiser - If True raise an RDNAPError for lat-/longitudes outside the RD region (bool).
name - Optional name (str).

Raises:

RDNAPError - Ellipsoid (or datum) is not oblate (i.e. is spherical or prolate) or the datum's transform is not unity.

Overrides: object.__init__

forward (self, lat, lon, height=0, raiser=None, name=`'forward'`)

Convert GRS80 (ETRS98) geodetic (lat, lon) and height to local (RDx, RDy) coordinates and NAPh quasi-geoid-height.

Arguments:

lat - Latitude (degrees geodetic).
lon - Longitude (degrees geodetic).
height - Height, optional (meter above geoid) or NAN to ignore NAPh interpolation.
raiser - If True raise an RDNAPError if lat or lon is outside the RD region (bool), if False don't, overriding property raiser.
name - Optional name (str).

Returns:

An RDNAP7Tuple

(RDx, RDy, NAPh, lat, lon, 
          height, datum)

with local RDx, RDy coordinates and NAPh height.

Overrides: _RDNAPbase.forward

forward3 (self, lat, lon, name=`'forward3'`)

Datum-transform (lat, lon) from GRS80 (ETRS98) to Bessel1841 (RD-Bessel) as specified by RDNAPTRANS(tm)2018_v220627.

Returns:: A LatLonDatum3Tuple(lat, lon, datum) with datum and lat and lon all Bessel1841 (RD-Bessel).
Overrides: _RDNAPbase.forward3

isinside (self, lat, lon, asRD=True, eps=0)

Is geodetic (lat, lon) inside the RD or ETRS region?

Arguments:

asRD - Use asRD=False for the ETRS region and in case (lat, lon) are ETRS89 (GRS80), not Bessel1841 (RD_Bessel) (bool).
eps - Over-/undersize the ETRS or RD region (degrees).

Returns:

True if inside or on, False otherwise.

Overrides: _RDNAPbase.isinside

rdNAPh (self, lat, lon, raiser=False)

Interpolate the NAPh quasi-geoid-height for a point (lat, lon) within the RD region.

Arguments:

lat - Latitude (degrees, RD-Bessel geodetic).
lon - Longitude (degrees, RD-Bessel geodetic).
raiser - If True raise an RDNAPError if lat or lon is outside the RD region (bool), otherwise don't and return NAN.

Returns:

NAPh (meter) or NAN if raiser is False and lat or lon is outside the RD region.

Overrides: _RDNAPbase.rdNAPh

region4 (self, asRD=True)

Get the South, West, North and East bounds of the RD or ETRS region.

Arguments:

asRD - Use asRD=False to get the ETRS (ETRS89) instead of the RD (RD-Bessel) region (bool).

Returns:

A Bounds4Tuple

(latS, lonW, latN, 
          lonE)

with RD-Bessel (Bessel1841) or ETRS (ETRS89) geodetic lat- and longtudes.

Overrides: _RDNAPbase.region4

reverse (self, RDx, RDy, NAPh=0, asRD=True, **raiser_name)

Convert a local (RDx, RDy) point and NAPh height to Bessel1841 (RD-Bessel) geodetic (lat, lon, height) by default.

Arguments:

RDx - Local RD X (meter, conventionally).
RDy - Local RD Y (meter, conventionally).
NAPh - NAP quasi-geoid-height (meter, conventionally) or NAN to ignore NAPh interpolation.
asRD - Use asRD=False to return (non-validated) GRS80 (ETRS89) instead of (validated) Bessel1841 (RD-Bessel) geodetic lat- and longitudes (bool).
raiser_name - Like the forward method, raiser=None (bool) and optional name='reverse' (str).

Returns:

An RDNAP7Tuple

(RDx, RDy, NAPh, lat, lon, 
          height, datum)

with geodetic lat and lon, height and datum Bessel1841 (RD-Bessel) or GRS80 (ETRS89).

Note: RDNAP2018v2.reverse has been validated only for default asRD=True per RDNAPTRANS(tm)2018_v220627.

reverse3 (self, lat, lon, name=`'reverse3'`)

Datum-transform (lat, lon) from Bessel1841 (RD-Bessel) to GRS80 (ETRS98) as specified by RDNAPTRANS(tm)2018_v220627.

Returns:: A LatLon3Tuple(lat, lon, datum) with datum and lat and lon all GRS80 (ETRS89).
Overrides: _RDNAPbase.reverse3

similarity (self, *unused)

Get the similarity transform, always None.

Overrides: _RDNAPbase.similarity

Property Details

variant

Get method:: _fget(inst) - Get the property value, only once and memoize/cache it.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(*unused) - Silently ignored, always.

Class RDNAP2018v2

__init__ (self, a_ellipsoid=None, f=None, raiser=False, **name) (Constructor)

forward (self, lat, lon, height=0, raiser=None, name='forward')

forward3 (self, lat, lon, name='forward3')

isinside (self, lat, lon, asRD=True, eps=0)

rdNAPh (self, lat, lon, raiser=False)

region4 (self, asRD=True)

reverse (self, RDx, RDy, NAPh=0, asRD=True, **raiser_name)

reverse3 (self, lat, lon, name='reverse3')

similarity (self, *unused)

variant

init (self, a_ellipsoid=None, f=None, raiser=False, **name)
(Constructor)

forward (self, lat, lon, height=0, raiser=None, name=`'forward'`)

forward3 (self, lat, lon, name=`'forward3'`)

reverse3 (self, lat, lon, name=`'reverse3'`)