Overview

Python interface for the Average Magnetic field and Polar current System (AMPS) model.

The AMPS model is an empirical model of the ionospheric current system and associated magnetic field. The model magnetic field and currents are continuous functions of solar wind velocity, the interplanetary magnetic field, the tilt of the Earth’s dipole magnetic field with respect to the Sun, and the 10.7 cm solar radio flux index F10.7. Given these parameters, model values of the ionospheric magnetic field can be calculated anywhere in space, and, with certain assumptions, on ground. The full current system, horizontal + field-aligned, are defined everywhere in the polar regions. The model is based on magnetic field measurements from the low Earth orbiting Swarm and CHAMP satellites.

pyAMPS can be used to calculate and plot average magnetic field and current parameters on a grid. The parameters that are available for calculation/plotting are:

• field aligned current (scalar)

• divergence-free current function (scalar)

• divergence-free part of horizontal current (vector)

• curl-free part of horizontal current (vector)

• total horizontal current (vector)

• eastward or northward ground perturbation corresponding to equivalent current (scalars)

For questions and comments, please contact karl.laundal at ift.uib.no

pip install pyamps

Quick Start

>>> # initialize by supplying a set of external conditions:
>>> from pyamps import AMPS
>>> m = AMPS(350, # Solar wind velocity in km/s
              -4, # IMF By (GSM) in nT
              -3, # IMF Bz (GSM) in nT,
              20, # dipole tilt angle in degrees
              80) # F107_index
>>> # make summary plot:
>>> m.plot_currents()

>>> # All the different current functions can be calculated on
>>> # a pre-defined or user-specified grid.
>>> import numpy as np
>>> mlat, mlt = np.array([75, -75]), np.array([12, 12])
>>> Ju = m.get_upward_current(mlat, mlt)
>>> Ju
array([ 0.23323377, -0.05599236])

Badges

docs
tests
package

Changelog

Version 1.1: Added support for calculations on regular mlat/mlt grids with less memory use Version 1.4: Updated model vectors and fixed a bug which affected toroidal field Version 1.4.1: Now using IGRF-13 when calculating dipole position (used in mlt_utils) Version 1.5: Updated model vector + removed LaTeX dependencies + a couple of minor fixes Version 1.6: Updated model vector + removed deprecated Multi-dimensional indexing Version 1.7: Added get_J_horiz function to calculate horizontal currents efficiently with dask Version 1.7.1: Now using IGRF-14 when calculating dipole position (used in mlt_utils) Version 1.8: Updated model vector