Metadata-Version: 2.0
Name: apexpy
Version: 1.0.0
Summary: A Python wrapper for Apex coordinates
Home-page: https://github.com/cmeeren/apexpy
Author: Christer van der Meeren
Author-email: cmeeren@gmail.com
License: MIT
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: 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
Requires-Dist: numpy

========
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
    >>> 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)
    >>> mlat
    57.469573974609375
    >>> mlon
    93.633583068847656
    >>> # apex to geo, array input
    >>> glat, glon = A.convert([90, -90], 0, 'apex', 'geo', height=0)
    >>> glat
    array([ 83.09959412, -74.38826752])
    >>> glon
    array([ -84.59458923,  125.71492767])
    >>> # geo to MLT
    >>> import datetime as dt
    >>> mlat, mlt = A.convert(60, 15, 'geo', 'mlt', datetime=dt.datetime(2015, 2, 10, 18, 0, 0))
    >>> mlat
    56.590423583984375
    >>> mlt
    19.107855542500815
    >>> # can also convert magnetic longitude to mlt
    >>> mlt = A.mlon2mlt(120, dt.datetime(2015, 2, 10, 18, 0, 0))
    >>> mlt
    20.893299166361491

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.0 (2015-11-30)
-----------------------------------------

* Initial release


