Package pygeodesy :: Package geodesicx :: Module gxline :: Class _GeodesicLineExact
[frames] | no frames]

Class _GeodesicLineExact

  object --+                
           |                
named._Named --+            
               |            
named._NamedBase --+        
                   |        
    karney._CapsBase --+    
                       |    
   gxbases._GeodesicBase --+
                           |
                          _GeodesicLineExact
Known Subclasses:

(INTERNAL) Base class for GeodesicLineExact.

Instance Methods
 
__init__(self, gX, lat1, lon1, azi1, caps, _debug, *salp1_calp1, **name)
(INTERNAL) New [_]GeodesicLineExact instance.
 
__del__(self)
 
ArcPosition(self, a12, outmask=3968)
Find the position on the line given a12.
 
Position(self, s12, outmask=3968)
Find the position on the line given s12.
 
SetArc(self, a13)
Set reference point 3 in terms of distance to the first point.
 
SetDistance(self, s13)
Set reference point 3 in terms of distance to the first point.
 
toStr(self, prec=6, sep=', ', **unused)
Return this GeodesicLineExact as string.

Inherited from karney._CapsBase: caps_

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

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

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

Class Variables

Inherited from karney._CapsBase: ALL, AREA, AZIMUTH, DISTANCE, DISTANCE_IN, EMPTY, GEODESICSCALE, LATITUDE, LINE_OFF, LONGITUDE, LONG_UNROLL, REDUCEDLENGTH, STANDARD

Properties
  a1
Get the equatorial arc (degrees), the arc length between the northward equatorial crossing and the first point.
  equatorarc
Get the equatorial arc (degrees), the arc length between the northward equatorial crossing and the first point.
  a13
Get (spherical) arc length from the first to the reference point (degrees).
  azi0
Get the equatorial azimuth, the azimuth of this geodesic line as it crosses the equator in a northward direction (degrees90).
  equatorazimuth
Get the equatorial azimuth, the azimuth of this geodesic line as it crosses the equator in a northward direction (degrees90).
  azi0_sincos2
Get the sine and cosine of the equatorial azimuth (2-tuple (sin, cos)).
  azi1
Get the azimuth at the first point (compass degrees).
  azi1_sincos2
Get the sine and cosine of the first point's azimuth (2-tuple (sin, cos)).
  geodesic
Get the exact geodesic (GeodesicExact).
  lat1
Get the latitude of the first point (degrees).
  lon1
Get the longitude of the first point (degrees).
  s13
Get the distance from the first to the reference point (meter).

Inherited from karney._CapsBase: caps, debug

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

Inherited from object: __class__

Method Details

__init__ (self, gX, lat1, lon1, azi1, caps, _debug, *salp1_calp1, **name)
(Constructor)

 

(INTERNAL) New [_]GeodesicLineExact instance.

Overrides: object.__init__

ArcPosition (self, a12, outmask=3968)

 

Find the position on the line given a12.

Arguments:
  • a12 - Spherical arc length from the first point to the second point (degrees).
  • outmask - Bit-or'ed combination of Caps values specifying the quantities to be returned.
Returns:
A GDict with up to 12 items lat1, lon1, azi1, lat2, lon2, azi2, m12, a12, s12, M12, M21, S12 with lat1, lon1, azi1 and arc length a12 always included, except when a12=NAN.

Note: By default, outmask=STANDARD, meaning thc lat1, lon1, azi1, lat2, lon2, azi2, s12 and a12 entries are returned, except when a12=NAN.

Position (self, s12, outmask=3968)

 

Find the position on the line given s12.

Arguments:
  • s12 - Distance from the first point to the second (meter).
  • outmask - Bit-or'ed combination of Caps values specifying the quantities to be returned.
Returns:
A GDict with up to 12 items lat1, lon1, azi1, lat2, lon2, azi2, m12, a12, s12, M12, M21, S12 with lat1, lon1, azi1 and arc length a12 always included, except when a12=NAN.
Notes:
  • By default, outmask=STANDARD, meaning thc lat1, lon1, azi1, lat2, lon2, azi2, s12 and a12 entries are returned, except when a12=NAN.
  • This GeodesicLineExact instance must have been constructed with capability Caps.DISTANCE_IN set.

SetArc (self, a13)

 

Set reference point 3 in terms of distance to the first point.

Arguments:
  • a13 - Spherical arc length from the first to the reference point (degrees).
Returns:
The distance s13 (meter) between the first and the reference point or NAN.

SetDistance (self, s13)

 

Set reference point 3 in terms of distance to the first point.

Arguments:
  • s13 - Distance from the first to the reference point (meter).
Returns:
The arc length a13 (degrees) between the first and the reference point or NAN.

toStr (self, prec=6, sep=', ', **unused)

 

Return this GeodesicLineExact as string.

Arguments:
  • prec - The float precision, number of decimal digits (0..9). Trailing zero decimals are stripped for prec values of 1 and above, but kept for negative prec values.
  • sep - Separator to join (str).
Returns:
GeodesicLineExact (str).
Overrides: named._Named.toStr

Property Details

a1

Get the equatorial arc (degrees), the arc length between the northward equatorial crossing and the first point.

Get method:
a1(self) - Get the equatorial arc (degrees), the arc length between the northward equatorial crossing and the first point.
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

equatorarc

Get the equatorial arc (degrees), the arc length between the northward equatorial crossing and the first point.

Get method:
a1(self) - Get the equatorial arc (degrees), the arc length between the northward equatorial crossing and the first point.
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

a13

Get (spherical) arc length from the first to the reference point (degrees).

Get method:
a13(self) - Get (spherical) arc length from the first to the reference point (degrees).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

See Also: Method SetArc.

azi0

Get the equatorial azimuth, the azimuth of this geodesic line as it crosses the equator in a northward direction (degrees90).

Get method:
azi0(self) - Get the equatorial azimuth, the azimuth of this geodesic line as it crosses the equator in a northward direction (degrees90).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

equatorazimuth

Get the equatorial azimuth, the azimuth of this geodesic line as it crosses the equator in a northward direction (degrees90).

Get method:
azi0(self) - Get the equatorial azimuth, the azimuth of this geodesic line as it crosses the equator in a northward direction (degrees90).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

azi0_sincos2

Get the sine and cosine of the equatorial azimuth (2-tuple (sin, cos)).

Get method:
azi0_sincos2(self) - Get the sine and cosine of the equatorial azimuth (2-tuple (sin, cos)).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

azi1

Get the azimuth at the first point (compass degrees).

Get method:
azi1(self) - Get the azimuth at the first point (compass degrees).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

azi1_sincos2

Get the sine and cosine of the first point's azimuth (2-tuple (sin, cos)).

Get method:
azi1_sincos2(self) - Get the sine and cosine of the first point's azimuth (2-tuple (sin, cos)).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

geodesic

Get the exact geodesic (GeodesicExact).

Get method:
geodesic(self) - Get the exact geodesic (GeodesicExact).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

lat1

Get the latitude of the first point (degrees).

Get method:
lat1(self) - Get the latitude of the first point (degrees).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

lon1

Get the longitude of the first point (degrees).

Get method:
lon1(self) - Get the longitude of the first point (degrees).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

s13

Get the distance from the first to the reference point (meter).

Get method:
s13(self) - Get the distance from the first to the reference point (meter).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

See Also: Method SetDistance.