Module description
The main configuration file (described here), after calling the build_sequence.madx and the optics.madx files, executes the following modules:
module_01_orbit.madx
- Defines the MAD-X beams
- Performs a twiss for the sequences as loaded by the build_machine script (user-defined knobs are not applied)
- Applies the user-defined orbit knobs (crossing, separations, experimental magnets)1 and twiss again
- Save the crossing configuration (saves states of IP knobs and dispersion correction knob, using
crossing_savemacro from the toolkit). - Performs a twiss with flat orbit by running the
crossing_disablemacro from the toolkit (no crossings nor separation) - Performs a twiss with the user-defined orbit (using the
crossing_restoremacro) - NB: Octupoles, tunes and chromaticity are taken from the
build_machine. Those defined by the user are introduced later bymodule_05_tuning.
This module is divided in the following files (sub-modules):
- submodule_01a_preparation.madx
- submodule_01b_beam.madx
- submodule_01c_phase.madx
- submodule_01d_crossing.madx
- submodule_01e_final.madx
module_02_lumilevel.madx
- Separates IP8 (in the horizontal plane) to achieve the target luminosity.
- Run the final crossing save (overwrites states of IP knobs, using
crossing_savemacro).
module_03_beambeam.madx
- Forces
on_disp=0 - Configures and installs the beam-beam lenses
- Generates
bb_lenses.dat(to be replaced in the sixtrack input generated by mad) - Installs the the crab cavities (if enabled)
- NB: the beam-beam kicks are left disabled (can be enabled by setting
on_bb_charge = 1) - NB:
module_03_beambeamrequires thatmodule_02_lumilevelis run before.
module_04_errors.madx
- Loads the error tables
- Introduces misalignments
- Introduces corrections
Warning
After this stage the USE command cannot be called anymore (it would wipe out the errors), we will work always with the same sequence.
This module is divided in the following files (sub-modules):
- submodule_04_1a_install_crabs.madx
- submodule_04_1b_save_references.madx
- submodule_04a_preparation.madx
- submodule_04a_s1_prepare_nom_twiss_table.madx
- submodule_04b_alignsep.madx
- submodule_04c_errortables.madx
- submodule_04d_efcomp.madx
- submodule_04e_correction.madx
- submodule_04e_s1_synthesize_knobs.madx
- submodule_04f_final.madx
module_05_tuning.madx
- Restores the crossing knobs as saved by
module_01_orbitormodule_02_lumilevel(usingcrossing_save) - Power the octupoles as defined by the user
- Matches tunes and chromaticity 2
- Corrects the linear coupling
- Clips corrector strengths to maximum allowed
- Switches on the beam-beam lenses (
on_bb_charge = 1) - Introduces RF voltage and lags.
This module is divided in the following files (sub-modules):
- submodule_05a_MO.madx
- submodule_05b_coupling.madx
- submodule_05c_limit.madx
- submodule_05d_matching.madx
- submodule_05e_corrvalue.madx
- submodule_05f_final.madx
module_06_generate.madx
- Produces sixtrack input (call sixtrack command of madx)
- If BB enabled, inserts beam-beam lenses from
bb_lenses.datintofc.3 - Performs a twiss on the last machine configuration.
This module is divided in the following files (sub-modules):
Warning
The order of the modules has to be respected but some of the modules (e.g., module_03_beambeam or module_04_errors) can be commented out (it depends on the user's need).