Examples

This section demonstrates use cases and benchmarks of ImpactX, each correspond to various physical situations and/or test different code features. Each example provides detailed input scripts that can be used as templates for your research projects.

Single Particle Dynamics

• FODO Cell
• FODO Cell Using Envelope Tracking
• FODO Cell Using Nonlinear Tracking
• Chicane
• Quadrupole with Alignment Errors
• Drift using a Pole-Face Rotation
• Simple rotation in the x-y plane
• Acceleration by RF Cavities
• FODO Cell with RF
• FODO Cell, Chromatic
• Chain of thin multipoles
• Solenoid channel
• Soft-edge solenoid
• Soft-Edge Quadrupole
• Combined Function Bend
• Ballistic Compression Using a Short RF Element
• Test of a Transverse Kicker
• Thin Dipole
• Aperture Collimation
• Aperture Collimation with Periodic Masking
• Collimation Using an Absorber
• Aperture Collimation for a Thick Element
• A nonlinear focusing channel based on the IOTA nonlinear lens
• A nonlinear focusing channel based on the physical IOTA nonlinear magnet
• A nonlinear focusing channel based on the physical IOTA nonlinear magnet with aperture
• Achromatic Spectrometer
• User-Defined Linear Element
• FODO Cell, Programmable Element
• Dogleg
• Coupled Optics
• Iteration of a User-Defined Linear Map
• Expanding Beam Scraping Against a Vacuum Pipe
• Bending Dipole with Zero Field Strength
• Testing Charge and Field Sign Consistency
• Symplectic Integration in an Exact Quadrupole
• FODO Channel with Quads Treated as Exact Multipoles
• Symplectic Integration in a Long Sextupole

Collective Effects

Space Charge

• Expanding Beam in Free Space
• Constant Focusing Channel
• Constant Focusing Channel with Space Charge
• Kurth Distribution in a Periodic Focusing Channel
• Kurth Distribution in a Periodic Focusing Channel with Space Charge
• Cold Beam in a FODO Channel with RF Cavities (and Space Charge)
• Thermal Beam in a Constant Focusing Channel (with Space Charge)
• Bithermal Beam in a Constant Focusing Channel (with Space Charge)
• FODO Cell with 2D Space Charge using Envelope Tracking

Coherent Synchrotron Radiation (CSR)

• Chicane with CSR

Quantum Excitation

Incoherent Synchrotron Radiation (ISR)

• A Single Bend with ISR
• Chicane with ISR

Beam Distributions

• Initialize a Beam from Arrays

• Generation of beam distributions
  • A 6d Gaussian distribution from Twiss functions
  • A K-V distribution initialized from Twiss functions
  • A 4D Kurth Distribution
  • A Semigaussian distribution

Channels & Rings

• FODO Channel
• Solenoid channel (Restart)

Lattice Design & Optimization

• Tune Calculation in a Periodic FODO Channel
• Optimized Triplet

Virtual Test Stands

• Cyclotron
• Cyclotron with Dynamical Losses
• The “bare” linear lattice of the Fermilab IOTA storage ring
• The full nonlinear lattice of the Fermilab IOTA storage ring
• The linear lattice of the Fermilab IOTA storage ring using envelope tracking
• Positron Channel
• 15 Stage Laser-Plasma Accelerator Surrogate
• Apochromatic Drift-Quadrupole Beamline
• Apochromatic Drift-Plasma Lens Beamline
• Tune Calculation in a Periodic FODO Channel
• PIP-II Linac Segment

Unit tests

• Transformation

For every change of the ImpactX code base, each of these examples and tests are continuously tested and benchmarked.