Solar-MACH: An open-source tool to analyze solar magnetic connection configurations

The Solar MAgnetic Connection HAUS1 tool (Solar-MACH) is an open-source tool completely written in Python that derives and visualizes the spatial configuration and solar magnetic connection of different observers (i.e., spacecraft or planets) in the heliosphere at different times. For doing this, th...

Full description

Bibliographic Details
Main Authors: Jan Gieseler, Nina Dresing, Christian Palmroos, Johan L. Freiherr von Forstner, Daniel J. Price, Rami Vainio, Athanasios Kouloumvakos, Laura Rodríguez-García, Domenico Trotta, Vincent Génot, Arnaud Masson, Markus Roth, Astrid Veronig
Format: Article
Language:English
Published: Frontiers Media S.A. 2023-02-01
Series:Frontiers in Astronomy and Space Sciences
Subjects:
Online Access:https://www.frontiersin.org/articles/10.3389/fspas.2022.1058810/full
_version_ 1797893701830180864
author Jan Gieseler
Nina Dresing
Christian Palmroos
Johan L. Freiherr von Forstner
Johan L. Freiherr von Forstner
Daniel J. Price
Rami Vainio
Athanasios Kouloumvakos
Laura Rodríguez-García
Domenico Trotta
Vincent Génot
Arnaud Masson
Markus Roth
Astrid Veronig
author_facet Jan Gieseler
Nina Dresing
Christian Palmroos
Johan L. Freiherr von Forstner
Johan L. Freiherr von Forstner
Daniel J. Price
Rami Vainio
Athanasios Kouloumvakos
Laura Rodríguez-García
Domenico Trotta
Vincent Génot
Arnaud Masson
Markus Roth
Astrid Veronig
author_sort Jan Gieseler
collection DOAJ
description The Solar MAgnetic Connection HAUS1 tool (Solar-MACH) is an open-source tool completely written in Python that derives and visualizes the spatial configuration and solar magnetic connection of different observers (i.e., spacecraft or planets) in the heliosphere at different times. For doing this, the magnetic connection in the interplanetary space is obtained by the classic Parker Heliospheric Magnetic Field (HMF). In close vicinity of the Sun, a Potential Field Source Surface (PFSS) model can be applied to connect the HMF to the solar photosphere. Solar-MACH is especially aimed at providing publication-ready figures for the analyses of Solar Energetic Particle events (SEPs) or solar transients such as Coronal Mass Ejections (CMEs). It is provided as an installable Python package (listed on PyPI and conda-forge), but also as a web tool at solar-mach.github.io that completely runs in any web browser and requires neither Python knowledge nor installation. The development of Solar-MACH is open to everyone and takes place on GitHub, where the source code is publicly available under the BSD 3-Clause License. Established Python libraries like sunpy and pfsspy are utilized to obtain functionalities when possible. In this article, the Python code of Solar-MACH is explained, and its functionality is demonstrated using real science examples. In addition, we introduce the overarching SERPENTINE project, the umbrella under which the recent development took place.
first_indexed 2024-04-10T06:57:04Z
format Article
id doaj.art-5a81a48cb2274e10a7994e84b039160e
institution Directory Open Access Journal
issn 2296-987X
language English
last_indexed 2024-04-10T06:57:04Z
publishDate 2023-02-01
publisher Frontiers Media S.A.
record_format Article
series Frontiers in Astronomy and Space Sciences
spelling doaj.art-5a81a48cb2274e10a7994e84b039160e2023-02-28T07:08:19ZengFrontiers Media S.A.Frontiers in Astronomy and Space Sciences2296-987X2023-02-01910.3389/fspas.2022.10588101058810Solar-MACH: An open-source tool to analyze solar magnetic connection configurationsJan Gieseler0Nina Dresing1Christian Palmroos2Johan L. Freiherr von Forstner3Johan L. Freiherr von Forstner4Daniel J. Price5Rami Vainio6Athanasios Kouloumvakos7Laura Rodríguez-García8Domenico Trotta9Vincent Génot10Arnaud Masson11Markus Roth12Astrid Veronig13Space Research Laboratory, Department of Physics and Astronomy, University of Turku, Turku, FinlandSpace Research Laboratory, Department of Physics and Astronomy, University of Turku, Turku, FinlandSpace Research Laboratory, Department of Physics and Astronomy, University of Turku, Turku, FinlandInstitute of Experimental and Applied Physics, Kiel University, Kiel, GermanyNow at Paradox Cat GmbH, München, GermanyDepartment of Physics, University of Helsinki, Helsinki, FinlandSpace Research Laboratory, Department of Physics and Astronomy, University of Turku, Turku, FinlandApplied Physics Laboratory, The Johns Hopkins University, Laurel, MD, United StatesSpace Research Group, Universidad de Alcalá, Alcalá de Henares, SpainThe Blackett Laboratory, Department of Physics, Imperial College London, London, United KingdomInstitut de Recherche en Astrophysique et Planétologie, CNRS, CNES, Université Paul Sabatier, Toulouse, FranceESAC Science Data Centre, European Space Agency, Madrid, Spain0Thüringer Landessternwarte, Tautenburg, Germany1Kanzelhöhe Observatory for Solar and Atmospheric Research, Institute of Physics, University of Graz, Graz, AustriaThe Solar MAgnetic Connection HAUS1 tool (Solar-MACH) is an open-source tool completely written in Python that derives and visualizes the spatial configuration and solar magnetic connection of different observers (i.e., spacecraft or planets) in the heliosphere at different times. For doing this, the magnetic connection in the interplanetary space is obtained by the classic Parker Heliospheric Magnetic Field (HMF). In close vicinity of the Sun, a Potential Field Source Surface (PFSS) model can be applied to connect the HMF to the solar photosphere. Solar-MACH is especially aimed at providing publication-ready figures for the analyses of Solar Energetic Particle events (SEPs) or solar transients such as Coronal Mass Ejections (CMEs). It is provided as an installable Python package (listed on PyPI and conda-forge), but also as a web tool at solar-mach.github.io that completely runs in any web browser and requires neither Python knowledge nor installation. The development of Solar-MACH is open to everyone and takes place on GitHub, where the source code is publicly available under the BSD 3-Clause License. Established Python libraries like sunpy and pfsspy are utilized to obtain functionalities when possible. In this article, the Python code of Solar-MACH is explained, and its functionality is demonstrated using real science examples. In addition, we introduce the overarching SERPENTINE project, the umbrella under which the recent development took place.https://www.frontiersin.org/articles/10.3389/fspas.2022.1058810/fullPython (programming language)software packagesolar energetic particle (SEP)coronacoronal mass ejection (CME)spacecraft
spellingShingle Jan Gieseler
Nina Dresing
Christian Palmroos
Johan L. Freiherr von Forstner
Johan L. Freiherr von Forstner
Daniel J. Price
Rami Vainio
Athanasios Kouloumvakos
Laura Rodríguez-García
Domenico Trotta
Vincent Génot
Arnaud Masson
Markus Roth
Astrid Veronig
Solar-MACH: An open-source tool to analyze solar magnetic connection configurations
Frontiers in Astronomy and Space Sciences
Python (programming language)
software package
solar energetic particle (SEP)
corona
coronal mass ejection (CME)
spacecraft
title Solar-MACH: An open-source tool to analyze solar magnetic connection configurations
title_full Solar-MACH: An open-source tool to analyze solar magnetic connection configurations
title_fullStr Solar-MACH: An open-source tool to analyze solar magnetic connection configurations
title_full_unstemmed Solar-MACH: An open-source tool to analyze solar magnetic connection configurations
title_short Solar-MACH: An open-source tool to analyze solar magnetic connection configurations
title_sort solar mach an open source tool to analyze solar magnetic connection configurations
topic Python (programming language)
software package
solar energetic particle (SEP)
corona
coronal mass ejection (CME)
spacecraft
url https://www.frontiersin.org/articles/10.3389/fspas.2022.1058810/full
work_keys_str_mv AT jangieseler solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations
AT ninadresing solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations
AT christianpalmroos solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations
AT johanlfreiherrvonforstner solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations
AT johanlfreiherrvonforstner solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations
AT danieljprice solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations
AT ramivainio solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations
AT athanasioskouloumvakos solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations
AT laurarodriguezgarcia solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations
AT domenicotrotta solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations
AT vincentgenot solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations
AT arnaudmasson solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations
AT markusroth solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations
AT astridveronig solarmachanopensourcetooltoanalyzesolarmagneticconnectionconfigurations