<a href="https://aurorax.space/"><img alt="AuroraX" src="logo.svg" height="60"></a>
[](https://github.com/aurorax-space/pyaurorax/actions/workflows/test_standard.yml)
[](https://pypi.python.org/pypi/pyaurorax/)
[](https://doi.org/10.5281/zenodo.12532077)
PyAuroraX is a Python library providing data access and analysis support for All-Sky Imager data (THEMIS, TREx, REGO, etc.), the ability to utilize the TREx Auroral Transport Model, and interact with the AuroraX Search Engine. [AuroraX](https://aurorax.space) is a project working to be the world's first and foremost data platform for auroral science. The primary objective is to enable mining and exploration of existing and future auroral data, enabling key science and enhancing the benefits of the world's investment in auroral instrumentation. We have developed key systems/standards for uniform metadata generation and search, image content analysis, interfaces to leading international tools, and a community involvement that includes more than 80% of the world's data providers.
PyAuroraX officially supports Python 3.9+.
Some links to help:
- [Example Gallery](https://data.phys.ucalgary.ca/working_with_data/index.html#python)
- [PyAuroraX API Reference](https://docs.aurorax.space/code/pyaurorax_api_reference/pyaurorax)
- [AuroraX main website](https://aurorax.space)
## Installation
PyAuroraX is available on PyPI so pip can be used to install it:
```console
$ pip install pyaurorax
```
Futhermore, if you want the most bleeding edge version of PyAuroraX, you can install it directly from the Github repository:
```console
$ git clone https://github.com/aurorax-space/pyaurorax.git
$ cd pyaurorax
$ pip install .
```
## Usage
There are two things you can use as part of the PyAuroraX library: the main library, and the command line tool.
You can import the library using the following statement:
```python
>>> import pyaurorax
>>> aurorax = pyaurorax.PyAuroraX()
```
The program `aurorax-cli` is included in the PyAuroraX package as a command line tool. Try it out using:
```
$ aurorax-cli --help
```
## Migrating from V0 to V1
A significant upgrade was released for PyAuroraX for version 1.0.0. A major code reorganization and addition of many new features is part of version 1.x, and therefore includes breaking changes. The existing codebase from v0.13.3 and earlier has remained mostly unchanged, but, has been reorganized and some classes
were renamed. Simply changing the names of imports, function calls, and/or class instantiations should suffice in most cases.
Please refer to the `RELEASE_NOTES.md` file for a full breakdown of what was changed, the [documentation](https://docs.aurorax.space/code/overview), and the [API Reference](https://docs.aurorax.space/code/pyaurorax_api_reference/pyaurorax) to help adjust your code.
## Contributing
Bug reports, feature suggestions, and other contributions are greatly appreciated!
Templates for bug report and feature suggestions can be found when creating a Github Issue. If you have questions or issues installing PyAuroraX, we encourage that you open up a topic in the Github Discussions page.
Raw data
{
"_id": null,
"home_page": "https://github.com/aurorax-space/pyaurorax",
"name": "pyaurorax",
"maintainer": "Darren Chaddock",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "dchaddoc@ucalgary.ca",
"keywords": "aurorax, space physics, aurora, aurora borealis, northern lights, southern lights",
"author": "Darren Chaddock",
"author_email": "dchaddoc@ucalgary.ca",
"download_url": "https://files.pythonhosted.org/packages/ab/20/d13070ff965423450659c12617c5e1469eabcb726950f54aa27ada48b603/pyaurorax-1.3.2.tar.gz",
"platform": null,
"description": "<a href=\"https://aurorax.space/\"><img alt=\"AuroraX\" src=\"logo.svg\" height=\"60\"></a>\n\n[](https://github.com/aurorax-space/pyaurorax/actions/workflows/test_standard.yml)\n[](https://pypi.python.org/pypi/pyaurorax/)\n\n[](https://doi.org/10.5281/zenodo.12532077)\n\nPyAuroraX is a Python library providing data access and analysis support for All-Sky Imager data (THEMIS, TREx, REGO, etc.), the ability to utilize the TREx Auroral Transport Model, and interact with the AuroraX Search Engine. [AuroraX](https://aurorax.space) is a project working to be the world's first and foremost data platform for auroral science. The primary objective is to enable mining and exploration of existing and future auroral data, enabling key science and enhancing the benefits of the world's investment in auroral instrumentation. We have developed key systems/standards for uniform metadata generation and search, image content analysis, interfaces to leading international tools, and a community involvement that includes more than 80% of the world's data providers.\n\nPyAuroraX officially supports Python 3.9+.\n\nSome links to help:\n- [Example Gallery](https://data.phys.ucalgary.ca/working_with_data/index.html#python)\n- [PyAuroraX API Reference](https://docs.aurorax.space/code/pyaurorax_api_reference/pyaurorax)\n- [AuroraX main website](https://aurorax.space)\n\n## Installation\n\nPyAuroraX is available on PyPI so pip can be used to install it:\n\n```console\n$ pip install pyaurorax\n```\n\nFuthermore, if you want the most bleeding edge version of PyAuroraX, you can install it directly from the Github repository:\n\n```console\n$ git clone https://github.com/aurorax-space/pyaurorax.git\n$ cd pyaurorax\n$ pip install .\n```\n\n## Usage\n\nThere are two things you can use as part of the PyAuroraX library: the main library, and the command line tool.\n\nYou can import the library using the following statement:\n\n```python\n>>> import pyaurorax\n>>> aurorax = pyaurorax.PyAuroraX()\n```\n\nThe program `aurorax-cli` is included in the PyAuroraX package as a command line tool. Try it out using:\n\n```\n$ aurorax-cli --help\n```\n\n## Migrating from V0 to V1\n\nA significant upgrade was released for PyAuroraX for version 1.0.0. A major code reorganization and addition of many new features is part of version 1.x, and therefore includes breaking changes. The existing codebase from v0.13.3 and earlier has remained mostly unchanged, but, has been reorganized and some classes\nwere renamed. Simply changing the names of imports, function calls, and/or class instantiations should suffice in most cases. \n\nPlease refer to the `RELEASE_NOTES.md` file for a full breakdown of what was changed, the [documentation](https://docs.aurorax.space/code/overview), and the [API Reference](https://docs.aurorax.space/code/pyaurorax_api_reference/pyaurorax) to help adjust your code.\n\n## Contributing\n\nBug reports, feature suggestions, and other contributions are greatly appreciated!\n\nTemplates for bug report and feature suggestions can be found when creating a Github Issue. If you have questions or issues installing PyAuroraX, we encourage that you open up a topic in the Github Discussions page.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python library for interacting with the AuroraX platform",
"version": "1.3.2",
"project_urls": {
"API Reference": "https://docs.aurorax.space/code/pyaurorax_api_reference/pyaurorax",
"AuroraX Platform": "https://aurorax.space",
"Bug Tracker": "https://github.com/aurorax-space/pyaurorax/issues",
"Documentation": "https://docs.aurorax.space/code/overview",
"Homepage": "https://github.com/aurorax-space/pyaurorax",
"Repository": "https://github.com/aurorax-space/pyaurorax"
},
"split_keywords": [
"aurorax",
" space physics",
" aurora",
" aurora borealis",
" northern lights",
" southern lights"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0d87edf8dd3a497515ecae86ba536c5a016085a3e251c8638c34a0a8bd468210",
"md5": "b4805de3acfe01598ae5f74eca55d325",
"sha256": "41f105203f764b12b7c1963cf2953013229cb5d71d5785b735bda6ca5808f791"
},
"downloads": -1,
"filename": "pyaurorax-1.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b4805de3acfe01598ae5f74eca55d325",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 199595,
"upload_time": "2024-10-29T21:05:54",
"upload_time_iso_8601": "2024-10-29T21:05:54.261897Z",
"url": "https://files.pythonhosted.org/packages/0d/87/edf8dd3a497515ecae86ba536c5a016085a3e251c8638c34a0a8bd468210/pyaurorax-1.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ab20d13070ff965423450659c12617c5e1469eabcb726950f54aa27ada48b603",
"md5": "2f4eca7766f37258a899f2f9d3ab77c6",
"sha256": "f6d92368279e1f9dce10651ce8df5e7eeb94081aaade5fffca79be946f788a17"
},
"downloads": -1,
"filename": "pyaurorax-1.3.2.tar.gz",
"has_sig": false,
"md5_digest": "2f4eca7766f37258a899f2f9d3ab77c6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 109182,
"upload_time": "2024-10-29T21:05:57",
"upload_time_iso_8601": "2024-10-29T21:05:57.349545Z",
"url": "https://files.pythonhosted.org/packages/ab/20/d13070ff965423450659c12617c5e1469eabcb726950f54aa27ada48b603/pyaurorax-1.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-29 21:05:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "aurorax-space",
"github_project": "pyaurorax",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "pyaurorax"
}
JSON
