solve_reduced_lat_equation

Ellipsoid.solve_reduced_lat_equation(self, r: ndarray[double]) → double | ndarray[double]

Compute the reduced (parametric) latitude \(\beta\) from ECEF position vector(s).

Given a scalar or 1-D array of ECEF position vectors [x, y, z] in metres, solve for the corresponding reduced latitude \(\beta\) on the reference ellipsoid by projecting onto the local vertical.

Parameters:

rndarray of float, shape (3,) or (N, 3)

ECEF position vector(s) in metres (SI). - If shape is (3,), treated as a single vector. - If shape is (N, 3), treated as N vectors.

Returns:

betafloat or ndarray of float, shape () or (N,)

Reduced (parametric) latitude(s) \(\beta\) in radians, satisfying

Raises:

AssertionError

If r is not a 1-D array of length 3 or a 2-D array with shape (N, 3).

See also

c_solve_reduced_lat_equation

Core C implementation (nogil) for a single [x, y, z] vector.

Notes

Internally dispatches each vector to the low-level C routine c_solve_reduced_lat_equation, releasing the GIL for performance.