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

Class CassiniSoldner

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

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)
Convert an (ellipsoidal) geodetic location to Cassini-Soldner easting and northing.
 
forward4(self, lat, lon)
Convert an (ellipsoidal) geodetic location to Cassini-Soldner easting and northing.
 
reset(self, lat0, lon0)
Set the center point of this projection.
 
reverse(self, easting, northing, LatLon=None)
Convert a Cassini-Soldner location to (ellipsoidal) geodetic lat- and longitude.
 
toLatLon(self, easting, northing, LatLon=None)
Convert a Cassini-Soldner location to (ellipsoidal) geodetic lat- and longitude.
 
reverse4(self, easting, northing)
Convert a Cassini-Soldner location to (ellipsoidal) geodetic lat- and longitude.
 
toStr(self, prec=6, sep=' ')
Return a string representation of this projection.
 
toStr2(self, prec=6)
Return a string representation of this projection.

Inherited from named._NamedBase: __repr__, __str__, others

Inherited from named._Named: _dot_, attrs, classof, copy

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

Properties
  datum
An immutable property (Read Only).
  flattening
An immutable property (Read Only).
  geodesic
An immutable property (Read Only).
  lat0
An immutable property (Read Only).
  latlon0
An immutable property (Read Only).
  lon0
An immutable property (Read Only).
  majoradius
An immutable property (Read Only).

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

Inherited from object: __class__

Method Details

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

 

New CassiniSoldner projection.

Parameters:
  • lat0 - Latitude of center point (degrees90).
  • lon0 - Longitude of center point (degrees180).
  • datum - Optional, the geodesic datum (Datum).
  • 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)

 

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

Parameters:
  • lat - Latitude of the location (degrees90).
  • lon - Longitude of the location (degrees180).
Returns:
An EasNor2Tuple(easting, northing).

forward4(self, lat, lon)

 

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

Parameters:
  • lat - Latitude of the location (degrees90).
  • lon - Longitude of the location (degrees180).
Returns:
An EasNorAziRk4Tuple(easting, northing, azimuth, reciprocal).

reset(self, lat0, lon0)

 

Set the center point of this projection.

Parameters:
  • lat0 - Latitude of center point (degrees90).
  • lon0 - Longitude of center point (degrees180).

reverse(self, easting, northing, LatLon=None)

 

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

Parameters:
  • easting - Easting of the location (meter).
  • northing - Northing of the location (meter).
  • LatLon - Optional, ellipsoidal (sub-)class to return the location as (LatLon) or None.
Returns:
Geodetic location LatLon or a LatLon2Tuple(lat, lon) if LatLon is None.
Raises:
  • TypeError - If LatLon is not ellipsoidal.

toLatLon(self, easting, northing, LatLon=None)

 

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

Parameters:
  • easting - Easting of the location (meter).
  • northing - Northing of the location (meter).
  • LatLon - Optional, ellipsoidal (sub-)class to return the location as (LatLon) or None.
Returns:
Geodetic location LatLon or a LatLon2Tuple(lat, lon) if LatLon is None.
Raises:
  • TypeError - If LatLon is not ellipsoidal.

reverse4(self, easting, northing)

 

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

Parameters:
  • easting - Easting of the location (meter).
  • northing - Northing of the location (meter).
Returns:
A LatLonAziRk4Tuple(lat, lon, azimuth, reciprocal).

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

 

Return a string representation of this projection.

Parameters:
  • prec - Optional number of decimal, unstripped (int).
  • sep - Optional separator to join (str).
Returns:
This projection as "lat0 lon0" (str).
Raises:
Overrides: named._Named.toStr

toStr2(self, prec=6)

 

Return a string representation of this projection.

Parameters:
  • prec - Optional number of decimals, unstripped (int).
Returns:
This projection as "<classname>(lat0, lon0, ...)" (str).
Overrides: named._Named.toStr2

Property Details

datum

An immutable property (Read Only).

Get Method:
datum(self) - Get the datum (Datum).
Set Method:
immutable(inst, value) - Throws an AttributeError, always.

flattening

An immutable property (Read Only).

Get Method:
flattening(self) - Get the geodesic's flattening (float).
Set Method:
immutable(inst, value) - Throws an AttributeError, always.

geodesic

An immutable property (Read Only).

Get Method:
geodesic(self) - Get this projection's Geodesic, provided package geographiclib is installed.
Set Method:
immutable(inst, value) - Throws an AttributeError, always.

lat0

An immutable property (Read Only).

Get Method:
lat0(self) - Get the center latitude (degrees90).
Set Method:
immutable(inst, value) - Throws an AttributeError, always.

latlon0

An immutable property (Read Only).

Get Method:
latlon0(self) - Get the center lat- and longitude (LatLon2Tuple).
Set Method:
immutable(inst, value) - Throws an AttributeError, always.

lon0

An immutable property (Read Only).

Get Method:
lon0(self) - Get the center longitude (degrees180).
Set Method:
immutable(inst, value) - Throws an AttributeError, always.

majoradius

An immutable property (Read Only).

Get Method:
majoradius(self) - Get the geodesic's major (equatorial) radius (float).
Set Method:
immutable(inst, value) - Throws an AttributeError, always.