trend

- 4

Trapped Radiation ENvironment model Development

UM533

[ Name | Synopsis | Arguments | Description | Diagnostics | Common Blocks | Dependencies | See Also | Reported Bugs | Examples ]

Name

    Subroutine UM533 - distance to the magnetopause

Synopsis

      RECORD /zgeo/ mgeo
      REAL*8        rmagp
      INTEGER*4     ifail
      
      CALL UM533 (mgeo, rmagp, ifail )

Arguments

    mgeo
    Geocentric location [in]
    rmagp
    distance from the Earth center to the magnetopause in the same direction as mgeo [out]
    ifail
    Error flag (see diagnostics) [out]

Description

    The subroutine UM533 evaluates the location of the magnetopause in a given direction. The algorithm is based on Fairfield (J.Geophys. Res., 76-28, p.6700). It depends on the arguments msun.utdeg and mext.vkp of the common block UC140. The subroutine is mainly used to prevent the library to trace magnetic field line outside the magnetosphere. Note that the algorithm is independent of the selected magnetic field model, and therefore, that the location of the magnetopause does not coincide exactly with the one of the magnetic field model.

    It is possible to inhibit the subroutine with the help of the argument kum533 of the common block UC190. When the argument kum533 is less or equal to 0, the error diagnostic is disable. Note that the argument is initialized to 1 by the subroutine UT990.

History

    In version 1.10 and earlier, the argument kum533 was not present. In versions 1.07 to 1.13, the value of Kp was not correctly passed by the subroutine UM520 and the value zero was used instead.

Diagnostics

    -53301, position beyond the magnetopause

Common Blocks

    UC140, magnetic field description
    UC160, general constants

Dependencies

Called by

    UM530, evaluate the magnetic field vector

Calls

    None

See also

Reported Bugs

    None

Examples

    None