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.

Instance Methods

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

forward(self, lat, lon, height=0, **raiser_name)
Convert GRS80 (ETRS98) geodetic (lat, lon) and height to local RDx, RDy coordinates and NAPh quasi-geoid-height, provided the point is not outside the RD region.

forward3(self, lat, lon, **name)
Datum-transform (lat, lon) from GRS80 (ETRS98) to Bessel1841 (RD-Bessel) using only RDNAPTRANS(tm)2018_v220627's similarity.

isinside(self, lat, lon, eps=0)
Is geodetic (lat, lon) inside the RD region4?

isinsideRD(self, RDx, RDy, eps=0)
Is local (RDx, RDy) inside the RD region4?

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

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

reverse(self, RDx, RDy, NAPh=0, **raiser_name)
Convert a local (RDx, RDy) point and NAPh height to GRS80 (ETRS89) geodetic lat-, longitude and height, provided the point is not outside the RD region.

reverse3(self, lat, lon, **name)
Datum-transform (lat, lon) from Bessel1841 (RD-Bessel) to GRS80 (ETRS98) using only RDNAPTRANS(tm)2018_v220627's similarity.

similarity(self, inverse=False)
Get the similarity transform (None, always).

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, raiser, 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_name)

Convert GRS80 (ETRS98) geodetic (lat, lon) and height to local RDx, RDy coordinates and NAPh quasi-geoid-height, provided the point is not outside the RD region.

Arguments:

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

Returns:

An RDNAP7Tuple

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

with local RDx, RDy coordinates and NAPh height, all in meter or all NAN if lat or lon is outside the RD region.

Raises:

RDNAPError - If the point is outside the RD region and property raiser is True or keyword argument raiser=True.

forward3 (self, lat, lon, **name)

Datum-transform (lat, lon) from GRS80 (ETRS98) to Bessel1841 (RD-Bessel) using only RDNAPTRANS(tm)2018_v220627's similarity.

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

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

Is geodetic (lat, lon) inside the RD region4?

Arguments:

lat - Latitude (degrees, geodetic).
lon - Longitude (degrees, geodetic).
eps - Over-/undersize the RD region (degrees).

Returns:

None if lat or lon is NAN, False if outside the RD region, True otherwise.

Overrides: _RDNAPbase.isinside

isinsideRD (self, RDx, RDy, eps=0)

Is local (RDx, RDy) inside the RD region4?

Arguments:

RDx - X coordinate (meter, local).
RDy - Y coordinate (meter, local).
eps - Over-/undersize the RD region (meter).

Returns:

None if RDx or RDy is NAN, False if outside the RD region, True otherwise.

Overrides: _RDNAPbase.isinsideRD

rdNAPh (self, lat, lon, height=0)

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

Arguments:

lat - Latitude (degrees, geodetic).
lon - Longitude (degrees, geodetic).
height - Optional geoid height (meter, conventionally).

Returns:

NAPh quasi-geoid-height (meter) or NAN if lat or lon is outside the RD region.

Overrides: _RDNAPbase.rdNAPh

region4 (self, asRD=False)

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

Arguments:

asRd - Use asRD=True for the bounds in RD meter, otherwise degrees (bool).

Returns:

A Bounds4Tuple

(latS, lonW, latN, 
          lonE)

with geodetic lat- and longitudes in degrees or an RD4Tuple

(minRDx, minRDy, maxRDx, 
          maxRDy)

with the bounds in meter, truncated to millimeter.

Overrides: _RDNAPbase.region4

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

Convert a local (RDx, RDy) point and NAPh height to GRS80 (ETRS89) geodetic lat-, longitude and height, provided the point is not outside the RD region.

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.
raiser_name - Use raiser=True to raise an RDNAPError for points outside the RD region, overriding property raiser (bool) and an optional name='reverse' (str).

Returns:

An RDNAP7Tuple

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

with geodetic lat, lon and datum GRS80 (ETRS89) and height in meter or with lat, lon and height all NAN if outside the RD region.

Raises:

RDNAPError - If the point is outside the RD region and property raiser is True or keyword argument raiser=True.

reverse3 (self, lat, lon, **name)

Datum-transform (lat, lon) from Bessel1841 (RD-Bessel) to GRS80 (ETRS98) using only RDNAPTRANS(tm)2018_v220627's similarity.

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

similarity (self, inverse=False)

Get the similarity transform (None, always).

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_name)

forward3 (self, lat, lon, **name)

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

isinsideRD (self, RDx, RDy, eps=0)

rdNAPh (self, lat, lon, height=0)

region4 (self, asRD=False)

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

reverse3 (self, lat, lon, **name)

similarity (self, inverse=False)

variant

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