- 4

Trapped Radiation ENvironment model Development


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


    Common block UC140 - magnetic field description


      INCLUDE 'structure.h'

      COMMON /UC140/ mint, mext, msun

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


    Description of the geomagnetic field model
    Description of the external magnetic field model
    Sun position


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


Used by

    UL225 (evaluate invariant radius and latitude):
    UL240 (evaluate the Hilton's function):
    UL242 (inverse the Hilton's function):
    UL245 (evaluate the equatorial pitch angle):
    UD330 (evaluate the third invariant):
    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):
    UM539 (evaluate the magnetic field):
    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):
    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