UC140

[ Name | Synopsis | Arguments | Description | Dependencies | See Also | Examples ]

Name

Common block UC140 - magnetic field description

Synopsis

      INCLUDE 'structure.h'

      COMMON /UC140/ mint, mext, msun

      RECORD /zimf/ mint
      RECORD /zsun/ msun
      RECORD /zemf/ mext          

Arguments

mint

Description of the geomagnetic field model

mext

Description of the external magnetic field model

msun

Sun position

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 otherwize.

Except for the subroutines which computes the magnetic field vector, the common block UC140 generally is used to obtained 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's function):

mint.gmmo

UL245 (evaluate the equatorial pitch angle):

mint.gmmo

UD330 (evaluate the third invariant):

mint.gmmo

UF411 (search a field line for fixed longitude of its local equator):

mint.colat and mint.elong

UM523 (transformation array from GEO to GSM):

mint.colat, mint.elong, msun.dir

UM524 (transformation array from GEO to SM):

mint.colat, mint.elong, and msun.dir

UM530 (evaluate the magnetic field):

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

UM531 (geomagnetic field evaluation):

mint.norder and mint.coef

UM532 (external magnetic field evaluation):

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

UM533 (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 a geomagnetic field model):

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

UM511 (set the Jensen & Cain 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 disturbances level based on Kp):

mext.ikp

UM522 (compute the position of the Sun):

msun.utdeg, msun.utgha and msun.dir

UM523 (transformation array from GEO to GSM):

msun.dir.x, msun.dir.y, msun.dir.z, msun.gha

UM524 (transformation array from GEO to SM):

mext.tilt and mext.trans

See also

None

Examples

None