imap_processing.spice.geometry.cartesian_to_spherical

imap_processing.spice.geometry.cartesian_to_spherical(v: ndarray[tuple[int, ...], dtype[_ScalarType_co]], degrees: bool = True) → ndarray[tuple[int, ...], dtype[_ScalarType_co]]

Convert cartesian coordinates to spherical coordinates.

Parameters:

• v (np.ndarray) – A NumPy array with shape (n, 3) where each row represents a vector with x, y, z-components.

• degrees (bool) – If True, the azimuth and elevation angles are returned in degrees. Defaults to True.

Returns:

spherical_coords – A NumPy array with shape (n, 3), where each row contains the spherical coordinates (r, azimuth, elevation):

• r : Distance of the point from the origin.

• azimuth : angle in the xy-plane In degrees if degrees parameter is True (by default): output range=[0, 360], otherwise in radians if degrees parameter is False: output range=[0, 2*pi].

• elevation : angle from the z-axis In degrees if degrees parameter is True (by default): output range=[0, 180], otherwise in radians if degrees parameter is False: output range=[-pi/2, pi/2].

Return type:

np.ndarray