trend

- 4

Trapped Radiation ENvironment model Development

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