How computationalradiationphysics/picongpu works
PIConGPU is a relativistic particle-in-cell plasma simulator. Users provide configuration and run a simulation: the executable parses arguments, then hands control to the simulation lifecycle; initialization configures fields and particle species, and the PIC cycle advances particles and electromagnetic fields. The README also documents coupled atomic physics, radiation diagnostics, openPMD output/restarts, live diagnostics, and extensible plugins. Several implementation paths are represented by their existing enclosing directories because their specific files were not sampled; those connections are documented or marked unverified accordingly.
Main entry points: MoveParticle.hpp Particle motion · InitialiserController.hpp Simulation initialization · main.x.cpp Executable entry · EMFieldBase.hpp Electromagnetic fields
Components 20
Run and setup
- Executable entry
include/picongpu/main.x.cpp - Argument parser
include/picongpu/ArgsParser.cpp - Simulation initialization
include/picongpu/initialization/InitialiserController.hpp - Particle profiles
include/picongpu/particles/densityProfiles - PICMI interface
lib/python/picongpu/picmi/simulation.py
PIC physics
- Electromagnetic fields
include/picongpu/fields/EMFieldBase.hpp - Maxwell solvers
include/picongpu/fields/MaxwellSolver/Solvers.hpp - Incident fields
include/picongpu/fields/incidentField/profiles/profiles.hpp - Particle motion
include/picongpu/particles/MoveParticle.hpp - Current deposition
include/picongpu/fields/currentDeposition/Deposit.hpp - Particle boundaries
include/picongpu/particles/boundary/Apply.hpp
Physics extensions
- Atomic physics
include/picongpu/particles/atomicPhysics - Particle collisions
include/picongpu/particles/collision - Radiation reaction
include/picongpu/particles
Runtime and diagnostics
- Plugin controller
include/picongpu/plugins/PluginController.hpp - Online diagnostics
include/picongpu/plugins - openPMD I/O
include/picongpu/plugins - PMacc runtime
include/pmacc/eventSystem/Manager.hpp
Other components
- Simulation user
- openPMD services
Connections 21
- Simulation user → Executable entry: runs
- Executable entry → Argument parser: parses arguments
include/picongpu/main.x.cpp - Executable entry → Simulation initialization: starts simulation
- Simulation initialization → Electromagnetic fields: configures
include/picongpu/initialization/InitialiserController.hpp - Simulation initialization → Maxwell solvers: checks solver
include/picongpu/initialization/InitialiserController.hpp - Simulation initialization → Incident fields: configures profiles
include/picongpu/initialization/InitialiserController.hpp - Simulation initialization → Particle profiles: initializes species
- Particle motion → Electromagnetic fields: interpolates fields
- Particle motion → Current deposition: deposits current
- Maxwell solvers → Electromagnetic fields: updates fields
- Incident fields → Electromagnetic fields: adds incident fields
- Particle boundaries → Particle motion: affects particle motion
- Atomic physics → Electromagnetic fields: couples field ionization
- Particle collisions → Particle motion: alters particle motion
- Radiation reaction → Particle motion: couples radiation reaction
- Plugin controller → Online diagnostics: hosts plugins
include/picongpu/plugins/PluginController.hpp - Plugin controller → openPMD I/O: hosts plugins
include/picongpu/plugins/PluginController.hpp - Online diagnostics → Particle motion: observes particles
- openPMD I/O → openPMD services: writes and restarts
- Executable entry → PMacc runtime: finalizes runtime
include/picongpu/main.x.cpp - PICMI interface → Executable entry: configures runs