Skip to content

aurorax-space/pyaurorax

Repository files navigation

AuroraX

GitHub tests PyPI version PyPI Python versions DOI

PyAuroraX is a Python library for interacting with AuroraX, a project working to be the world's first and foremost data platform for auroral science. The primary objective of AuroraX 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. This will be accomplished with the development of 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:

Installation

PyAuroraX is available on PyPI so pip can be used to install it:

$ pip install pyaurorax

Futhermore, if you want the most bleeding edge version of PyAuroraX, you can install it directly from the Github repository:

$ 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:

>>> 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, and the API Reference to help adjust your code.