PyPLUTO: a data analysis Python package for the PLUTO code

TL;DR

PyPLUTO is a Python package designed for efficient data loading, manipulation, and visualization of outputs from the PLUTO astrophysical simulation code, including support for particle modules and a user-friendly GUI.

Contribution

This paper introduces PyPLUTO, a versatile Python toolkit that simplifies analysis and visualization of PLUTO simulation data, including particle modules, with optimized data handling and an intuitive GUI.

Findings

Efficient data loading via memory mapping improves performance.

Supports visualization of particles like cosmic rays and dust.

Includes a user-friendly GUI for figure generation.

Abstract

In recent years, numerical simulations have become indispensable for addressing complex astrophysical problems. The MagnetoHydroDynamics (MHD) framework represents a key tool for investigating the dynamical evolution of astrophysical plasmas, which are described as a set of partial differential equations that enforce the conservation of mass, momentum, and energy, along with Maxwell's equations for the evolution of the electromagnetic fields. Due to the high nonlinearity of the MHD equations (regardless of their specifications, e.g., classical/relativistic or ideal/resistive), a general analytical solution is precluded, making the numerical approach crucial. Numerical simulations usually end up producing large sets of data files, and their scientific analysis leans on dedicated software designed for data visualization. However, in order to encompass all of the code output features, specialized tools focusing on the numerical code may represent a more versatile and built-in tool. Here, we present PyPLUTO, a Python package tailored for efficient loading, manipulation, and visualization of outputs produced with the PLUTO code (Mignone et al., 2007; Mignone et al., 2012). PyPLUTO uses memory mapping to optimize data loading and provides general routines for data manipulation and visualization. PyPLUTO also supports the particle modules of the PLUTO code, enabling users to load and visualize particles, such as cosmic rays (Mignone et al., 2018), Lagrangian (Vaidya et al., 2018), or dust (Mignone et al., 2019) particles, from hybrid simulations. A dedicated Graphical User Interface simplifies the generation of single-subplot figures, making PyPLUTO a powerful yet user-friendly toolkit for astrophysical data analysis.