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 quick piece-wise examples in Python and IDL are available to help you get started on working with the data.

Downloading Data#

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

Software Packages#

NEW! Analysis support software for optical and riometer data

During 2024, we released new analysis support libraries for working with the optical and riometer data we provide. Software is available for both Python and IDL.

PyAuroraX / IDL-AuroraX are for working with the optical data (all-sky imagers, spectrographs), and PyUCRio / IDL-UCRio are for working with the riometer data (single frequency riometers, hyper-spectral riometers).

Examples of using these libraries are shown in the below crib sheets. 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:

  • Optical instruments (All-sky Imagers, Spectrographs)

  • Riometer instruments (single frequency riometers, hyper-spectral riometers)

If you have any questions or feature requests for the software packages, feel free to reach out to the UCalgary team: Emma Spanswick, Eric Donovan.

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, PyUCRio, IDL-AuroraX, and IDL-UCRio. 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.

Crib Sheets#

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

Python#

Package Category Description Open Added on
PyAuroraX Data Access Explore datasets and observatories 2024-06-23
PyAuroraX Data Access Download and read data 2024-06-23
PyAuroraX Data Access Download skymaps and calibrations 2024-06-23
PyAuroraX Analysis Support Creating maps of instrument field-of-views (FOVs) 2025-06-21
PyAuroraX Analysis Support Add contours to CCD images 2024-06-23
PyAuroraX Analysis Support Extract luminosity metrics from bounding box 2024-06-23
PyAuroraX Analysis Support Create THEMIS ASI movie 2024-06-23
PyAuroraX Analysis Support Create TREx RGB movie 2024-06-23
PyAuroraX Analysis Support Create TREx RGB 3Hz burst data movie 2025-06-21
PyAuroraX Analysis Support Create SMILE ASI movie 2025-06-21
PyAuroraX Analysis Support Create REGO keograms 2024-06-23
PyAuroraX Analysis Support Create THEMIS ASI keograms 2024-06-23
PyAuroraX Analysis Support Create TREx Blueline keograms 2024-06-23
PyAuroraX Analysis Support Create TREx NIR keograms 2024-06-23
PyAuroraX Analysis Support Create TREx RGB keograms 2024-06-23
PyAuroraX Analysis Support Create TREx RGB 3Hz burst data keograms 2024-12-14
PyAuroraX Analysis Support Create TREx Spectrograph keograms 2024-12-14
PyAuroraX Analysis Support Create SMILE ASI keograms 2025-06-21
PyAuroraX Analysis Support Create THEMIS ASI montages 2024-06-23
PyAuroraX Analysis Support Create TREx RGB montages 2024-06-23
PyAuroraX Analysis Support Create SMILE ASI montages 2025-06-21
PyAuroraX Analysis Support Create THEMIS ASI mosaic 2024-06-23
PyAuroraX Analysis Support Create TREx RGB mosaic 2024-06-23
PyAuroraX Analysis Support Create TREx RGB mosaic movie 2025-06-21
PyAuroraX Analysis Support Create TREx RGB 3Hz burst data mosaic 2025-06-21
PyAuroraX Analysis Support Create SMILE ASI mosaic 2025-06-21
PyAuroraX Analysis Support Create TREx Spectrograph+RGB mosaic 2024-12-14
PyAuroraX Analysis Support Plot TREx Spectrograph data 2024-12-14
PyAuroraX Analysis Support Compute absolute intensity from TREx Spectrograph data 2025-06-21
PyAuroraX Analysis Support Create REGO Rayleighs-converted mosaic 2024-06-23
PyAuroraX Analysis Support Add contours to mosaic 2024-06-23
PyAuroraX Analysis Support Apply REGO correction and calibrations 2024-06-23
PyAuroraX Analysis Support Apply TREx NIR correction and calibrations 2024-06-23
PyAuroraX Analysis Support Create multi-network mosaic 2024-06-23
PyAuroraX Analysis Support Create custom keogram 2024-06-23
PyAuroraX Analysis Support Mosaic with satellite location data 2024-06-23
PyAuroraX Analysis Support Load and plot THEMIS grid data 2024-06-23
PyAuroraX Analysis Support Load and plot TREx RGB grid data 2024-06-23
PyAuroraX Analysis Support Load and plot TREx NIR grid data 2024-06-23
PyAuroraX Analysis Support Load and plot REGO grid data 2024-06-23
PyAuroraX Analysis Support Load and plot TREx RGB 5577-derived grid data 2024-06-23
PyAuroraX Auroral Transport Model Perform ATM forward calculation 2024-06-23
PyAuroraX Auroral Transport Model Perform ATM forward calculation using custom spectrum 2024-06-23
PyAuroraX Auroral Transport Model Perform ATM inverse calculation 2024-06-23
PyAuroraX AuroraX Search Engine Explore data sources 2024-06-23
PyAuroraX AuroraX Search Engine Perform conjunction searches 2024-06-23
PyAuroraX AuroraX Search Engine Perform ephemeris searches 2024-06-23
PyAuroraX AuroraX Search Engine Perform data product searches 2024-06-23
PyAuroraX AuroraX Search Engine Determine data availability 2024-06-23
PyAuroraX AuroraX Search Engine Advanced metadata filter searching 2025-01-27
PyAuroraX AuroraX Search Engine Explore ML-enhanced conjunction and ephemeris searching 2024-12-14
PyUCRio Data Access Explore datasets and observatories 2024-12-14
PyUCRio Data Access Download and read data 2024-12-14
PyUCRio Analysis Support Plot riometer data 2024-12-14
PyUCRio Analysis Support Plot site locations on a map 2025-06-21

IDL#

Package Category Name Open Added on
IDL-AuroraX Data Access Explore datasets and observatories 2024-06-23
IDL-AuroraX Data Access Download data 2024-06-23
IDL-AuroraX Data Access Read data 2024-06-23
IDL-AuroraX Data Access Download and read calibration data 2025-06-21
IDL-AuroraX Data Access Download and read skymap data 2025-06-21
IDL-AuroraX Analysis Support Creating maps of instrument field-of-views (FOVs) 2025-06-21
IDL-AuroraX Analysis Support Creating maps of instrument FOVs with data availability integration 2025-06-21
IDL-AuroraX Analysis Support Add contours to CCD images 2024-06-23
IDL-AuroraX Analysis Support Extract luminosity metrics from bounding box (THEMIS) 2024-06-23
IDL-AuroraX Analysis Support Extract luminosity metrics from bounding box (TREx RGB) 2024-06-23
IDL-AuroraX Analysis Support Create THEMIS keograms 2024-06-23
IDL-AuroraX Analysis Support Create REGO keograms 2024-06-23
IDL-AuroraX Analysis Support Create TREx RGB keograms 2024-06-23
IDL-AuroraX Analysis Support Create TREx RGB 3Hz burst data keograms 2025-06-21
IDL-AuroraX Analysis Support Create TREx Spectrograph keograms 2025-06-21
IDL-AuroraX Analysis Support Create SMILE ASI keograms 2025-06-21
IDL-AuroraX Analysis Support Create THEMIS ASI montage 2024-06-23
IDL-AuroraX Analysis Support Create TREx RGB montage 2024-06-23
IDL-AuroraX Analysis Support Create SMILE ASI montage 2025-06-21
IDL-AuroraX Analysis Support Create THEMIS ASI mosaic 2024-06-23
IDL-AuroraX Analysis Support Create TREx RGB mosaic 2024-06-23
IDL-AuroraX Analysis Support Create TREx RGB mosaic movie 2024-06-23
IDL-AuroraX Analysis Support Create TREx RGB 3Hz burst data mosaic 2025-06-21
IDL-AuroraX Analysis Support Create SMILE ASI mosaic 2025-06-21
IDL-AuroraX Analysis Support Create TREx Spectrograph+RGB mosaic 2025-06-21
IDL-AuroraX Analysis Support Plot TREx Spectrograph data 2025-06-21
IDL-AuroraX Analysis Support Compute absolute intensity from TREx Spectrograph data 2025-06-21
IDL-AuroraX Analysis Support Create THEMIS ASI movie 2024-06-23
IDL-AuroraX Analysis Support Create TREx RGB movie 2024-06-23
IDL-AuroraX Analysis Support Create TREx RGB 3Hz burst data movie 2025-06-21
IDL-AuroraX Analysis Support Create SMILE ASI movie 2025-06-21
IDL-AuroraX Analysis Support Create custom keogram 2024-06-23
IDL-AuroraX Analysis Support Apply REGO correction and calibrations 2024-06-23
IDL-AuroraX Analysis Support Apply TREx NIR correction and calibrations 2024-06-23
IDL-AuroraX Analysis Support Mosaic with satellite location data (single spacecraft) 2024-06-23
IDL-AuroraX Analysis Support Mosaic with satellite location data (multiple spacecraft) 2024-06-23
IDL-AuroraX Analysis Support REGO mosaic in calibrated Rayleighs 2024-06-23
IDL-AuroraX Analysis Support Create multi-network mosaic 2024-06-23
IDL-AuroraX Analysis Support Load and plot THEMIS grid data 2024-06-23
IDL-AuroraX Analysis Support Load and plot TREx RGB grid data 2024-06-23
IDL-AuroraX Analysis Support Load and plot TREx NIR grid data 2024-06-23
IDL-AuroraX Analysis Support Load and plot REGO grid data 2024-06-23
IDL-AuroraX Analysis Support Load and plot TREx RGB 5577-derived grid data 2024-06-23
IDL-AuroraX Auroral Transport Model Perform ATM forward calculation 2024-06-27
IDL-AuroraX Auroral Transport Model Perform ATM forward calculation using custom spectrum 2024-06-27
IDL-AuroraX Auroral Transport Model Perform ATM inverse calculation 2024-06-27
IDL-AuroraX AuroraX Search Engine Explore data sources 2024-06-23
IDL-AuroraX AuroraX Search Engine Perform conjunction searches 2024-06-23
IDL-AuroraX AuroraX Search Engine Perform ephemeris searches 2024-06-23
IDL-AuroraX AuroraX Search Engine Perform data product searches 2024-06-23
IDL-AuroraX AuroraX Search Engine Determine data availability 2024-06-23
IDL-AuroraX AuroraX Search Engine Advanced metadata filter searching 2025-02-27
IDL-AuroraX AuroraX Search Engine Explore machine learning metadata in AuroraX 2025-02-27
IDL-UCRio Data Access Explore datasets and observatories 2025-06-21
IDL-UCRio Data Access Download data 2025-06-21
IDL-UCRio Data Access Reading data 2025-06-21
IDL-UCRio Analysis Support Plot riometer data 2025-06-21
IDL-UCRio Analysis Support Creating maps of instrument locations 2025-06-21