Skip to main content

A Python wrapper for AACGM-v2 magnetic coordinates

Project description

Documentation Status PyPI Package latest release

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
>>> mlon
>>> # 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.


docs Documentation Status
Travis-CI Build Status AppVeyor Build Status Requirements Status
Coverage Status Coverage Status
Code Quality Status CodeClimate Quality Status
Scrutinizer Status Codacy Code Quality Status
PyPI Package latest release Supported versions
PyPI Wheel Supported implementations


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

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
aacgmv2-1.0.12-cp27-none-win32.whl (470.2 kB) Copy SHA256 hash SHA256 Wheel cp27
aacgmv2-1.0.12-cp27-none-win_amd64.whl (474.4 kB) Copy SHA256 hash SHA256 Wheel cp27
aacgmv2-1.0.12-cp33-none-win32.whl (470.1 kB) Copy SHA256 hash SHA256 Wheel cp33
aacgmv2-1.0.12-cp33-none-win_amd64.whl (474.5 kB) Copy SHA256 hash SHA256 Wheel cp33
aacgmv2-1.0.12-cp34-none-win32.whl (470.1 kB) Copy SHA256 hash SHA256 Wheel cp34
aacgmv2-1.0.12-cp34-none-win_amd64.whl (474.5 kB) Copy SHA256 hash SHA256 Wheel cp34
aacgmv2-1.0.12-cp35-none-win32.whl (473.0 kB) Copy SHA256 hash SHA256 Wheel cp35
aacgmv2-1.0.12-cp35-none-win_amd64.whl (479.6 kB) Copy SHA256 hash SHA256 Wheel cp35 (518.6 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page