cavity_settings_factory module

Create CavitySettings from various contexts.

class CavitySettingsFactory(freq_bunch_mhz)

Bases: object

Base class to create CavitySettings objects.

Parameters:

freq_bunch_mhz (float)

__init__(freq_bunch_mhz)

Instantiate factory, with attributes common to all cavities.

Parameters:

freq_bunch_mhz (float)

Return type:

None

from_line_in_dat_file(line, set_sync_phase=False)

Create the cavity settings as read in the DAT file.

Parameters:

• line (DatLine)

• set_sync_phase (bool, default: False)

Return type:

CavitySettings

for_optimisation_algorithm(base_settings, amplitudes, phases, reference)

Create the cavity settings to try during an optimization.

Parameters:

• base_settings (Sequence[CavitySettings]) – Nominal cavity settings, serving as a “base” for creating the new CavitySettings.

• amplitudes (Sequence[float]) – (n,) array of field amplitudes.

• phases (Sequence[float]) – (n,) array of field phases.

• reference (Literal['phi_0_abs', 'phi_0_rel', 'phi_s']) – Nature of the phase to use as reference for the optimization.

Return type:

list[CavitySettings]

_reference(absolute_phase_flag, set_sync_phase)

Determine which phase will be the reference one.

Parameters:

• absolute_phase_flag (bool)

• set_sync_phase (bool)

Return type:

Literal['phi_0_abs', 'phi_0_rel', 'phi_s']