Skip to content
giadarol edited this page Mar 7, 2019 · 68 revisions

PyECLOUD is a 2D macro-particle code for the simulation of electron cloud effects in particle accelerators. It can be used for different purposes:

  • in stand-alone mode for the simulation of the e-cloud buildup at a certain section of an accelerator (in this case the beam is rigid and feels no effect from the cloud);
  • in combination with the PyHEADTAIL code for the simulation of the e-cloud effects on the beam dynamics;
  • in combination with the PyHEADTAIL code for the simulation of the fast beam-ion instability. More information on this mode is available here.

An overview on PyECLOUD's history and main features can be found here.

PyECLOUD relies on the PyPIC library (created as an external library from the Partice-In-Cell code previously included in PyECLOUD) for the computation of the fields generated by the beam and by the cloud.

To get started using PyECLOUD, you can install the code following the instructions in the page:

The input and output of the simulation are described in the:

Documents describing the physical models and algorithms implemented in PyECLOUD are collected in the page:

A checkpointing feature can be used for recovery of aborted simulations. Details about this mode can be found here.

A simple example of buildup simulation and some instructions can be found at:

An example on how to run a coupled-bunch instability simulation can be found at