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

TL;DR

Solar-MACH is an open-source Python tool that visualizes solar magnetic connections for different observers, aiding the analysis of solar energetic events with publication-ready figures and accessible web interface.

Contribution

It introduces a comprehensive, open-source Python package and web tool for analyzing and visualizing solar magnetic connection configurations, integrating established models and libraries.

Findings

Provides visualization of magnetic connection configurations

Enables analysis of Solar Energetic Particle events and CMEs

Accessible via Python package and web interface

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.