Documentation / @interstellar-tools/maps / sinusoidal
Function: sinusoidal()
ts
function sinusoidal(
phi: Radians,
lambda: Radians,
R: number,
options?: ProjectionOptionsInterface
): ProjectedPointInterface;Defined in: projections/sinusoidal.ts:68
Project a point on a sphere with the sinusoidal projection: an equal-area map, with every parallel at its true length.
Where:
and are the point's latitude and longitude (rad) is the central meridian (rad) is the sphere's radius (m)
Units
- Inputs: angles in radians,
Rin m. - Output:
{ x, y }in m.
Notes
- Equal-area: a region's area on the map is its area on the sphere, so it suits geology, coverage and density maps. Shapes shear away from the central meridian and the equator.
- Every parallel is drawn at its true length, and so is the central meridian. The other meridians are sine curves, which meet at the poles: the map is
wide and tall. - Global planetary mosaics often use it, for example of Mars and the Moon.
is wrapped to (−π, π], so the map is centred on the central meridian. −π itself stays on the left edge, so a line that ends there, like a ground track split at the antimeridian, isn't drawn across the map.
Parameters
| Parameter | Type | Description |
|---|---|---|
phi | Radians | Latitude |
lambda | Radians | Longitude |
R | number | Radius |
options? | ProjectionOptionsInterface | lambda0, the central meridian (radians, defaults to 0). |
Returns
The point on the map, { x, y } in m.
Throws
- If any input is not a finite number.
- If
phiis outside [−π/2, π/2], orR <= 0.
Example
ts
// 60° N, 90° E on a 1 737.4 km Moon: the parallel is half as long as the equator
sinusoidal(toRad(60), toRad(90), 1_737_400);
// ≈ { x: 1 364 551, y: 1 819 401 } mSee
- inverseSinusoidal
- mollweide
- https://doi.org/10.3133/pp1395 Snyder (1987), Map projections: a working manual, ch. 30