Skip to content

Documentation / @interstellar-tools/maps / inverseStereographic

Function: inverseStereographic() ​

ts
function inverseStereographic(
  x: number,
  y: number,
  R: number,
  options?: AzimuthalOptionsInterface
): GeographicCoordinatesInterface;

Defined in: projections/stereographic.ts:124

Find the point on a sphere for a point on a stereographic map: the inverse of stereographic.

ρ=x2+y2,c=2arctan⁡ρ2Rφ=arcsin(cos⁡csin⁡φ0+ysin⁡ccos⁡φ0ρ),λ=λ0+arctan⁡xsin⁡cρcos⁡φ0cos⁡c−ysin⁡φ0sin⁡c

Units

  • Inputs: x, y and R in m, phi0 and lambda0 in radians.
  • Output: { phi, lambda } in radians, with λ in (−π, π].

Notes

  • Every point on the plane has an inverse; the farther from the centre, the closer it is to the centre's antipode.
  • φ and λ are found with atan2, which keeps full precision near the poles, and the arctangent takes the quadrant into account. At a pole, any λ is the same point.

Parameters ​

ParameterTypeDescription
xnumberDistance east of the centre in m (finite).
ynumberDistance north of the centre in m (finite).
RnumberRadius R of the sphere in m (finite, > 0).
options?AzimuthalOptionsInterfacephi0 and lambda0, the map's centre (radians, both default to 0).

Returns ​

GeographicCoordinatesInterface

The point on the sphere, { phi, lambda } in radians.

Throws ​

  • If any input is not a finite number.
  • If phi0 is outside [−π/2, π/2], or R <= 0.

Example ​

ts
inverseStereographic(419_375, 419_375, 3_389_500, { phi0: toRad(-90) });
// ≈ { phi: 80° S, lambda: 45° E }, in radians

See ​