Input/output helpers

Bunch initialization helpers for the core Liénard–Wiechert integrator.

class input_output.bunch_initialization.BunchRequest(kinetic_energy_mev: float, mass_amu: float, charge_sign: float, position_z: float = 0.0, particle_count: int = 1, transverse_radius: float = 0.0, transverse_momentum: float = 0.0)[source]

Bases: object

Input parameters for create_bunch_from_energy().

kinetic_energy_mev: float

mass_amu: float

charge_sign: float

position_z: float = 0.0

particle_count: int = 1

transverse_radius: float = 0.0

transverse_momentum: float = 0.0

__init__(kinetic_energy_mev: float, mass_amu: float, charge_sign: float, position_z: float = 0.0, particle_count: int = 1, transverse_radius: float = 0.0, transverse_momentum: float = 0.0) → None

input_output.bunch_initialization.create_bunch_from_energy(*, kinetic_energy_mev: float, mass_amu: float, charge_sign: float, position_z: float = 0.0, particle_count: int = 1, transverse_radius: float = 0.0, transverse_momentum: float = 0.0) → Tuple[Dict[str, ndarray], float][source]

Generate a particle state dictionary from kinetic energy inputs.

Returns a dictionary matching the core integrator expectations plus the total rest energy in MeV (for compatibility with legacy helpers).