Package pyrdnap :: Module rdnap2018 :: Class RDNAP2018v1

Class RDNAP2018v1

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

Transformer implementing variant 1 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 (ellipsoidal) height to local RDx, RDy coordinates and (orthometric) height H.

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)
Interpolate the quasi-geoid NAPh height for a geodetic point.

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

reverse(self, RDx, RDy, H=0, **raiser_name)
Convert a local (RDx, RDy) point and (orthometric) height H to GRS80 (ETRS89) geodetic lat-, longitude and (ellipsoidal) height.

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 (Similarity).

Inherited from _RDNAPbase: bounds4, rdNAPh3, 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
Get this RDNAP2018's variant (int).

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 (name=NN 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 (ellipsoidal) height to local RDx, RDy coordinates and (orthometric) height H.

Arguments:

lat - Latitude (degrees geodetic).
lon - Longitude (degrees geodetic).
height - The (ellipsoidal) height (meter, conventionally) or None 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 optional name='forward' (str).

Returns:

An RDNAP7Tuple

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

with local RDx, RDy coordinates and (orthometric) height H in meter or 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.

Note: Orthometric height (H = h - NAPh) equals ellipsoidal height h less the quasi-geoid height NAPh.

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 - Local RD X (meter, conventionally).
RDy - Local RD Y (meter, conventionally).
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)

Interpolate the quasi-geoid NAPh height for a geodetic point.

Arguments:

lat - Latitude (degrees, geodetic).
lon - Longitude (degrees, geodetic).

Returns:

Quasi-geoid NAPh height N (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, H=0, **raiser_name)

Convert a local (RDx, RDy) point and (orthometric) height H to GRS80 (ETRS89) geodetic lat-, longitude and (ellipsoidal) height.

Arguments:

RDx - Local RD X (meter, conventionally).
RDy - Local RD Y (meter, conventionally).
H - The (orthometric) height (meter, conventionally) or None 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, H, lat, lon, height,
          datum)

with geodetic lat, lon and datum GRS80 (ETRS89) and (ellipsoidal) height in meter or 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.

Note: Ellipsoidal height (h = H + NAPh) equals orthometric height H plus the quasi-geoid height NAPh.

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 (Similarity).

Arguments:

inverse - Use True for the reverse or False for the forward transform (bool).

Overrides: _RDNAPbase.similarity

Property Details

variant

Get this RDNAP2018's variant (int).

Get method:: _fget(inst) - Get the property value once and overwrite self, this property instance in the (super-)class of self where this property is define as a property_ROver.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(*unused) - Silently ignored, always.

Class RDNAP2018v1

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

region4 (self, asRD=False)

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

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

similarity (self, inverse=False)

variant

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