European Space Agency

Royal Belgian Institute for Aeronomy

uc140 - magnetic field

type  uc140

Synopsis

INCLUDE 'unilib.h'

COMMON /UC140/ mint, mext, msun

TYPE(zimf) mint
TYPE(zsun) msun
TYPE(zemf) mext

Arguments

mint

Description of the geomagnetic field model (zimf)

mext

Description of the external magnetic field model(zemf)

msun

Sun position (zsun)

Description

The common block uc140 contains the description of magnetic field model used by the subroutine um530(). The common may be initialized with the two subroutines um510() and um520(). The subroutine um510() allows to select a geomagnetic field model and initializes the mint argument. The subroutine um520() is used to select an external magnetic field model and initializes the arguments mext and msun. Since the subroutine um520() uses the values of the two arguments mint%colat and mint%elong, the subroutine um510() has to be previously called.

The subroutine um522() and the subroutine um523() or um524() may be used to modify the arguments msun and mext%trans for a new date and time. The subroutine um523() has to be used with the different Tsyganenko models, and the subroutine um524() otherwise.

Except for the subroutines which computes the magnetic field vector, the common block uc140 generally is used to obtain the geographic colatitude and east longitude of boreal earth dipole pole (mint%colat and mint%elong, respectively) or its magnetic moment (mint%gmmo).

Dependencies

Used by

• ul225 - evaluate invariant radius and latitude

  mint%gmmo

• ul240 - evaluate the Hilton’s function

  mint%gmmo

• ul242 - inverse the Hilton function

  mint%gmmo

• ul245 - equatorial pitch angle

  mint%gmmo

• ud330 - evaluate the third invariant

  mint%gmmo

• uf411 - search a local magnetic equator

  mint%colat and mint%elong

• um523 - GEO to GSM transformation

  mint%colat, mint%elong, msun%dir

• um524 - GEO to SM transformation

  mint%colat, mint%elong, and msun%dir

• um530 - evaluate the magnetic field vector

  mint%colat, mint%elong, mint%kinner, mint%saarot and mext%kouter

• um531 - evaluate the geomagnetic field

  mint%norder and mint%coef

• um532 - evaluate the external magnetic field

  mext%trans, mext%tilt, mext%kouter, mext%ikp, mext%wdens, mext%wvel and mext%vdst

• um533 - evaluate distance to the magnetopause

  msun%utdeg and mext%vkp

• um538 - evaluate the magnetic local time

  mext%trans

• um539 - evaluate the magnetic field

  mext%kouter

• ut550 - select a coordinate transformation

  msun%dir, msun%gha, mint%colat and mint%elong

• ut986 - pass general variables to IDL

  mint%colat, mint%elong, mint%gmmo and msun%dir

• ut999 - radius of curvature in a dipolar magnetic field

  mint%colat and mint%elong

Modified by

• um510 - select an internal field model

  mint%norder, mint%label, mint%kinner, mint%elong, mint%colat, mint%saarot, mint%gmmo and mint%epoch

• um511 - set the Jensen & Cain 1960 model coefficients

  mint%tzero, mint%norder and mint%coef)

• um512 - set the GSFC 12/66 model coefficients

  mint%tzero, mint%norder and mint%coef)

• um513 - set the DGRF/IGRF model coefficients

  mint%tzero, mint%norder and mint%coef)

• um520 - select an external magnetic field model

  mext%kouter, mext%vdst, mext%wdens, mext%wvel

• um521 - ground disturbance from Kp

  mext%ikp

• um522 - position of the Sun

  msun%utdeg, msun%utgha and msun%dir

• um523 - GEO to GSM transformation

  msun%dir%x, msun%dir%y, msun%dir%z, msun%gha

• um524 - GEO to SM transformation

  mext%tilt and mext%trans

See also

None

Examples

None

---

UNILIB/tags/v3.02