European Space Agency

Royal Belgian Institute for Aeronomy

ext530 - set of external magnetic field models

subroutine  ext530()

Description

This package includes subroutines to evaluate the external magnetic field models:

• Mead & Fairfield [1], subroutine MEAD;

• Tsyganenko short [6], subroutine TSY87S;

• Tsyganenko long [6], subroutine TSY87L;

• Tsyganenko [7] (T89c), subroutine T89C;

• Olson & Pfitzer quiet [3], subroutine BXYZMU;

• Olson & Pfitzer dynamic [5], subroutine BDYN;

• Tsyganenko [8], subroutine T96_01.

• Ostapenko & Maltsev [4], subroutine BOM97.

In the UNILIB library, the codes of the implemented models have been modified in order to make them clearer and to correct small mistakes. These modifications were made by

D. Heynderickx

BIRA, Ringlaan 3

B-1180 Brussel, Belgium

https://www.aeronomie.be/

Mead & Fairfield

The Mead & Fairfield [1] model was obtained by a least-square-fit to 12616 vector field measurements from 451 orbits of four IMP satellites between 1966 and 1972. The model depends on four levels of magnetic activity parameterized by Kp. The model was developed by

D.H. Fairfield

NASA/GSFC, Code 695 Greenbelt

Maryland 20771, USA

Tsyganenko

The Tsyganenko magnetic field models are based on a large number of satellite observations (IMP, HEOS) covering the period 1966 to 1980. The models are obtained from 36682 data points for several levels of magnetic disturbance parameterized by Kp. The Tsyganenko [6] model is provided as a ‘long’ and a ‘short’ versions. The Tsyganenko [7] model T89c is tilt dependent and was primarily developed as a tail model. The Tsyganenko [8] model has an explicitly defined realistic magnetopause, large-scale Region 1 and 2 Birkeland current systems, and the IMF penetration across the boundary. The models may be retrieved from https://geo.phys.spbu.ru/~tsyganenko/empirical-models/ and were developed by

N.A. Tsyganenko (n.tsyganenko@spbu.ru)

Department of Earth’s Physics

University of St.-Petersburg

Petrodvoretz

St.-Petersburg 198504

Russian Federation

Note

The Tsyganenko models are distributed under a GNU GPLv3 licence. This licence is incompatible with the UNILIB licence.

See G.10 - Are the Tsyganenko Models included?

Olson & Pfitzer

The Olson & Pfitzer [2] is an average model fit to quiet conditions using data from OGO 3, 5 and Explorer 33, 35. There are no parameters for this model. The dynamic model [5] is a scalable model dependending upon the activity level but without a tilt dependence. The scale factor are determined by the activity index \(D_{st}\) and the standoff distance of the magnetopause obtained by the solar wind density and velocity. These models were developed by

K.A. Pfitzer and W.P. Olson

McDonnell Douglas Company, Code A3-208, Mail Stop 13/3

5301 Bolsa Avenue, Huntington Beach

California 92647, USA

Ostapenko & Maltsev

The Ostapenko & Maltsev [4] model was obtained by a least-square-fit of fourth-order polynomials to 14000 vector field measurements from the database of Fairfield et al. [9]. The model depends on the \(D_{st}\) and \(K_p\) indices, as well as on the solar wind dynamic pressure and the z component of the interplanetary magnetic field. The model can be retrieved from

Y.P. Maltsev (maltsev@pgi-ksc.murmansk.su)

Polar Geophysical Institute

Apatity, RUSSIA

References

[1] (1,2)

Mead, G.D., and Fairfield, D.H., A quantitative magnetospheric model derived from spacecraft magnetometer data, JGR 80 (1975) 523-534, https://doi.org/10.1029/JA080i004p00523

[2]

Olson, W.P., A model of the distributed magnetospheric currents, JGR 79 (1974) 3731-3738, https://doi.org/10.1029/JA079i025p03731

[3]

Olson, W.P. and Pfitzer, K.A., Magnetospheric magnetic field modeling, Annual Scientific Report, AFOSR Contract No. F44620-75-C-0033 (1977)

[4] (1,2,3)

Ostapenko, A.A., and Maltsev, Y.P., Relation of the magnetic field in the magnetosphere to the geomagnetic and solar wind activity, JGR 102 (1997) 17467-17473

[5] (1,2)

Pfitzer, K.A., Olson, W.P., and Mogstad, T., A time dependent source driven magnetospheric magnetic field model, EOS 69 (1988) 426

[6] (1,2,3)

Tsyganenko, N.A., Global quantitative models of the geomagnetic field in the cislunar magnetosphere for different disturbance levels, Planet. Space Sci. 35 (1987) 1347-1358

[7] (1,2)

Tsyganenko, N.A., A magnetospheric magnetic field model with a wrapped tail current sheet, Planet. Space Sci. 37 (1989) 5-20

[8] (1,2,3)

Tsyganenko, N.A. and Stern, D.P., Modeling the global magnetic field the large-scale Birkeland current systems, J.Geophys.Res. 101 (1996) 27187-27198

[9]

Fairfield, D. H., Tsyganenko, N. A., Usmanov, A. V., and Malkov, M. V. (1994), A large magnetosphere magnetic field database, J. Geophys. Res., 99(A6), 11319–11326, doi:10.1029/94JA00255.

History

In version 1.06 and earlier of the library, most of the external magnetic field models do not work properly under HPUX, SunOS and DEC/OSF (see R.02). The model of Tsyganenko [8] (subroutine T96_01) is not included in version 1.06 and earlier of the library. The model of Ostapenko & Maltsev [4] (subroutine BOM97) is not included in version 1.11 and earlier of the library. (subroutine BOM97). Since version 2.02, the Tsyganenko model T89c is implemented instead of the version T89a.

Synopsis

REAL*8         xx, yy, zz, tilt, abx, aby, abz
INTEGER*4      kp

CALL MEAD (xx, yy, zz, tilt, kp, abx, aby, abz)


REAL*8         x, y, z, ps, bx, by, bz
INTEGER*4      iopt

CALL TSY87S (iopt, ps, x, y, z, bx, by, bz)


REAL*8         x, y, z, ps, bx, by, bz
INTEGER*4      iopt

CALL TSY87L (iopt, ps, x, y, z, bx, by, bz)


REAL*8         parmod(10), ps, x, y, z, bx, by, bz
INTEGER*4      iopt

CALL T89C (iopt, parmod, ps, x, y, z, bx, by, bz)


REAL*8         x, y, z, tilt, abx, aby, abz

CALL BXYZMU (x, y , z, tilt, abx, aby, abz)


REAL*8         x, y, z, tilt, abx, aby, abz
REAL*8         den, vel, dst

CALL BDYN (den, vel, dst, x, y, z, abx, aby, abz)


REAL*8         parmod(10), ps, x, y, z, bx, by, bz
INTEGER*4      iopt

CALL T96_01 (iopt, parmod, ps, x, y, z, bx, by, bz)


REAL*8         dst, pdyn, fkp, bimfz, r(3), b(3), sn

CALL SET_A (dst, pdyn, fkp, bimfz, sn)
CALL BOM97 (r, b)

Dependencies

BDYN

The subroutine BDYN makes use of the subroutines and functions that are listed in the table below

Subroutines

• BDYNAM

• BFMAGP

• BFRING

• BFTAIL

Functions

• RINGST

• STDOFF

bom97

The subroutine bom97 makes use of the common block and subroutines that are listed in the table below

common block

• COEFOM97

subroutines

• BAZ_T

• JETASY

• JETSYM

• LEGNDR

• PTNCL

• SET_A

See also

• um520 - select an external magnetic field model

• um530 - evaluate the magnetic field vector

• Catalog of Space Physics Models

---

UNILIB/tags/v3.02