Metadata-Version: 1.1
Name: apexpy
Version: 1.0.2
Summary: A Python wrapper for Apex coordinates
Home-page: https://github.com/aburrell/apexpy
Author: Christer van der Meeren; Angeline G. Burrell
Author-email: agb073000@utdallas.edu
License: MIT
Description-Content-Type: UNKNOWN
Description: ========
        Overview
        ========
        
        |docs| |version|
        
        This is a Python wrapper for the Apex fortran library by Emmert et al. [2010] [1]_, which allows converting between geodetic, modified apex, and quasi-dipole coordinates as well as getting modified apex and quasi-dipole base vectors (Richmond [1995] [2]_). MLT calculations are also included. The package is free software (MIT license).
        
        Quick start
        ===========
        
        Install (requires NumPy)::
        
            pip install apexpy
        
        Conversion is done by creating an ``Apex`` object and using its methods to perform the desired calculations. Some simple examples::
        
            >>> from apexpy import Apex
            >>> from __future__ import print_function
            >>> A = Apex(date=2015.3)  # datetime objects are also supported
            >>> # geo to apex, scalar input
            >>> mlat, mlon = A.convert(60, 15, 'geo', 'apex', height=300)
            >>> print("{:.12f}, {:.12f}".format(mlat, mlon))
            57.469573974609, 93.633583068848
            >>> # apex to geo, array input
            >>> glat, glon = A.convert([90, -90], 0, 'apex', 'geo', height=0)
            >>> print(["{:.12f}, {:.12f}".format(ll, glon[i]) for i,ll in enumerate(glat)])
            ['83.099594116211, -84.594589233398', '-74.388267517090, 125.714927673340']
            >>> # geo to MLT
            >>> import datetime as dt
            >>> mlat, mlt = A.convert(60, 15, 'geo', 'mlt', datetime=dt.datetime(2015, 2, 10, 18, 0, 0))
            >>> print("{:.12f}, {:.12f}".format(mlat, mlt))
            56.590423583984, 19.108103879293
            >>> # can also convert magnetic longitude to mlt
            >>> mlt = A.mlon2mlt(120, dt.datetime(2015, 2, 10, 18, 0, 0))
            >>> print("{:.2f}".format(mlt))
            20.89
        
        If you don't know or use Python, you can also use the command line. See details in the full documentation.
        
        Documentation
        =============
        
        https://apexpy.readthedocs.org/
        
        References
        ==========
        
        .. [1] Emmert, J. T., A. D. Richmond, and D. P. Drob (2010),
               A computationally compact representation of Magnetic-Apex
               and Quasi-Dipole coordinates with smooth base vectors,
               J. Geophys. Res., 115(A8), A08322,
               `doi:10.1029/2010JA015326 <http://dx.doi.org/10.1029/2010JA015326>`_.
        
        .. [2] Richmond, A. D. (1995), Ionospheric Electrodynamics Using
               Magnetic Apex Coordinates, Journal of geomagnetism and
               geoelectricity, 47(2), 191–212,
               `doi:10.5636/jgg.47.191 <http://dx.doi.org/10.5636/jgg.47.191>`_.
        
        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/apexpy/badge/?style=flat
            :target: https://readthedocs.org/projects/apexpy
            :alt: Documentation Status
        
        .. |travis| image:: https://travis-ci.org/cmeeren/apexpy.svg?branch=master
            :alt: Travis-CI Build Status
            :target: https://travis-ci.org/cmeeren/apexpy
        
        .. |appveyor| image:: https://ci.appveyor.com/api/projects/status/github/cmeeren/apexpy?branch=master&svg=true
            :alt: AppVeyor Build Status
            :target: https://ci.appveyor.com/project/cmeeren/apexpy
        
        .. |requires| image:: https://requires.io/github/cmeeren/apexpy/requirements.svg?branch=master
            :alt: Requirements Status
            :target: https://requires.io/github/cmeeren/apexpy/requirements/?branch=master
        
        .. |coveralls| image:: https://coveralls.io/repos/cmeeren/apexpy/badge.svg?branch=master&service=github
            :alt: Coverage Status
            :target: https://coveralls.io/github/cmeeren/apexpy
        
        .. |codecov| image:: https://codecov.io/github/cmeeren/apexpy/coverage.svg?branch=master
            :alt: Coverage Status
            :target: https://codecov.io/github/cmeeren/apexpy
        
        .. |landscape| image:: https://landscape.io/github/cmeeren/apexpy/master/landscape.svg?style=flat
            :target: https://landscape.io/github/cmeeren/apexpy/master
            :alt: Code Quality Status
        
        .. |codacy| image:: https://img.shields.io/codacy/af7fdf6be28841f283dfdbc1c01fa82a.svg?style=flat
            :target: https://www.codacy.com/app/cmeeren/apexpy
            :alt: Codacy Code Quality Status
        
        .. |codeclimate| image:: https://codeclimate.com/github/cmeeren/apexpy/badges/gpa.svg
           :target: https://codeclimate.com/github/cmeeren/apexpy
           :alt: CodeClimate Quality Status
        .. |version| image:: https://img.shields.io/pypi/v/apexpy.svg?style=flat
            :alt: PyPI Package latest release
            :target: https://pypi.python.org/pypi/apexpy
        
        .. |downloads| image:: https://img.shields.io/pypi/dm/apexpy.svg?style=flat
            :alt: PyPI Package monthly downloads
            :target: https://pypi.python.org/pypi/apexpy
        
        .. |wheel| image:: https://img.shields.io/pypi/wheel/apexpy.svg?style=flat
            :alt: PyPI Wheel
            :target: https://pypi.python.org/pypi/apexpy
        
        .. |supported-versions| image:: https://img.shields.io/pypi/pyversions/apexpy.svg?style=flat
            :alt: Supported versions
            :target: https://pypi.python.org/pypi/apexpy
        
        .. |supported-implementations| image:: https://img.shields.io/pypi/implementation/apexpy.svg?style=flat
            :alt: Supported implementations
            :target: https://pypi.python.org/pypi/apexpy
        
        .. |scrutinizer| image:: https://img.shields.io/scrutinizer/g/cmeeren/apexpy/master.svg?style=flat
            :alt: Scrutinizer Status
            :target: https://scrutinizer-ci.com/g/cmeeren/apexpy/
        
        
        Changelog
        =========
        
        1.0.2 (2018-02-27)
        -----------------------------------------
        
        * Extend character limit for allowable data file path, and update documentation to reflect a change in maintainers.  Also updated testing implimentation, reduced fortran compiler warnings, and improved PEP8 compliance.
        
        1.0.1 (2016-03-10)
        -----------------------------------------
        
        * Remove geocentric to geodetic conversion of subsolar point based on feedback from Art Richmond. (The subsolar point is the same in geocentric and geodetic coordinates.) The helper function `gc2gdlat` have been kept to preserve backwards compatibility.
        
        
        1.0.0 (2015-11-30)
        -----------------------------------------
        
        * Initial release
        
Keywords: apex,modified apex,quasi-dipole,quasi dipole,coordinates,magnetic 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: Operating System :: MacOS :: MacOS X
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
