European Space Agency

Royal Belgian Institute for Aeronomy

ud332 - evaluate the magnetic flux through a spherical pie

subroutine  ud332(colat, mpos1, mpos2, phi, ifail)

Parameters:

• colat [real8,in] :: Pole selection (first point)

• mpos1 [zgeo,in] :: Second point

• mpos2 [zgeo,in] :: Third point

• phi [real8,out] :: Magnetic flux

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

Description

The subroutine ud332() evaluates the magnetic flux passing through a spherical pie. This subroutine is called by subroutine ud330() to evaluate the third invariant of a magnetic drift shell. The spherical pie is determined by three geographic locations at a fixed altitude. The first location corresponds to one of the geographic poles and is selected by the argument colat. The second location is determined by the arguments mpos1.elong and mpos1.colat. The third location is determined by the arguments mpos2.elong and mpos2.colat. One should note that the altitude is fixed by mpos1.radius and should be equal to mpos2.radius.

Diagnostics

• -33201, invalid value of colat

• -33202, not constant altitude

Common Blocks

• uc160 - general constants

• uc190 - control parameters, set 1

• uc192 - control parameters, set 2

Dependencies

Called by

• ud331 - evaluate the magnetic flux through a spherical cap

Calls

• um530 - evaluate the magnetic field vector

See also

• ud330 - evaluate the third invariant

Reported Bugs

None

Examples

None

---

UNILIB/tags/v3.02