harmonica.ellipsoid_magnetic

harmonica.ellipsoid_magnetic#

harmonica.ellipsoid_magnetic(coordinates, ellipsoids, external_field)[source]#

Forward model magnetic fields of ellipsoids.

Compute the magnetic field components for an ellipsoidal body at specified observation points.

Important

The magnetic field components are returned in nT.

Parameters:
coordinateslist of array

List of arrays containing the easting, northing and upward coordinates of the computation points defined on a Cartesian coordinate system. All coordinates should be in meters.

ellipsoidellipsoid or list of ellipsoids

Ellipsoidal body represented by an instance of harmonica.TriaxialEllipsoid, harmonica.ProlateEllipsoid, or harmonica.OblateEllipsoid, or a list of them.

external_fieldtuple

The uniform magnetic field (B) as and array with values of (magnitude, inclination, declination). The magnitude should be in nT, and the angles in degrees.

Returns:
be, bn, buarray

Easting, northing and upward magnetic field components in nT.

References

[Clark1986] [Takahashi2018]