pyvisual Documentation

pyvisual is developed and maintained by Predictive Science Inc. (PSI) and provides an interactive 3D visualization layer for solar and magnetohydrodynamic (MHD) model output defined on spherical coordinate systems. It wraps pyvista.Plotter with spherical-coordinate awareness, observer controls, and rendering utilities tuned to the PSI data ecosystem (psi-io and mapflpy).

The primary entry point is Plot3d, which exposes methods for adding solar geometry primitives, rendering structured-grid slices and isosurface contours, plotting point clouds and splines, and tracing magnetic fieldlines — all from spherical \((r, \theta, \phi)\) coordinate arrays. Because pyvisual renders through PyVista and VTK, it is strongly recommended to familiarise yourself with the PyVista documentation to get the most out of the package.