GeographicLib::JacobiConformal Class Reference

Jacobi's conformal projection of a triaxial ellipsoid. More...

#include <JacobiConformal.hpp>

Public Member Functions
	JacobiConformal (real a, real b, real c)
	JacobiConformal (real a, real b, real c, real ab, real bc)
Math::real	x () const
Math::real	x (real somg, real comg) const
Math::real	x (real omg) const
Math::real	y () const
Math::real	y (real sbet, real cbet) const
Math::real	y (real bet) const

Private Types
typedef Math::real	real

Static Private Member Functions
static void	norm (real &x, real &y)

Private Attributes
real	_a
real	_ab2
real	_ac2
real	_b
real	_bc2
real	_c
EllipticFunction	_ex
EllipticFunction	_ey

Detailed Description

Jacobi's conformal projection of a triaxial ellipsoid.

NOTE: This is just sample code. It is not part of GeographicLib itself.

This is a conformal projection of the ellipsoid to a plane in which the grid lines are straight; see Jacobi, Vorlesungen über Dynamik, §28. The constructor takes the semi-axes of the ellipsoid (which must be in order). Member functions map the ellipsoidal coordinates ω and β separately to x and y. Jacobi's coordinates have been multiplied by (a²−c²)^1/2 / (2b) so that the customary results are returned in the cases of a sphere or an ellipsoid of revolution.

The ellipsoid is oriented so that the large principal ellipse, , is the equator, , while the small principal ellipse, , is the prime meridian, . The four umbilic points, , lie on middle principal ellipse in the plane .

For more information on this projection, see jacobi.

Definition at line 41 of file JacobiConformal.hpp.

Member Typedef Documentation

typedef Math::real GeographicLib::JacobiConformal::real

private

Definition at line 42 of file JacobiConformal.hpp.

Constructor & Destructor Documentation

GeographicLib::JacobiConformal::JacobiConformal ( real  a, real  b, real  c  )

inline

Constructor for a trixial ellipsoid with semi-axes.

Parameters

[in]	a	the largest semi-axis.
[in]	b	the middle semi-axis.
[in]	c	the smallest semi-axis.

The semi-axes must satisfy a ≥ b ≥ c > 0 and a > c. This form of the constructor cannot be used to specify a sphere (use the next constructor).

Definition at line 59 of file JacobiConformal.hpp.

GeographicLib::JacobiConformal::JacobiConformal ( real  a, real  b, real  c, real  ab, real  bc  )

inline

Alternate constructor for a triaxial ellipsoid.

Parameters

[in]	a	the largest semi-axis.
[in]	b	the middle semi-axis.
[in]	c	the smallest semi-axis.
[in]	ab	the relative magnitude of a − b.
[in]	bc	the relative magnitude of b − c.

This form can be used to specify a sphere. The semi-axes must satisfy a ≥ b ≥ c > 0. The ratio ab : bc must equal (a−b) : (b−c) with ab ≥ 0, bc ≥ 0, and ab + bc > 0.

Definition at line 89 of file JacobiConformal.hpp.

Member Function Documentation

static void GeographicLib::JacobiConformal::norm ( real &  x, real &  y  )

inlinestaticprivate

Definition at line 45 of file JacobiConformal.hpp.

Math::real GeographicLib::JacobiConformal::x ( ) const

inline

Returns

the quadrant length in the x direction.

Definition at line 110 of file JacobiConformal.hpp.

Math::real GeographicLib::JacobiConformal::x ( real  somg, real  comg  ) const

inline

The x projection.

Parameters

[in]	somg	sin(ω).
[in]	comg	cos(ω).

Returns

x.

Definition at line 118 of file JacobiConformal.hpp.

Math::real GeographicLib::JacobiConformal::x ( real  omg ) const

inline

The x projection.

Parameters

[in]

omg

ω (in degrees).

Returns

x (in degrees).

ω must be in (−180°, 180°].

Definition at line 131 of file JacobiConformal.hpp.

Math::real GeographicLib::JacobiConformal::y ( ) const

inline

Returns

the quadrant length in the y direction.

Definition at line 139 of file JacobiConformal.hpp.

Math::real GeographicLib::JacobiConformal::y ( real  sbet, real  cbet  ) const

inline

The y projection.

Parameters

[in]	sbet	sin(β).
[in]	cbet	cos(β).

Returns

y.

Definition at line 147 of file JacobiConformal.hpp.

Math::real GeographicLib::JacobiConformal::y ( real  bet ) const

inline

The y projection.

Parameters

[in]

bet

β (in degrees).

Returns

y (in degrees).

β must be in (−180°, 180°].

Definition at line 160 of file JacobiConformal.hpp.

Member Data Documentation

real GeographicLib::JacobiConformal::_a

private

Definition at line 43 of file JacobiConformal.hpp.

real GeographicLib::JacobiConformal::_ab2

private

Definition at line 43 of file JacobiConformal.hpp.

real GeographicLib::JacobiConformal::_ac2

private

Definition at line 43 of file JacobiConformal.hpp.

real GeographicLib::JacobiConformal::_b

private

Definition at line 43 of file JacobiConformal.hpp.

real GeographicLib::JacobiConformal::_bc2

private

Definition at line 43 of file JacobiConformal.hpp.

real GeographicLib::JacobiConformal::_c

private

Definition at line 43 of file JacobiConformal.hpp.

EllipticFunction GeographicLib::JacobiConformal::_ex

private

Definition at line 44 of file JacobiConformal.hpp.

EllipticFunction GeographicLib::JacobiConformal::_ey

private

Definition at line 44 of file JacobiConformal.hpp.

---

The documentation for this class was generated from the following file:

• JacobiConformal.hpp