GeographicLib
1.37
|
Polar stereographic projection. More...
#include <GeographicLib/PolarStereographic.hpp>
Public Member Functions | |
PolarStereographic (real a, real f, real k0) | |
void | SetScale (real lat, real k=real(1)) |
void | Forward (bool northp, real lat, real lon, real &x, real &y, real &gamma, real &k) const |
void | Reverse (bool northp, real x, real y, real &lat, real &lon, real &gamma, real &k) const |
void | Forward (bool northp, real lat, real lon, real &x, real &y) const |
void | Reverse (bool northp, real x, real y, real &lat, real &lon) const |
Inspector functions | |
Math::real | MajorRadius () const |
Math::real | Flattening () const |
Math::real | CentralScale () const |
Static Public Member Functions | |
static const PolarStereographic & | UPS () |
Polar stereographic projection.
Implementation taken from the report,
This is a straightforward implementation of the equations in Snyder except that Newton's method is used to invert the projection.
Example of use:
Definition at line 32 of file PolarStereographic.hpp.
GeographicLib::PolarStereographic::PolarStereographic | ( | real | a, |
real | f, | ||
real | k0 | ||
) |
Constructor for a ellipsoid with
[in] | a | equatorial radius (meters). |
[in] | f | flattening of ellipsoid. Setting f = 0 gives a sphere. Negative f gives a prolate ellipsoid. If f > 1, set flattening to 1/f. |
[in] | k0 | central scale factor. |
GeographicErr | if a, (1 − f) a, or k0 is not positive. |
Definition at line 21 of file PolarStereographic.cpp.
References GeographicLib::Math::isfinite().
void GeographicLib::PolarStereographic::SetScale | ( | real | lat, |
real | k = real(1) |
||
) |
Set the scale for the projection.
[in] | lat | (degrees) assuming northp = true. |
[in] | k | scale at latitude lat (default 1). |
GeographicErr | k is not positive. |
GeographicErr | if lat is not in (−90°, 90°]. |
Definition at line 123 of file PolarStereographic.cpp.
References Forward(), and GeographicLib::Math::isfinite().
void GeographicLib::PolarStereographic::Forward | ( | bool | northp, |
real | lat, | ||
real | lon, | ||
real & | x, | ||
real & | y, | ||
real & | gamma, | ||
real & | k | ||
) | const |
Forward projection, from geographic to polar stereographic.
[in] | northp | the pole which is the center of projection (true means north, false means south). |
[in] | lat | latitude of point (degrees). |
[in] | lon | longitude of point (degrees). |
[out] | x | easting of point (meters). |
[out] | y | northing of point (meters). |
[out] | gamma | meridian convergence at point (degrees). |
[out] | k | scale of projection at point. |
No false easting or northing is added. lat should be in the range (−90°, 90°] for northp = true and in the range [−90°, 90°) for northp = false; lon should be in the range [−540°, 540°).
Definition at line 68 of file PolarStereographic.cpp.
References GeographicLib::Math::AngNormalize(), GeographicLib::Math::degree(), GeographicLib::Math::hypot(), and GeographicLib::Math::sq().
Referenced by GeographicLib::UTMUPS::Forward(), and SetScale().
void GeographicLib::PolarStereographic::Reverse | ( | bool | northp, |
real | x, | ||
real | y, | ||
real & | lat, | ||
real & | lon, | ||
real & | gamma, | ||
real & | k | ||
) | const |
Reverse projection, from polar stereographic to geographic.
[in] | northp | the pole which is the center of projection (true means north, false means south). |
[in] | x | easting of point (meters). |
[in] | y | northing of point (meters). |
[out] | lat | latitude of point (degrees). |
[out] | lon | longitude of point (degrees). |
[out] | gamma | meridian convergence at point (degrees). |
[out] | k | scale of projection at point. |
No false easting or northing is added. The value of lon returned is in the range [−180°, 180°).
Definition at line 91 of file PolarStereographic.cpp.
References GeographicLib::Math::degree(), GEOGRAPHICLIB_PANIC, GeographicLib::Math::hypot(), and GeographicLib::Math::sq().
Referenced by GeographicLib::UTMUPS::Reverse().
|
inline |
PolarStereographic::Forward without returning the convergence and scale.
Definition at line 128 of file PolarStereographic.hpp.
|
inline |
PolarStereographic::Reverse without returning the convergence and scale.
Definition at line 137 of file PolarStereographic.hpp.
|
inline |
Definition at line 150 of file PolarStereographic.hpp.
|
inline |
Definition at line 156 of file PolarStereographic.hpp.
|
inline |
The central scale for the projection. This is the value of k0 used in the constructor and is the scale at the pole unless overridden by PolarStereographic::SetScale.
Definition at line 171 of file PolarStereographic.hpp.
|
static |
A global instantiation of PolarStereographic with the WGS84 ellipsoid and the UPS scale factor. However, unlike UPS, no false easting or northing is added.
Definition at line 40 of file PolarStereographic.cpp.
References GeographicLib::Constants::UPS_k0(), GeographicLib::Constants::WGS84_a(), and GeographicLib::Constants::WGS84_f().
Referenced by GeographicLib::UTMUPS::Forward(), and GeographicLib::UTMUPS::Reverse().