Package pygeodesy :: Module css :: Class CassiniSoldner
[frames] | no frames]

Class CassiniSoldner

  object --+        
           |        
named._Named --+    
               |    
named._NamedBase --+
                   |
                  CassiniSoldner

Cassini-Soldner projection, a Python version of Karney's C++ class CassiniSoldner.

Instance Methods
 
__init__(self, lat0, lon0, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran..., name='')
New CassiniSoldner projection.
 
forward(self, lat, lon, name='')
Convert an (ellipsoidal) geodetic location to Cassini-Soldner easting and northing.
 
forward4(self, lat, lon, name='')
Convert an (ellipsoidal) geodetic location to Cassini-Soldner easting and northing.
 
forward6(self, lat, lon, name='')
Convert an (ellipsoidal) geodetic location to Cassini-Soldner easting and northing.
 
reset(self, lat0, lon0)
Set or reset the center point of this Cassini-Soldner projection.
 
reverse(self, easting, northing, name='', LatLon=None, **LatLon_kwds)
Convert a Cassini-Soldner location to (ellipsoidal) geodetic lat- and longitude.
 
reverse4(self, easting, northing, name='')
Convert a Cassini-Soldner location to (ellipsoidal) geodetic lat- and longitude.
 
toLatLon(self, easting, northing, name='', LatLon=None, **LatLon_kwds)
Convert a Cassini-Soldner location to (ellipsoidal) geodetic lat- and longitude.
 
toRepr(self, prec=6, **unused)
Return a string representation of this projection.
 
toStr(self, prec=6, sep=' ', **unused)
Return a string representation of this projection.

Inherited from named._NamedBase: __repr__, __str__, others

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__

Properties
  datum
Get the datum (Datum).
  equatoradius
Get the ellipsoid's equatorial radius, semi-axis (meter).
  a
Get the ellipsoid's equatorial radius, semi-axis (meter).
  flattening
Get the ellipsoid's flattening (float).
  f
Get the ellipsoid's flattening (float).
  geodesic
Get this projection's wrapped,Karney Geodesic, provided package geographiclib is installed, otherwise a GeodesicExact instance.
  isExact
Return True if this projection's geodesic is GeodesicExact.
  lat0
Get the center latitude (degrees90).
  latlon0
Get the center lat- and longitude (LatLon2Tuple(lat, lon)) in (degrees90, (degrees180).
  lon0
Get the center longitude (degrees180).
  majoradius
DEPRECATED, use property equatoradius.

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

Inherited from object: __class__

Method Details

__init__ (self, lat0, lon0, datum=Datum(name='WGS84', ellipsoid=Ellipsoids.WGS84, transform=Tran..., name='')
(Constructor)

 

New CassiniSoldner projection.

Arguments:
  • lat0 - Latitude of center point (degrees90).
  • lon0 - Longitude of center point (degrees180).
  • datum - Optional datum or ellipsoid (Datum, Ellipsoid, Ellipsoid2 or a_f2Tuple).
  • name - Optional name (str).
Raises:
Overrides: object.__init__

Example:

>>> p = CassiniSoldner(48 + 50/60.0, 2 + 20/60.0)  # Paris
>>> p.forward(50.9, 1.8)  # Calais
(-37518.854545, 230003.561828)
>>> p.reverse4(-38e3, 230e3)
(50.899937, 1.793161, 89.580797, 0.999982)

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

 

Convert an (ellipsoidal) geodetic location to Cassini-Soldner easting and northing.

Arguments:
  • lat - Latitude of the location (degrees90).
  • lon - Longitude of the location (degrees180).
  • name - Name inlieu of this projection's name (str).
Returns:
An EasNor2Tuple(easting, northing).
Raises:

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

 

Convert an (ellipsoidal) geodetic location to Cassini-Soldner easting and northing.

Arguments:
  • lat - Latitude of the location (degrees90).
  • lon - Longitude of the location (degrees180).
  • name - Name inlieu of this projection's name (str).
Returns:
An EasNorAziRk4Tuple(easting, northing, azimuth, reciprocal).
Raises:

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

 

Convert an (ellipsoidal) geodetic location to Cassini-Soldner easting and northing.

Arguments:
  • lat - Latitude of the location (degrees90).
  • lon - Longitude of the location (degrees180).
  • name - Name inlieu of this projection's name (str).
Returns:
An EasNorAziRkEqu6Tuple(easting, northing, azimuth, reciprocal, equatorarc, equatorazimuth).
Raises:

reset (self, lat0, lon0)

 

Set or reset the center point of this Cassini-Soldner projection.

Arguments:
  • lat0 - Center point latitude (degrees90).
  • lon0 - Center point longitude (degrees180).
Raises:

reverse (self, easting, northing, name='', LatLon=None, **LatLon_kwds)

 

Convert a Cassini-Soldner location to (ellipsoidal) geodetic lat- and longitude.

Arguments:
  • easting - Easting of the location (meter).
  • northing - Northing of the location (meter).
  • name - Name inlieu of this projection's name (str).
  • LatLon - Optional, ellipsoidal class to return the geodetic location as (LatLon) or None.
  • LatLon_kwds - Optional (LatLon) keyword arguments, ignored if LatLon is None.
Returns:
Geodetic location LatLon or if LatLon is None, a LatLon2Tuple(lat, lon).
Raises:
  • CSSError - Ellipsoidal mismatch of LatLon and this projection.
  • TypeError - Invalid LatLon or LatLon_kwds.

reverse4 (self, easting, northing, name='')

 

Convert a Cassini-Soldner location to (ellipsoidal) geodetic lat- and longitude.

Arguments:
  • easting - Easting of the location (meter).
  • northing - Northing of the location (meter).
  • name - Name inlieu of this projection's name (str).
Returns:
A LatLonAziRk4Tuple(lat, lon, azimuth, reciprocal).

toLatLon (self, easting, northing, name='', LatLon=None, **LatLon_kwds)

 

Convert a Cassini-Soldner location to (ellipsoidal) geodetic lat- and longitude.

Arguments:
  • easting - Easting of the location (meter).
  • northing - Northing of the location (meter).
  • name - Name inlieu of this projection's name (str).
  • LatLon - Optional, ellipsoidal class to return the geodetic location as (LatLon) or None.
  • LatLon_kwds - Optional (LatLon) keyword arguments, ignored if LatLon is None.
Returns:
Geodetic location LatLon or if LatLon is None, a LatLon2Tuple(lat, lon).
Raises:
  • CSSError - Ellipsoidal mismatch of LatLon and this projection.
  • TypeError - Invalid LatLon or LatLon_kwds.

toRepr (self, prec=6, **unused)

 

Return a string representation of this projection.

Arguments:
  • prec - Number of (decimal) digits, unstripped (int).
Returns:
This projection as "<classname>(lat0, lon0, ...)" (str).
Overrides: named._Named.toRepr

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

 

Return a string representation of this projection.

Arguments:
  • prec - Number of (decimal) digits, unstripped (int).
  • sep - Separator to join (str).
Returns:
This projection as "lat0 lon0" (str).
Overrides: named._Named.toStr

Property Details

datum

Get the datum (Datum).

Get method:
datum(self) - Get the datum (Datum).
Set method:
datum(self, datum) - Set the datum or ellipsoid (Datum, Ellipsoid, Ellipsoid2 or a_f2Tuple) or None for the default.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

equatoradius

Get the ellipsoid's equatorial radius, semi-axis (meter).

Get method:
equatoradius(self) - Get the ellipsoid's equatorial radius, semi-axis (meter).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

a

Get the ellipsoid's equatorial radius, semi-axis (meter).

Get method:
equatoradius(self) - Get the ellipsoid's equatorial radius, semi-axis (meter).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

flattening

Get the ellipsoid's flattening (float).

Get method:
flattening(self) - Get the ellipsoid's flattening (float).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

f

Get the ellipsoid's flattening (float).

Get method:
flattening(self) - Get the ellipsoid's flattening (float).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

geodesic

Get this projection's wrapped,Karney Geodesic, provided package geographiclib is installed, otherwise a GeodesicExact instance.

Get method:
geodesic(self) - Get this projection's wrapped,Karney Geodesic, provided package geographiclib is installed, otherwise a GeodesicExact instance.
Set method:
geodesic(self, exact) - Set this projection's geodesic (bool) to GeodesicExact or wrapped Karney's or None for the default.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

isExact

Return True if this projection's geodesic is GeodesicExact.

Get method:
isExact(self) - Return True if this projection's geodesic is GeodesicExact.
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

lat0

Get the center latitude (degrees90).

Get method:
lat0(self) - Get the center latitude (degrees90).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

latlon0

Get the center lat- and longitude (LatLon2Tuple(lat, lon)) in (degrees90, (degrees180).

Get method:
latlon0(self) - Get the center lat- and longitude (LatLon2Tuple(lat, lon)) in (degrees90, (degrees180).
Set method:
latlon0(self, latlon0) - Set the center lat- and longitude (ellipsoidal LatLon, LatLon2Tuple, LatLon4Tuple or a tuple or list with the lat- and longitude in degrees).

lon0

Get the center longitude (degrees180).

Get method:
lon0(self) - Get the center longitude (degrees180).
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.

majoradius

DEPRECATED, use property equatoradius.

Get method:
majoradius(self) - DEPRECATED, use property equatoradius.
Set method:
_fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:
_fdel(inst) - Zap the cached/memoized property value.