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 (GEO) into spherical coordinates of a rotated geocentric coordinate system.

Parameters
thetafloat or ndarray, shape (…)

Geographic colatitude in degrees (GEO).

phifloat or ndarray, shape (…)

Geographic longitude in degrees (GEO).

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 the rotated geocentric coordinates to GEO (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 (…)

Colatitude in degrees \([0^\circ, 180^\circ]\) of the rotated geocentric coordinate system.

phindarray, shape (…)

Longitude in degrees \((-180^\circ, 180^\circ]\) of the rotated geocentric coordinate system.

See also

geo_to_base