Package pygeodesy :: Module geoids :: Class GeoidKarney
[frames] | no frames]

Class GeoidKarney

     object --+            
              |            
   named._Named --+        
                  |        
heights._HeightBase --+    
                      |    
             _GeoidBase --+
                          |
                         GeoidKarney

Geoid height interpolator for Charles Karney's GeographicLib Earth Gravitational Model (EGM) geoid egm*.pgm datasets using bilinear or cubic interpolation and caching in pure Python transcribed from Karney's C++ class Geoid.

Use any of the geoid egm84-, egm96- or egm2008-*.pgm datasets.

Instance Methods
 
__init__(self, egm_pgm, crop=None, datum=None, kind=3, name='', smooth=None)
New GeoidKarney interpolator.
 
__call__(self, *llis)
Interpolate the geoid height for one or several locations.
 
height(self, lats, lons)
Interpolate the geoid height for one or several lat-/longitudes.

Inherited from _GeoidBase: __repr__, __str__, center, highest, lowerleft, lowerright, lowest, outside, toStr, upperleft, upperright

Inherited from named._Named: classof, copy, toStr2

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

Properties
  dtype
Get the geoid's grid data type (str).
  pgm
Get the PGM attributes (_PGM).
  u2B
Get the PGM itemsize in bytes (int).

Inherited from _GeoidBase: endian, hits, kind, knots, mean, nBytes, name, numpy, scipy, sizeB, smooth, stdev

Inherited from named._Named: classname, classnaming, named, named2

Inherited from object: __class__

Method Details

__init__(self, egm_pgm, crop=None, datum=None, kind=3, name='', smooth=None)
(Constructor)

 

New GeoidKarney interpolator.

Parameters:
  • egm_pgm - An EGM geoid dataset file name (egm*.pgm).
  • crop - Optional box to limit geoid locations, a 4-tuple (south, west, north, east), 2-tuple ((south, west), (north, east)) or 2, in degrees90 lat- and degrees180 longitudes or a 2-tuple (LatLonSW, LatLonNE) of LatLon instances.
  • datum - Optional grid datum (Datum), default WGS84.
  • kind - Interpolation order (int), 2 for bilinear or 3 for cubic.
  • name - Optional geoid name (str).
  • smooth - Smoothing factor, unsupported (None).
Raises:
  • GeoidError - EGM dataset egm_pgm issue or invalid crop, kind or smooth.
Overrides: object.__init__

See Also: Class GeoidPGM and function egmGeoidHeights.

__call__(self, *llis)
(Call operator)

 

Interpolate the geoid height for one or several locations.

Parameters:
  • llis - The location or locations (LatLon, ... or LatLons).
Returns:
A single interpolated geoid height (float) or a list or tuple of interpolated geoid heights (floats).
Raises:
  • GeoidError - Insufficient number of llis or an invalid lli.
  • RangeError - An lli is outside this geoid's lat- or longitude range.
Overrides: heights._HeightBase.__call__

height(self, lats, lons)

 

Interpolate the geoid height for one or several lat-/longitudes.

Parameters:
  • lats - Latitude or latitudes (degrees or degreess).
  • lons - Longitude or longitudes (degrees or degreess).
Returns:
A single interpolated geoid height (float) or a list of interpolated geoid heights (floats).
Raises:
  • GeoidError - Insufficient or non-matching number of lats and lons.
  • RangeError - A lat or lon is outside this geoid's lat- or longitude range.
Overrides: _GeoidBase.height

Property Details

dtype

Get the geoid's grid data type (str).

Get Method:
dtype(self) - Get the geoid's grid data type (str).
Set Method:
Read_Only(self, ignored) - Throws an AttributeError, always.

pgm

Get the PGM attributes (_PGM).

Get Method:
pgm(self) - Get the PGM attributes (_PGM).
Set Method:
Read_Only(self, ignored) - Throws an AttributeError, always.

u2B

Get the PGM itemsize in bytes (int).

Get Method:
u2B(self) - Get the PGM itemsize in bytes (int).
Set Method:
Read_Only(self, ignored) - Throws an AttributeError, always.