chaosmagpy.coordinate_utils.transform_points¶

chaosmagpy.coordinate_utils.transform_points(theta, phi, time=None, *, reference=None, inverse=None, dipole=None)[source]¶

Transform spherical geographic coordinates into rotated spherical coordinates.

Parameters:

thetafloat or ndarray, shape (…): Geocentric colatitude in degrees.
phifloat or ndarray, shape (…): Longitude in degrees.
timefloat or ndarray, shape (…): Time given as modified Julian date, i.e. with respect to the date 0h00 January 1, 2000 (mjd2000). Ignored for reference='mag'.
reference{‘gsm’, ‘sm’, ‘mag’}: Target coordinate system.
inversebool: Use inverse transformation instead, i.e. transform from rotated to spherical geographic coordinates (default is False).
dipolendarray, shape (…, 3), optional: Dipole spherical harmonics \(g_1^0\), \(g_1^1\) and \(h_1^1\). Defaults to basicConfig['params.dipole'].

Returns:

thetandarray, shape (…): Geocentric colatitude in degrees \([0^\circ, 180^\circ]\) of the rotated coordinate system.
phindarray, shape (…): Longitude in degrees \((-180^\circ, 180^\circ]\) of the rotated geocentric coordinate system.