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

Abstract

The Solar MAgnetic Connection HAUS 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.

14 pages, 5 figures

References in corpus (8)

• The Astropy Project: Sustaining and Growing a Community-oriented Open-source Project and the Latest Major Release (v5.0) of the Core Package
• The Solar Orbiter mission -- Science overview
• The First Ground Level Enhancement of Solar Cycle 25 on 28 October 2021
• Single-spacecraft techniques for shock parameters estimation: A systematic approach
• Solar differential rotation in the period 1964 - 2016 determined by the Kanzelhöhe data set
• The unusual widespread solar energetic particle event on 2013 August 19. Solar origin and particle longitudinal distribution
• Solar energetic electron events measured by MESSENGER and Solar Orbiter. Peak intensity and energy spectrum radial dependences: statistical analysis
• Solar Energetic Particle Time Series Analysis with Python

Cited by in corpus (32)

• The 17 April 2021 widespread solar energetic particle event
• Multiple injections of energetic electrons associated with the flare/CME event on 9 October 2021
• Solar Energetic Particle Time Series Analysis with Python
• On the three-dimensional relation between the coronal dimming, erupting filament and CME. Case study of the 28 October 2021 X1.0 event
• The multi-spacecraft high-energy solar particle event of 28 October 2021
• The solar cycle 25 multi-spacecraft solar energetic particle event catalog of the SERPENTINE project
• Solar energetic particles injected inside and outside a magnetic cloud: The widespread solar energetic particle event on 2022 January 20
• Localizing short-period pulsations in hard X-rays and Gamma-rays during an X9.0 flare
• Physics-Based Simulation of the 2013 April 11 Solar Energetic Particle Event
• Deciphering Faint Gyrosynchrotron Emission from Coronal Mass Ejection using Spectro-polarimetric Radio Imaging
• Modeling CME encounters at Parker Solar Probe with OSPREI: Dependence on photospheric and coronal conditions
• Evidence of Time-Dependent Diffusive Shock Acceleration in the 2022 September 5 Solar Energetic Particle Event
• Radial Evolution of ICME-Associated Particle Acceleration Observed by Solar Orbiter and ACE
• Three-part structure of solar coronal mass ejection observed in low coronal signatures of Solar Orbiter
• Radial dependence of ion fluences in the 2023 July 17 SEP event from Parker Solar Probe to STEREO and ACE
• The evolution of coronal shock wave properties and their relation with solar energetic particles
• Determining the acceleration regions of in situ electrons using remote radio and X-ray observations
• Imaging and spectropolarimetric observations of a band-split type II solar radio burst with LOFAR
• Comparing observations of the closely located JUICE and STEREO-A spacecraft during the widespread solar energetic particle event of 2024 May 13
• Freely propagating flanks of wide coronal-mass-ejection-driven shocks: Modelling and observational insights
• Coronal Diagnostics of Solar Type-III Radio Bursts Using LOFAR and PSP Observations
• Multi-spacecraft observations of the decay phase of solar energetic particle events
• Multi spacecraft study with the Icarus model: Modelling the propagation of CMEs to Mercury and Earth
• Energy-dependent SEP Fe/O abundances during the May 2024 superstorm
• A multi-viewpoint comparison of the velocity field of coronal propagating disturbances
• Multi-spacecraft constraints on relativistic solar energetic particle transport in the widespread 28 October 2021 event
• High-Frequency Magnetohydrodynamic Waves with Substantial Energy in the Solar Polar Corona
• A view of the evolution of a CME and the associated wave-trains at high spatial and temporal resolution
• In-flight calibration of RADEM, the JUICE mission radiation monitor
• Parker Solar Probe observations of solar energetic particle (SEP) events with inverse velocity arrival (IVA) features
• Separating the effects of earthside and far side solar events. A case study
• Solar Electron Beam -- Langmuir Wave Interactions and How They Modify Solar Electron Beam Spectra: Solar Orbiter Observations of a Match Made in the Heliosphere