solo-sis-loader 0.2.0

SolO-SIS-Loader: A python data loader for Suprathermal Ion Spectrograph (SIS) instrument onboard Solar Orbiter (SolO).

SolO-SIS-Loader: A python data loader for Suprathermal Ion Spectrograph (SIS) instrument on board Solar Orbiter.

SolO-SIS-Loader is a python data loader for Suprathermal Ion Spectrograph (SIS) instrument on board Solar Orbiter. SIS is part of the Energetic Particle Detector (EPD) suite for the Solar Orbiter spacecraft and provides observations of He to Fe for an energy range from ∼100 keV/nucleon up to several MeV/nucleon.

🚀 Instrument Specifics

SIS is based on the ACE/ULEIS design which identifies particle species and energy by time-of-flight by energy technique. Particles are detected when they pass through the entrance foils and deposit their energy in the solid state detector at the back of the instrument. The very high mass resolution of m/sigma_m∼50 will allow SIS to measure particle populations with 3He/4He ratios down to <1%.

💾 Installation

SolO-SIS-Loader requires python >= 3.8 and can be installed from PyPI using pip. In the terminal do the following:

# install the required packages using pip
pip install solo-sis-loader

This will install all the necessary dependencies in the active python enviroment.

SolO-SIS-Loader can also be installed directly from the github repository using the latest developed version (not recomended).

pip install git+https://github.com/AthKouloumvakos/solo-sis-loader

📙 Usage

An example of how to search and download SIS data and load them in an xarray dataset.

from solo_sis_loader import SIS
import sunpy.net.attrs as a

t_start = '2022-09-04'
t_end = '2022-09-08'
stime = a.Time(t_start, t_end)
level = a.Level('L2')

sis = SIS()
response = sis.search(stime, level=level)
files = sis.fetch(response)
sis.load(files)

📦 Useful Python packages

• solo-epd-loader: A python data loader for Solar Orbiter's (SolO) Energetic Particle Detector (EPD).
• SunPy: The community-developed, free and open-source solar data analysis environment for Python.
• AstroPy: The Astropy Project is a community effort to develop a single core package for Astronomy in Python.

ⓘ Disclaimer

This software is provided "as is", with no guarantee. It is not an official data source, and not officially endorsed by the corresponding instrument team.

📜 Acknowledging or Citing SolO-SIS-Loader

If you use SolO-SIS-Loader for scientific work or research presented in a publication, please mention it in the main text and in the methods or acknowledgements section add the following: "This research has made use of SolO-SIS-Loader, a python data loader for Suprathermal Ion Spectrograph (SIS) instrument onboard Solar Orbiter (Zenodo: https://doi.org/).". You may also acknowledge SolO-SIS-Loader in posters or talks in the way you prefer. SolO-SIS-Loader has a strong dependency on SunPy and AstroPy Python packages, consider citing these packages as well.