European Space Agency

European Space Agency

Royal Belgian Institute for Aeronomy

Royal Belgian Institute for Aeronomy

../_images/whiteSpace.png

um533 - evaluate distance to the magnetopause

subroutine  um533(mgeo, rmagp, ifail)
Parameters:

  • mgeo [zgeo,in] :: geocentric location

  • rmagp [real8,out] :: distance from the Earth centre to the magnetopause in the same direction as mgeo

  • ifail [integer4,out] :: error flag (see Diagnostics)

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 from tracing the 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

Dependencies

Called by

Calls

None

See also

None

Reported Bugs

None

Examples

None

UNILIB/tags/v3.02