{ "info": { "author": "Karl M. Laundal", "author_email": "karl.laundal@ift.uib.no", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Operating System :: Microsoft :: Windows", "Operating System :: POSIX", "Operating System :: Unix", "Programming Language :: Python", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Scientific/Engineering :: Physics" ], "description": "Overview\n========\n|docs| |version| |doi|\n\nPython interface for the Average Magnetic field and Polar current System (AMPS) model.\n\nThe AMPS model is an empirical model of the ionospheric current system and associated magnetic field. The model magnetic field and currents are continuous functions of solar wind velocity, the interplanetary magnetic field, the tilt of the Earth's dipole magnetic field with respect to the Sun, and the 10.7 cm solar radio flux index F10.7. Given these parameters, model values of the ionospheric magnetic field can be calculated anywhere in space, and, with certain assumptions, on ground. The full current system, horizontal + field-aligned, are defined everywhere in the polar regions. The model is based on magnetic field measurements from the low Earth orbiting Swarm and CHAMP satellites.\n\npyAMPS can be used to calculate and plot average magnetic field and current parameters on a grid. The parameters that are available for calculation/plotting are:\n\n- field aligned current (scalar)\n- divergence-free current function (scalar)\n- divergence-free part of horizontal current (vector)\n- curl-free part of horizontal current (vector)\n- total horizontal current (vector)\n- eastward or northward ground perturbation corresponding to equivalent current (scalars)\n\nFor questions and comments, please contact karl.laundal at ift.uib.no\n\nInstallation\n------------\n\nUsing pip::\n\n pip install pyamps\n\n\nDependencies:\n\n- numpy\n- pandas\n- dask\n- matplotlib (with LaTeX support, see https://matplotlib.org/users/usetex.html)\n- scipy (scipy.interpolate for plotting purposes)\n- apexpy (magnetic coordinate conversion)\n\nQuick Start\n-----------\n.. code-block:: python\n\n >>> # initialize by supplying a set of external conditions:\n >>> from pyamps import AMPS\n >>> m = AMPS(350, # Solar wind velocity in km/s \n -4, # IMF By (GSM) in nT\n -3, # IMF Bz (GSM) in nT, \n 20, # dipole tilt angle in degrees \n 80) # F107_index\n >>> # make summary plot:\n >>> m.plot_currents()\n\n.. image:: docs/static/example_plot.png\n :alt: Field-aligned (colour) and horizontal (pins) currents\n\n.. code-block:: python\n\n >>> # All the different current functions can be calculated on\n >>> # a pre-defined or user-specified grid.\n >>> import numpy as np \n >>> mlat, mlt = np.array([75, -75]), np.array([12, 12])\n >>> Ju = m.get_upward_current(mlat, mlt)\n >>> Ju\n array([ 0.23323377, -0.05599236])\n\nDocumentation\n-------------\nSee `http://pyamps.readthedocs.io` \n\nReferences\n----------\nLaundal, K. M., Finlay, C. C., Olsen, N. & Reistad, J. P. (2018), Solar wind and seasonal influence on ionospheric currents from Swarm and CHAMP measurements, Journal of Geophysical Research - Space Physics. `doi:10.1029/2018JA025387 `_\n\n*Since April 2019, pyAMPS uses an updated set of model coefficients compared to the model discussed in the paper. The only difference is that the updated set of model coefficients were calculated using a larger Swarm dataset.*\n\nSee also:\nLaundal, K. M., Finlay, C. C. & Olsen, N. (2016), Sunlight effects on the 3D polar current system determined from low Earth orbit measurements. Earth Planets Space. `doi:10.1186/s40623-016-0518-x `_ \n\n\nAcknowledgments\n---------------\nThe code is produced with support from ESA through the Swarm Data Innovation and Science Cluster (Swarm DISC). For more information on Swarm DISC, please visit https://earth.esa.int/web/guest/missions/esa-eo-missions/swarm/disc\n\n\nBadges\n------\n\n.. list-table::\n :stub-columns: 1\n\n * - docs\n - |docs|\n * - tests\n - | |travis| |appveyor| |requires| \n * - package\n - | |version|\n\n.. |docs| image:: https://readthedocs.org/projects/pyamps/badge/?version=latest\n :target: http://pyamps.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n.. |version| image:: https://badge.fury.io/py/pyamps.svg\n :alt: PyPI Package latest release\n :target: https://badge.fury.io/py/pyamps\n\n.. |coveralls| image:: https://coveralls.io/repos/github/klaundal/pyAMPS/badge.svg\n :target: https://coveralls.io/github/klaundal/pyAMPS\n :alt: Coverage Status\n\n.. |requires| image:: https://requires.io/github/klaundal/pyAMPS/requirements.svg?branch=master\n :target: https://requires.io/github/klaundal/pyAMPS/requirements/?branch=master\n :alt: Requirements Status\n\n.. |travis| image:: https://travis-ci.org/klaundal/pyAMPS.svg?branch=master\n :alt: Travis CI Build Status\n :target: https://travis-ci.org/klaundal/pyAMPS\n\n.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/gyh9ognf7qbpsos7?svg=true\n :alt: AppVeyor Build Status\n :target: https://ci.appveyor.com/project/klaundal/pyamps \n\n.. |doi| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.1182931.svg\n :target: https://doi.org/10.5281/zenodo.1182931\nChangelog\n=========\n\nVersion 1.1: Added support for calculations on regular mlat/mlt grids with less memory use\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/klaundal/pyAMPS", "keywords": "AMPS,Average Magnetic field and Polar current System,magnetic field,spherical harmonics model,associated Legendre polynomial,mlt,magnetic local time,subsolar,dipole coordinates,converting", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "pyamps", "package_url": "https://pypi.org/project/pyamps/", "platform": "", "project_url": "https://pypi.org/project/pyamps/", "project_urls": { "Homepage": "https://github.com/klaundal/pyAMPS" }, "release_url": "https://pypi.org/project/pyamps/1.3.1/", "requires_dist": [ "setuptools (>=30.3.0)", "future (>=0.16)", "numpy (>=1.14)", "matplotlib", "scipy (>=0.9)", "toolz (>=0.8)", "pandas (>=0.20)", "dask", "apexpy (>=1.0)", "sphinx (>=1.3); extra == 'dev'", "sphinx-pypi-upload; extra == 'dev'", "pytest; extra == 'test'" ], "requires_python": "", "summary": "Calculate and plot maps of the model Average Magnetic field and Polar current System (AMPS)", "version": "1.3.1" }, "last_serial": 5232307, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "e9ef2d4ac9d22af96bf2b63b6267ad92", "sha256": "635ded8773221ae139efff8bb2e7265ce929982406ced8a1a2b0cad2d2202f0f" }, "downloads": -1, "filename": "pyamps-1.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "e9ef2d4ac9d22af96bf2b63b6267ad92", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 205410, "upload_time": "2018-02-21T19:57:19", "url": "https://files.pythonhosted.org/packages/b2/3c/3f33681f7392cab0e6c3ed06336298f1eef13056e07563463f76c5850939/pyamps-1.0.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2bb1bd59966ad72584ad9c7e5df4c7d2", "sha256": "6d46fe545a8fe644a51a1a77582bb92ff454caab2e4f346af4b6c9fd79c86e3b" }, "downloads": -1, "filename": "pyamps-1.0.0.tar.gz", "has_sig": false, "md5_digest": "2bb1bd59966ad72584ad9c7e5df4c7d2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13824976, "upload_time": "2018-02-21T19:59:27", "url": "https://files.pythonhosted.org/packages/f5/ac/2535bbfbc8507cb1cb0d3b02c5099faf86a5224c5afae5d68cde60dff2de/pyamps-1.0.0.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "258545583e149e4e2cd49de2cbac9019", "sha256": "7fb570f10b22df42e0227ec07ea5262f8778b98fc5ffb55101e01aff2d47066c" }, "downloads": -1, "filename": "pyamps-1.1.0-py2.7.egg", "has_sig": false, "md5_digest": "258545583e149e4e2cd49de2cbac9019", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 245058, "upload_time": "2018-09-27T10:29:40", "url": "https://files.pythonhosted.org/packages/2c/67/562d01e9bc8a3326c83a74b6b93888a19202bd2d3c5b9fe50c9894b82b6e/pyamps-1.1.0-py2.7.egg" }, { "comment_text": "", "digests": { "md5": "4c281ec58ee4d8f134efa11e0e0356ba", "sha256": "988db133888e0b6f25d01401a06c070868c0ec935eb1b597a6c6495ef4d2cf39" }, "downloads": -1, "filename": "pyamps-1.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "4c281ec58ee4d8f134efa11e0e0356ba", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 204375, "upload_time": "2018-09-26T11:25:17", "url": "https://files.pythonhosted.org/packages/7e/12/897f08cf130d42890b963b3ac3d4574745f4307c0997b139e8cd4cf3b8fe/pyamps-1.1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ee0384d8e50940f3486a4e1876c3242b", "sha256": "bab821749e124ecfc3f42a357d7496cccebf3834778f95ed2f1bd6201ca82cd3" }, "downloads": -1, "filename": "pyamps-1.1.0.tar.gz", "has_sig": false, "md5_digest": "ee0384d8e50940f3486a4e1876c3242b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13862179, "upload_time": "2018-09-27T10:29:44", "url": "https://files.pythonhosted.org/packages/ae/54/776a5cff4ba4ffc8b7485ca8ef48981d75d272ab513b87e1f0def7567820/pyamps-1.1.0.tar.gz" } ], "1.2.0": [ { "comment_text": "", "digests": { "md5": "d487cf82b98f8ec8dc163217e66987ab", "sha256": "34e77645586f73118411892dcf66144cc094bdc283a92733d21616900e058d6e" }, "downloads": -1, "filename": "pyamps-1.2.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "d487cf82b98f8ec8dc163217e66987ab", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 205076, "upload_time": "2018-09-27T10:29:36", "url": "https://files.pythonhosted.org/packages/22/8d/23f37e415dba2546e8a5fab980213b8ac7ae2644e2aaca3fc2bc3aca1a3c/pyamps-1.2.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e6598fabe2837f78d377a7695dba66c3", "sha256": "686f46bf9f990ef1db8cd5f888a309abb0b17d410fc46fc67115d155f321595d" }, "downloads": -1, "filename": "pyamps-1.2.0.tar.gz", "has_sig": false, "md5_digest": "e6598fabe2837f78d377a7695dba66c3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13862948, "upload_time": "2018-09-27T10:29:49", "url": "https://files.pythonhosted.org/packages/8a/45/99a1ca730b0e7c97adad1f508706f6e170351b8078c4514ed51d8ac177b3/pyamps-1.2.0.tar.gz" } ], "1.2.1": [ { "comment_text": "", "digests": { "md5": "b0344c8de3ced61035da32209735c2fe", "sha256": "5276342b5da367f530eb0b579162c9c0698b26a11d29a7865e05e04ac0002acb" }, "downloads": -1, "filename": "pyamps-1.2.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "b0344c8de3ced61035da32209735c2fe", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 263993, "upload_time": "2018-09-27T10:59:21", "url": "https://files.pythonhosted.org/packages/ae/7d/2fe786991a3cfb72ba2724ad795b738a5a63558155fd5b6078ca27f7d83a/pyamps-1.2.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "66e52fed2f71c5c0d5cd09a1a4297649", "sha256": "ebf951682d370f7890c1a0f196fa1a971aa7d9e248ad6df46cf7d16c4dafc4b7" }, "downloads": -1, "filename": "pyamps-1.2.1.tar.gz", "has_sig": false, "md5_digest": "66e52fed2f71c5c0d5cd09a1a4297649", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13920630, "upload_time": "2018-09-27T10:59:26", "url": "https://files.pythonhosted.org/packages/a4/23/ee9fd3431c8a125c000580ae92829e3bfe3c4bdaa4b1de88a86278b8b190/pyamps-1.2.1.tar.gz" } ], "1.2.2": [ { "comment_text": "", "digests": { "md5": "6af3c8b64e95a31253891583ed360666", "sha256": "de6faeb5448a4bb9f52e1280212a5efa9ab9a8c4df7de5a29f00275aaaa6802d" }, "downloads": -1, "filename": "pyamps-1.2.2-py3-none-any.whl", "has_sig": false, "md5_digest": "6af3c8b64e95a31253891583ed360666", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 264858, "upload_time": "2019-03-21T08:56:39", "url": "https://files.pythonhosted.org/packages/38/de/b4486d81676da75361fc0cac8a372c2e59a2af637d53fe816ded7857669c/pyamps-1.2.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f2b97dee254c7fb638964e59be6f46f0", "sha256": "9c1fd316c70d78a073b02096be2d249dd37ec94e82e5beee85e935aee2b55ce8" }, "downloads": -1, "filename": "pyamps-1.2.2.tar.gz", "has_sig": false, "md5_digest": "f2b97dee254c7fb638964e59be6f46f0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13913453, "upload_time": "2019-03-21T08:55:56", "url": "https://files.pythonhosted.org/packages/97/d3/130f7eeff6d0a3b9504fc10b017fc656040c360859813d09650f3449e920/pyamps-1.2.2.tar.gz" } ], "1.3.0": [ { "comment_text": "", "digests": { "md5": "3d9481f8832357b8fd8be1d41a4e2e63", "sha256": "5855fcb7c16075a004eca032ee32389b42f6af0d373733f0d464dda0ad7570e8" }, "downloads": -1, "filename": "pyamps-1.3.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "3d9481f8832357b8fd8be1d41a4e2e63", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 265132, "upload_time": "2019-05-06T11:47:12", "url": "https://files.pythonhosted.org/packages/8c/e1/62ea325136a845220b5c23cc3a02b0b222c014f24032e7342707a7bc85e6/pyamps-1.3.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4b8cdcf9abc9ade5eea4873a62ca4799", "sha256": "53111a59538c39ce0324d63cc9ae0be2195e16c6bcfbea26b70d1153777bb475" }, "downloads": -1, "filename": "pyamps-1.3.0.tar.gz", "has_sig": false, "md5_digest": "4b8cdcf9abc9ade5eea4873a62ca4799", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13856997, "upload_time": "2019-05-06T11:47:15", "url": "https://files.pythonhosted.org/packages/2d/3a/9f11c0fc1f9daf869005dff5589b399a537319df8d54983f3b06164f80a1/pyamps-1.3.0.tar.gz" } ], "1.3.1": [ { "comment_text": "", "digests": { "md5": "9a1e409018c0caa6f08adbef882446cd", "sha256": "976da24ebefb5b4145a19aba924e983848810b2de8d91af5d4dbba17f4e42fdc" }, "downloads": -1, "filename": "pyamps-1.3.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "9a1e409018c0caa6f08adbef882446cd", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 434011, "upload_time": "2019-05-06T11:56:21", "url": "https://files.pythonhosted.org/packages/b4/44/9c623f923765a73956fead4a5ac25d42fa7b45f25f11a46e7ffa0899d161/pyamps-1.3.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a4ba88998ee592ca120f2bf150fd5f94", "sha256": "4cbb6f4758f21755039f775dca805acdbe51a982dc9ccb600038934fbf869ef7" }, "downloads": -1, "filename": "pyamps-1.3.1.tar.gz", "has_sig": false, "md5_digest": "a4ba88998ee592ca120f2bf150fd5f94", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14033909, "upload_time": "2019-05-06T11:56:25", "url": "https://files.pythonhosted.org/packages/11/87/0f19bde6d23c89f311f5d2fd51d418df32abca7d7cddedb1be48b5e4e2f8/pyamps-1.3.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9a1e409018c0caa6f08adbef882446cd", "sha256": "976da24ebefb5b4145a19aba924e983848810b2de8d91af5d4dbba17f4e42fdc" }, "downloads": -1, "filename": "pyamps-1.3.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "9a1e409018c0caa6f08adbef882446cd", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 434011, "upload_time": "2019-05-06T11:56:21", "url": "https://files.pythonhosted.org/packages/b4/44/9c623f923765a73956fead4a5ac25d42fa7b45f25f11a46e7ffa0899d161/pyamps-1.3.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a4ba88998ee592ca120f2bf150fd5f94", "sha256": "4cbb6f4758f21755039f775dca805acdbe51a982dc9ccb600038934fbf869ef7" }, "downloads": -1, "filename": "pyamps-1.3.1.tar.gz", "has_sig": false, "md5_digest": "a4ba88998ee592ca120f2bf150fd5f94", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14033909, "upload_time": "2019-05-06T11:56:25", "url": "https://files.pythonhosted.org/packages/11/87/0f19bde6d23c89f311f5d2fd51d418df32abca7d7cddedb1be48b5e4e2f8/pyamps-1.3.1.tar.gz" } ] }