Working with our data#

Our data is accessible using several different methods. In the Downloading data section we discuss these options, along with details about several software packages and our API. A collection of Crib Sheets outline comprehensive guides to using our data, followed by quick piece-wise examples in Python and IDL.

Downloading Data#

Our data is available using Python and IDL libraries, basic HTTP, Rsync, FTP, and our API directly.

Software Packages#

NEW! All-sky imager analysis support software

We have released new analysis support libraries for working with the All-Sky Imager (ASI) data we provide. Software is available for both Python and IDL, by using PyAuroraX and IDL-AuroraX, respectively.

Examples of using these libraries are shown in the below comprehensive crib sheets and piece-wise notebooks/example programs. If you have questions, please reach out to our team: Emma Spanswick, Eric Donovan.

UCalgary has several Python and IDL tools available to work with our data:

API#

The UCalgary Space Remote Sensing API is a RESTful web service that provides various functions for our data best facilitated by such a service. The API and its interactive documentation can be found at https://api.phys.ucalgary.ca.

The API it utilized by our Python and IDL libraries PyAuroraX, PyUCalgarySRS, and IDL-AuroraX. We recommend that you utilize these libraries instead of the API directly. However, the option is always there for you to use the API directly if it best suites your use-case. Please reach out to the UCalgary Team if you have any questions: Emma Spanswick, Eric Donovan.

Quick Examples#

The below links are meant to provide quick access to simple examples of various tasks when working with our data. These examples can also be found in the PyAuroraX and IDL-AuroraX Github repositories, if you prefer to browse them there.

Python#

Category Description
Data Access Explore datasets and observatories View
Data Access Download and read data View
Data Access Download skymaps and calibrations View
Analysis Support Add contours to CCD image View
Analysis Support Extract metrics from bounding box View
Analysis Support Create movie View
Analysis Support Create REGO keograms View
Analysis Support Create THEMIS ASI keograms View
Analysis Support Create TREx Blueline keograms View
Analysis Support Create TREx NIR keograms View
Analysis Support Create TREx RGB keograms View
Analysis Support Create THEMIS ASI montages View
Analysis Support Create TREx RGB montages View
Analysis Support Create THEMIS ASI mosaic View
Analysis Support Create TREx RGB mosaic View
Analysis Support Create REGO Rayleighs-converted mosaic View
Analysis Support Add contours to mosaic View
Analysis Support Apply REGO correction and calibrations View
Analysis Support Apply TREx NIR correction and calibrations View
Analysis Support Create multi-network mosaic View
Analysis Support Create custom keogram View
Analysis Support Mosaic with satellite location data View
Analysis Support Load and plot THEMIS grid data View
Analysis Support Load and plot TREx RGB grid data View
Analysis Support Load and plot TREx NIR grid data View
Analysis Support Load and plot REGO grid data View
Analysis Support Load and plot TREx RGB 5577-derived grid data View
Auroral Transport Model Perform ATM forward calculation View
Auroral Transport Model Perform ATM forward calculation using custom spectrum View
Auroral Transport Model Perform ATM inverse calculation View
AuroraX Search Engine Explore data sources View
AuroraX Search Engine Perform conjunction searches View
AuroraX Search Engine Perform ephemeris searches View
AuroraX Search Engine Perform data product searches View
AuroraX Search Engine Determine data availability View
AuroraX Search Engine View metadata in ephemeris records View

IDL#

Category Name
Data Access Explore datasets and observatories View
Data Access Download data View
Data Access Read data View
Analysis Support Add contours to CCD image View
Analysis Support Extract lumonosity from bounding box (THEMIS) View
Analysis Support Extract lumonosity from bounding box using percentile (TREx RGB) View
Analysis Support Create THEMIS keograms View
Analysis Support Create REGO keograms View
Analysis Support Create TREx RGB keograms View
Analysis Support Create THEMIS ASI montage View
Analysis Support Create TREx RGB montage View
Analysis Support Create THEMIS ASI mosaic View
Analysis Support Create TREx RGB mosaic View
Analysis Support Create movie View
Analysis Support Create custom keogram View
Analysis Support Apply REGO correction and calibrations View
Analysis Support Apply TREx NIR correction and calibrations View
Analysis Support Mosaic with satellite location data (single spacecraft) View
Analysis Support Mosaic with satellite location data (multiple spacecraft) View
Analysis Support REGO mosaic in calibrated Rayleighs View
Analysis Support Create multi-network mosaic View
Analysis Support Load and plot THEMIS grid data View
Analysis Support Load and plot TREx RGB grid data View
Analysis Support Load and plot TREx NIR grid data View
Analysis Support Load and plot REGO grid data View
Analysis Support Load and plot TREx RGB 5577-derived grid data View
Auroral Transport Model Perform ATM forward calculation View
Auroral Transport Model Perform ATM forward calculation using custom spectrum View
Auroral Transport Model Perform ATM inverse calculation View
AuroraX Search Engine Explore data sources View
AuroraX Search Engine Perform conjunction searches View
AuroraX Search Engine Perform ephemeris searches View
AuroraX Search Engine Perform data product searches View
AuroraX Search Engine Determine data availability View

Crib Sheets#

The below crib sheets are comprehensive guides in Python to using our data, providing in-depth information about analysis techniques. If you're new to our data, we recommend you start with these.

Name Category Notebook
Download and read ASI raw data Basic Jupyter Notebook  Open In Colab
Load, calibrate, and plot single channel ASI data Basic Jupyter Notebook  Open In Colab
Load, calibrate, and plot multi channel ASI data Basic Jupyter Notebook  Open In Colab
Georeferencing single channel ASI data Basic Jupyter Notebook  Open In Colab
Georeferencing multi channel ASI data Basic Jupyter Notebook  Open In Colab
Working with AuroraX satellite location data and ASIs Basic Jupyter Notebook  Open In Colab
Using the TREx Auroral Transport Model Basic Jupyter Notebook  Open In Colab
Multi network mosaics Advanced Jupyter Notebook  Open In Colab