Skip to content

Documentation / @interstellar-tools/maps / inverseOrthographic

Function: inverseOrthographic() ​

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

Defined in: projections/orthographic.ts:118

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

ρ=x2+y2,c=arcsin⁡ρRφ=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

  • Only points within R of the centre, on the globe's disc, have an inverse: a point beyond it throws a RangeError. The answer is always on the near hemisphere.
  • Near the edge of the disc, where the globe is seen edge-on, a small step on the map is a long way on the sphere, so the inverse loses precision there.
  • φ 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, on the map).
ynumberDistance north of the centre in m (finite, on the map).
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 the point is more than R from the centre, phi0 is outside [−π/2, π/2], or R <= 0.

Example ​

ts
inverseOrthographic(2_542_125, 1_694_750, 3_389_500);
// ≈ { phi: 30° N, lambda: 60° E }, in radians

See ​