# SolO-SIS-Loader: A python data loader for Suprathermal Ion Spectrograph (SIS) instrument on board Solar Orbiter.
[](https://www.python.org/)
[](https://github.com/AthKouloumvakos/solo-sis-loader/releases)
[](https://github.com/AthKouloumvakos/solo-sis-loader/releases)
[](https://www.gnu.org/licenses/gpl-3.0)


[](https://pypi.org/project/solo-sis-loader/)
_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:
```python
# 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).
```python
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.
```python
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](https://github.com/jgieseler/solo-epd-loader): A python data loader for Solar Orbiter's (SolO) Energetic Particle Detector (EPD).
- [SunPy](https://sunpy.org/): The community-developed, free and open-source solar data analysis environment for Python.
- [AstroPy](https://www.astropy.org/): 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/](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.
Raw data
{
"_id": null,
"home_page": "https://github.com/AthKouloumvakos/solo-sis-loader",
"name": "solo-sis-loader",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "science, solar physics, solar, sun, solar energetic particles",
"author": "Athanasios Kouloumvakos",
"author_email": "athkouloumvakos@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/79/78/5b24d60e6845a0e8d7357a1706f0b1c3e07be920852fb2e1f8f4b7e25252/solo_sis_loader-0.2.0.tar.gz",
"platform": "any",
"description": "# SolO-SIS-Loader: A python data loader for Suprathermal Ion Spectrograph (SIS) instrument on board Solar Orbiter.\n\n[](https://www.python.org/)\n[](https://github.com/AthKouloumvakos/solo-sis-loader/releases)\n[](https://github.com/AthKouloumvakos/solo-sis-loader/releases)\n[](https://www.gnu.org/licenses/gpl-3.0)\n\n\n[](https://pypi.org/project/solo-sis-loader/)\n\n_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 \u223c100 keV/nucleon up to several MeV/nucleon.\n\n## \ud83d\ude80 Instrument Specifics\n\nSIS 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\u223c50 will allow SIS to measure particle populations with 3He/4He ratios down to <1%.\n\n## \ud83d\udcbe Installation\n\n_SolO-SIS-Loader_ requires ```python >= 3.8``` and can be installed from PyPI using ```pip```. In the terminal do the following:\n\n```python\n# install the required packages using pip\npip install solo-sis-loader\n```\n\nThis will install all the necessary dependencies in the active python enviroment.\n\n_SolO-SIS-Loader_ can also be installed directly from the github repository using the latest developed version (not recomended).\n\n```python\npip install git+https://github.com/AthKouloumvakos/solo-sis-loader\n```\n\n## \ud83d\udcd9 Usage\n\nAn example of how to search and download SIS data and load them in an xarray dataset.\n\n```python\nfrom solo_sis_loader import SIS\nimport sunpy.net.attrs as a\n\nt_start = '2022-09-04'\nt_end = '2022-09-08'\nstime = a.Time(t_start, t_end)\nlevel = a.Level('L2')\n\nsis = SIS()\nresponse = sis.search(stime, level=level)\nfiles = sis.fetch(response)\nsis.load(files)\n```\n\n## \ud83d\udce6 Useful Python packages\n\n- [solo-epd-loader](https://github.com/jgieseler/solo-epd-loader): A python data loader for Solar Orbiter's (SolO) Energetic Particle Detector (EPD).\n- [SunPy](https://sunpy.org/): The community-developed, free and open-source solar data analysis environment for Python.\n- [AstroPy](https://www.astropy.org/): The Astropy Project is a community effort to develop a single core package for Astronomy in Python.\n\n## \u24d8 Disclaimer\n\nThis software is provided \"as is\", with no guarantee. It is not an official data source, and not officially endorsed by the corresponding instrument team.\n\n## \ud83d\udcdc Acknowledging or Citing _SolO-SIS-Loader_\n\nIf 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/](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.\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "SolO-SIS-Loader: A python data loader for Suprathermal Ion Spectrograph (SIS) instrument onboard Solar Orbiter (SolO).",
"version": "0.2.0",
"project_urls": {
"Documentation": "https://github.com/AthKouloumvakos/solo-sis-loader",
"Download": "https://pypi.org/project/solo-sis-loader",
"Homepage": "https://github.com/AthKouloumvakos/solo-sis-loader",
"Issue Tracker": "https://github.com/AthKouloumvakos/solo-sis-loader/issues",
"Source Code": "https://github.com/AthKouloumvakos/solo-sis-loader"
},
"split_keywords": [
"science",
" solar physics",
" solar",
" sun",
" solar energetic particles"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "79785b24d60e6845a0e8d7357a1706f0b1c3e07be920852fb2e1f8f4b7e25252",
"md5": "e5fd2585295cae3dc785a8b3a1f553bc",
"sha256": "8a9fc22ae75fb33a6b4fbb3bb234752728d01f1bd11121e99301937cbe1a8740"
},
"downloads": -1,
"filename": "solo_sis_loader-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "e5fd2585295cae3dc785a8b3a1f553bc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 25085,
"upload_time": "2025-01-23T00:28:48",
"upload_time_iso_8601": "2025-01-23T00:28:48.140432Z",
"url": "https://files.pythonhosted.org/packages/79/78/5b24d60e6845a0e8d7357a1706f0b1c3e07be920852fb2e1f8f4b7e25252/solo_sis_loader-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-23 00:28:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AthKouloumvakos",
"github_project": "solo-sis-loader",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "solo-sis-loader"
}