Metadata-Version: 1.1
Name: aacgmv2
Version: 2.0.0
Summary: A Python wrapper for AACGM-v2 magnetic coordinates
Home-page: https://github.com/cmeeren/aacgmv2
Author: Christer van der Meeren
Author-email: cmeeren@gmail.com
License: MIT
Description: ========
        Overview
        ========
        
        |docs| |version|
        
        This is a Python wrapper for the `AACGM-v2 C library
        <https://engineering.dartmouth.edu/superdarn/aacgm.html>`_, which allows converting between geographic and magnetic coordinates. The currently included version of the C library is 2.2. The wrapper is provided "as is" in the hopes that it will be useful to the space science community, and will not automatically be updated when new versions of the C library is released. MLT calculations are included in the wrapper (not part of the C library, please see the documentation for implementation details). The package is free software (MIT license).
        
        Quick start
        ===========
        
        Install (requires NumPy)::
        
            pip install aacgmv2
        
        Convert between AACGM and geographic 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.08967974,  339.08967974])
        
        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
        ======
        
        .. list-table::
            :stub-columns: 1
        
            * - docs
              - |docs|
            * - tests
              - | |travis| |appveyor| |requires|
                | |coveralls| |codecov|
                | |landscape|  |codeclimate|
                | |scrutinizer| |codacy|
            * - package
              - | |version| |supported-versions|
                | |wheel| |supported-implementations|
        
        .. |docs| image:: https://readthedocs.org/projects/aacgmv2/badge/?version=stable&style=flat
            :target: https://readthedocs.org/projects/aacgmv2
            :alt: Documentation Status
        
        .. |travis| image:: https://travis-ci.org/cmeeren/aacgmv2.svg?branch=master
            :alt: Travis-CI Build Status
            :target: https://travis-ci.org/cmeeren/aacgmv2
        
        .. |appveyor| image:: https://ci.appveyor.com/api/projects/status/github/cmeeren/aacgmv2?branch=master&svg=true
            :alt: AppVeyor Build Status
            :target: https://ci.appveyor.com/project/cmeeren/aacgmv2
        
        .. |requires| image:: https://requires.io/github/cmeeren/aacgmv2/requirements.svg?branch=master
            :alt: Requirements Status
            :target: https://requires.io/github/cmeeren/aacgmv2/requirements/?branch=master
        
        .. |coveralls| image:: https://coveralls.io/repos/cmeeren/aacgmv2/badge.svg?branch=master&service=github
            :alt: Coverage Status
            :target: https://coveralls.io/github/cmeeren/aacgmv2
        
        .. |codecov| image:: https://codecov.io/github/cmeeren/aacgmv2/coverage.svg?branch=master
            :alt: Coverage Status
            :target: https://codecov.io/github/cmeeren/aacgmv2
        
        .. |landscape| image:: https://landscape.io/github/cmeeren/aacgmv2/master/landscape.svg?style=flat
            :target: https://landscape.io/github/cmeeren/aacgmv2/master
            :alt: Code Quality Status
        
        .. |codacy| image:: https://img.shields.io/codacy/af7fdf6be28841f283dfdbc1c01fa82a.svg?style=flat
            :target: https://www.codacy.com/app/cmeeren/aacgmv2
            :alt: Codacy Code Quality Status
        
        .. |codeclimate| image:: https://codeclimate.com/github/cmeeren/aacgmv2/badges/gpa.svg
           :target: https://codeclimate.com/github/cmeeren/aacgmv2
           :alt: CodeClimate Quality Status
        .. |version| image:: https://img.shields.io/pypi/v/aacgmv2.svg?style=flat
            :alt: PyPI Package latest release
            :target: https://pypi.python.org/pypi/aacgmv2
        
        .. |downloads| image:: https://img.shields.io/pypi/dm/aacgmv2.svg?style=flat
            :alt: PyPI Package monthly downloads
            :target: https://pypi.python.org/pypi/aacgmv2
        
        .. |wheel| image:: https://img.shields.io/pypi/wheel/aacgmv2.svg?style=flat
            :alt: PyPI Wheel
            :target: https://pypi.python.org/pypi/aacgmv2
        
        .. |supported-versions| image:: https://img.shields.io/pypi/pyversions/aacgmv2.svg?style=flat
            :alt: Supported versions
            :target: https://pypi.python.org/pypi/aacgmv2
        
        .. |supported-implementations| image:: https://img.shields.io/pypi/implementation/aacgmv2.svg?style=flat
            :alt: Supported implementations
            :target: https://pypi.python.org/pypi/aacgmv2
        
        .. |scrutinizer| image:: https://img.shields.io/scrutinizer/g/cmeeren/aacgmv2/master.svg?style=flat
            :alt: Scrutinizer Status
            :target: https://scrutinizer-ci.com/g/cmeeren/aacgmv2/
        
        
        Changelog
        =========
        
        2.0.0 (2016-11-03)
        -----------------------------------------
        
        * Change method of calculating MLT, see documentation of convert_mlt for details
        
        
        1.0.13 (2015-10-30)
        -----------------------------------------
        
        * Correctly convert output of subsol() to geodetic coordinates (the error in MLT/mlon conversion was not large, typically two decimal places and below)
        
        
        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
        
Keywords: aacgm,aacgm-v2,aacgmv2,magnetic coordinates,altitude adjusted corrected geomagnetic coordinates,mlt,magnetic local time,conversion,converting
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Utilities
