PION: simulations of nebulae around stars

PION is a grid-based fluid dynamics code for hydrodynamics and magnetohydrodynamics, including a ray-tracing module for calculating the attenuation of radiation from point sources of ionizing photons. It also has a module for coupling fluid dynamics and the radiation field to microphysical processes such as heating/cooling and ionization/recombination. The algorithms are described in Mackey et al. (2021), Mackey (2012), Mackey & Lim (2011), and Mackey & Lim (2010).

PION was written to model the evolution of HII regions, photoionized bubbles that form around hot stars, and developed to include stellar wind sources so that both wind bubbles and photoionized bubbles can be simulated at the same time. It is versatile enough to be extended to other applications.

The current version of PION is 2.0.0, available at the release page.

There are two versions of PION, the released version and development version. Only the released version is freely available. If you want to work with the development version you need to request access.

• Documentation for the released version, 2.0.0: https://pion.ie/docs/.
• Documentation for the development version: https://pion.ie/docs/dev/.

This documentation is for the development version.

Guide

• 1. Getting Started
  • 1.1. Introduction to PION
  • 1.2. Getting the PION source code
    • 1.2.1. Public release of PION
    • 1.2.2. Development version of PION
  • 1.3. Getting help
  • 1.4. System Requirements for compiling and running PION
  • 1.5. Compiling PION
    • 1.5.1. Debian 11 (Bullseye) and Ubuntu 21
    • 1.5.2. Debian 10 (Buster)
    • 1.5.3. Ubuntu 20
    • 1.5.4. OS X
    • 1.5.5. Debian 9
    • 1.5.6. Ubuntu 18
    • 1.5.7. Windows10
  • 1.6. Compilation scripts and resulting executables
  • 1.7. Trouble Compiling or Running PION?
    • 1.7.1. MPI Error
    • 1.7.2. SUNDIALS Error
    • 1.7.3. Runtime Error: silo
    • 1.7.4. Getting Help
• 2. Running an example simulation
  • 2.1. Preparation
  • 2.2. 2D simulation of a bow shock around a moving star
  • 2.3. Looking at the results
• 3. Another Example: colliding winds (2D)
  • 3.1. Introduction
  • 3.2. Running the simulation
• 4. Using Python to plot simulation
  • 4.1. Installing PyPion
    • 4.1.1. Using the PyPion docker image
    • 4.1.2. Using the system python3 on Debian/Ubuntu
    • 4.1.3. Using the system python3 on OS X
  • 4.2. Using PyPion to look at simulation data
  • 4.3. Known issues with Python
• 5. Description of the parameters in PION parameter files
  • 5.1. Initial Conditions Generator
  • 5.2. General Parameters
    • 5.2.1. Integration Scheme
    • 5.2.2. Computational Grid
    • 5.2.3. Boundary Conditions
    • 5.2.4. Units
  • 5.3. Source terms
    • 5.3.1. Radiation sources
    • 5.3.2. Stellar Winds
    • 5.3.3. Jet inflow
  • 5.4. Types of initial conditions that have been programmed
    • 5.4.1. Uniform
    • 5.4.2. ShockCloud
    • 5.4.3. RadiativeShock
    • 5.4.4. PhotEvap_RandomClumps
    • 5.4.5. PhotoEvaporatingClump
    • 5.4.6. PE_MC_FN or PE_MC_FM
    • 5.4.7. BlastWave
    • 5.4.8. Advection
    • 5.4.9. DoubleMachRef
    • 5.4.10. OrszagTang
    • 5.4.11. LiskaWendroffImplosion
    • 5.4.12. KelvinHelmholtz
    • 5.4.13. FieldLoop
    • 5.4.14. DivBPeak
    • 5.4.15. Others
• 6. Reference Guide for PION modules
  • 6.1. Microphysics modules for PION
    • 6.1.1. Production Modules
    • 6.1.2. Legacy Modules
  • 6.2. Boundary Conditions
    • 6.2.1. General-purpose boundary conditions
    • 6.2.2. Special-purpose boundaries
• 7. Developers Guide for PION
  • 7.1. Coding style and guides
    • 7.1.1. Developing a new feature
    • 7.1.2. Coding conventions
    • 7.1.3. Generating documentation from source code
  • 7.2. Computational Grid
    • 7.2.1. Grid Geometry
    • 7.2.2. Mesh refinement
    • 7.2.3. Serial and Parallel grid setup
    • 7.2.4. Location of source files
  • 7.3. Control Flow
    • 7.3.1. Outer loop
    • 7.3.2. 2nd-order timestep for nested-grid, parallel run
  • 7.4. Parallel communication
    • 7.4.1. Domain decomposition
    • 7.4.2. Calculating timestep
    • 7.4.3. Exchange of boundary data on sub-domains
    • 7.4.4. Exchange of data between levels of the nested grid
    • 7.4.5. Parallel input/output (read from/write to disk)
• 8. PION license
• 9. PION README
  • 9.1. Information
  • 9.2. Developers
  • 9.3. Licence

Indices and tables

• Index
• Module Index
• Search Page