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: `ImportError` - Package GeographicLib missing. 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: `AssertionError` - Always, see function notOverloaded. 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.