aacgmv2 1.0.12

A Python wrapper for AACGM-v2 magnetic coordinates

This is a Python wrapper for the AACGM-v2 C library, which allows converting between geographic and magnetic coordinates. MLT calculations are also included. The package is free software (MIT license).

Quick start

Install (requires NumPy):

pip install aacgmv2

Convert between AACGM and magnetic coordinates:

>>> from aacgmv2 import convert
>>> from datetime import date
>>> # geo to AACGM, single numbers
>>> mlat, mlon = convert(60, 15, 300, date(2013, 11, 3))
>>> mlat
array(57.47207691280528)
>>> mlon
array(93.62138045643167)
>>> # AACGM to geo, mix arrays/numbers
>>> glat, glon = convert([90, -90], 0, 0, date(2013, 11, 3), a2g=True)
>>> glat
array([ 82.96656071, -74.33854592])
>>> glon
array([ -84.66516034,  125.84014944])

Convert between AACGM and MLT:

>>> from aacgmv2 import convert_mlt
>>> from datetime import datetime
>>> # MLT to AACGM
>>> mlon = convert_mlt([0, 12], datetime(2013, 11, 3, 18, 0), m2a=True)
>>> mlon
array([ 159.09467412,  339.09467412])

If you don’t know or use Python, you can also use the command line. See details in the full documentation.

Documentation

https://aacgmv2.readthedocs.org/

Badges

docs
tests
package

Changelog

1.0.12 (2015-10-26)

• Return nan in forbidden region instead of throwing exception

1.0.11 (2015-10-26)

• Fix bug in subsolar/MLT conversion

1.0.10 (2015-10-08)

• No code changes, debugged automatic build/upload process and needed new version numbers along the way

1.0.0 (2015-10-07)

• Initial release