pipic 1.3

A Python library for particle-in-cell plasma simulation.

---

$\pi$-PIC (PIPIC, Python-controlled Interactive PIC) is an open-source collection of relativistic particle-in-cell solvers featuring

• exact energy conservation;
• absence of numerical dispersion.

The solvers provide a way to either suppress or eliminate numerical artefacts (instabilities, heating, numerical Cherenkov radiation, etc.) permitting larger space and time steps, as well as lower number of particles per cell. Because of reduced computational demands, the solvers can be found useful for quick tests of ideas, as well as for scanning parameter spaces. For a description of the underlying methods see Reference, the documentation or a presentation at PIF24.

---

Overview

$\pi$-PIC provides all tools necessary for designing 1D/2D/3D simulations and arbitrary outputs directly from Python. In addition, it has interfaces for incorporating extensions (read/modify field and particles, add/remove particles) that can be developed in Python, C/C++, Fortran or any other language that generate callable functions (see extensions for a list of extensions included in $\pi$-PIC installation). The project and its development are hosted on GitHub.

To get started, it should for most cases be sufficient to install $\pi$-PIC via pip (this requires: gcc, openmp and fftw3; for details and information on compilation via CMake see installation instructions):

pip install pipic

The basic layout of a simulation includes five elements:

• creating a container with cells with given parameters
• adding particles of all necessary types
• setting initial electromagnetic field
• defining output (via loops over particles and grid values of field)
• advance and read the state of the defined physical system

We demonstrate the use of these elements in the tutorial. A complete list of all implemented Python interfaces functions can be found here. The development of extensions is detailed here and exemplified here.

The implementation of new solvers is exemplified here.

New in $\pi$-PIC v1.3

The following updates has been made for $\pi$-PIC v.3. For more details see Ref.[2].

• extension for moving window simulations.
• extension for absorbing boundaries.
• Improved structure for handeling fields and particles in C++ extensions.
• An energy conserving solver with improved momentum conservation emc.

New in $\pi$-PIC v1.2

• options for energy correction routine in ec and ec2 (see docs/guides/INTERFACES.md)
• extension for initializing arbitrary tightly focused pulses, e.g. dipole waves (focused_pulse)

New in $\pi$-PIC v1.1

• extensions for QED-PIC simulations (qed_volokitin2023, qed_gonoskov2015)
• extension for ensemble down-sampling (downsampler_gonoskov2022)

See all releases here.

Reference

[1] A. Gonoskov, Explicit energy-conserving modification of relativistic PIC method, J. Comput. Phys., 502, 112820; arXiv:2302.01893 (2024).
[2] F. Brogren, $\pi$-PIC: a framework for modular particle-in-cell developments and simulations, arXiv:2511.09950 (2025).