solo-sis-loader


Namesolo-sis-loader JSON
Version 0.2.0 PyPI version JSON
download
home_pagehttps://github.com/AthKouloumvakos/solo-sis-loader
SummarySolO-SIS-Loader: A python data loader for Suprathermal Ion Spectrograph (SIS) instrument onboard Solar Orbiter (SolO).
upload_time2025-01-23 00:28:48
maintainerNone
docs_urlNone
authorAthanasios Kouloumvakos
requires_python>=3.8
licenseGPL-3.0
keywords science solar physics solar sun solar energetic particles
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # SolO-SIS-Loader: A python data loader for Suprathermal Ion Spectrograph (SIS) instrument on board Solar Orbiter.

[![made-with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg)](https://www.python.org/)
[![Version](https://img.shields.io/github/v/release/AthKouloumvakos/solo-sis-loader)](https://github.com/AthKouloumvakos/solo-sis-loader/releases)
[![Release Date](https://img.shields.io/github/release-date/AthKouloumvakos/solo-sis-loader)](https://github.com/AthKouloumvakos/solo-sis-loader/releases)
[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
![flake8](https://github.com/AthKouloumvakos/solo-sis-loader/actions/workflows/flake8.yml/badge.svg)
![pytest](https://github.com/AthKouloumvakos/solo-sis-loader/actions/workflows/pytest.yml/badge.svg)
[![pypi](https://img.shields.io/pypi/v/solo-sis-loader?style=flat&logo=pypi)](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[![made-with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg)](https://www.python.org/)\n[![Version](https://img.shields.io/github/v/release/AthKouloumvakos/solo-sis-loader)](https://github.com/AthKouloumvakos/solo-sis-loader/releases)\n[![Release Date](https://img.shields.io/github/release-date/AthKouloumvakos/solo-sis-loader)](https://github.com/AthKouloumvakos/solo-sis-loader/releases)\n[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n![flake8](https://github.com/AthKouloumvakos/solo-sis-loader/actions/workflows/flake8.yml/badge.svg)\n![pytest](https://github.com/AthKouloumvakos/solo-sis-loader/actions/workflows/pytest.yml/badge.svg)\n[![pypi](https://img.shields.io/pypi/v/solo-sis-loader?style=flat&logo=pypi)](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"
}
        
Elapsed time: 0.40544s