diagnostic module

Define Diagnostic.

As for now, diagnostics are not used by LightWin. However, LightWin can add diagnostics (as well as ADJUST) to the final DAT in order to perform a “pass beauty”.

Note

Functionalities still under implementation. In particular, the number of attributes were not checked.

Note

This is TraceWin’s equivalent of Objective.

class Diagnostic(line, dat_idx=None, **kwargs)[source]

Bases: Element

A dummy object.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

base_name = 'D'

increment_lattice_idx = False

is_implemented: bool = False

__init__(line, dat_idx=None, **kwargs)[source]

Force an element with null-length, with no index.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

Return type:

None

_abc_impl = <_abc._abc_data object at 0x7c8f67921380>

class DiagCurrent(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure current.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67921500>

class DiagDCurrent(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure delta current.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67921580>

class DiagPosition(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure position.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

is_implemented: bool = True

n_attributes: int | range | Collection = 4

_abc_impl = <_abc._abc_data object at 0x7c8f67921640>

class DiagDPosition(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure delta position.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67921700>

class DiagDivergence(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure divergences.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67921940>

class DiagDDivergence(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure delta divergences.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67921a00>

class DiagSizeFWHM(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure full width at half maximum.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67921ac0>

class DiagSize(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure sizes.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67921b80>

class DiagSizeP(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure divergences.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67921c40>

class DiagDSizeFWHM(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure delta full width at half maximum.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67921cc0>

class DiagDSize(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure delta size.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67921d80>

class DiagDSize2FWHM(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure delta full width at half maximum between two positions.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67921e40>

class DiagDSize2(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure delta size between two positions.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

is_implemented: bool = True

n_attributes: int | range | Collection = (3, 4)

__init__(line, dat_idx=None, **kwargs)[source]

Force an element with null-length, with no index.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

Return type:

None

_abc_impl = <_abc._abc_data object at 0x7c8f67921f00>

class DiagDSize3(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure delta phase spread between two positions.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

is_implemented: bool = True

n_attributes: int | range | Collection = (3, 4)

__init__(line, dat_idx=None, **kwargs)[source]

Force an element with null-length, with no index.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

Return type:

None

classmethod _args_to_line(number, rms_delta_phase_spread=0.0, accuracy=0.0, low_pass_filter_frequency=None)[source]

Convert list of arguments to corresponding line of dat file.

Parameters:

number (int)
rms_delta_phase_spread (float, default: 0.0)
accuracy (float, default: 0.0)
low_pass_filter_frequency (float | None, default: None)

Return type:

str

_abc_impl = <_abc._abc_data object at 0x7c8f67922100>

class DiagDSize4(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure something?

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67922180>

class DiagDPSize2(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure delta divergence between two positions.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67922200>

class DiagPhase(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure phase.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 2

_abc_impl = <_abc._abc_data object at 0x7c8f67922280>

class DiagEnergy(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure energy.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 3

_abc_impl = <_abc._abc_data object at 0x7c8f67922300>

class DiagDEnergy(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure difference between beam energy and perfect linac energy.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 3

_abc_impl = <_abc._abc_data object at 0x7c8f67922380>

class DiagDPhase(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure difference between beam phase and perfect linac phase.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 2

_abc_impl = <_abc._abc_data object at 0x7c8f67922440>

class DiagLuminosity(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure luminosity.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 3

_abc_impl = <_abc._abc_data object at 0x7c8f679224c0>

class DiagWaist(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure waist setting.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 4

_abc_impl = <_abc._abc_data object at 0x7c8f67922540>

class DiagAchromat(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure achromat setting.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 5

_abc_impl = <_abc._abc_data object at 0x7c8f679225c0>

class DiagEmit(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure RMS emittance setting.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 4

_abc_impl = <_abc._abc_data object at 0x7c8f67922640>

class DiagEmit99(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure 99% emittance setting.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 4

_abc_impl = <_abc._abc_data object at 0x7c8f679226c0>

class DiagHalo(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure halo setting.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 4

_abc_impl = <_abc._abc_data object at 0x7c8f67922740>

class DiagSetMatrix(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure transfer matrix setting.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 6

_abc_impl = <_abc._abc_data object at 0x7c8f679227c0>

class DiagTwiss(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure beam Twiss parameters settings.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 7

_abc_impl = <_abc._abc_data object at 0x7c8f67922840>

class DiagDTwiss(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Make equal two beam Twiss parameters between two positions or more.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 7

_abc_impl = <_abc._abc_data object at 0x7c8f679228c0>

class DiagDTwiss2(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Make equal transverse Twiss parameters at diagnostic position.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 3

_abc_impl = <_abc._abc_data object at 0x7c8f67922980>

class DiagSeparation(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure beam separation setting.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 6

_abc_impl = <_abc._abc_data object at 0x7c8f67922a00>

class DiagSizeMax(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Limit beam size max.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 6

_abc_impl = <_abc._abc_data object at 0x7c8f67922a80>

class DiagSizeMin(line, dat_idx=None, **kwargs)[source]

Bases: DiagSizeMax

Limit beam size min.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67922b40>

class DiagPhaseAdv(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure beam phase advance.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 4

_abc_impl = <_abc._abc_data object at 0x7c8f67922bc0>

class DiagBeta(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure beam beta.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

n_attributes: int | range | Collection = 6

_abc_impl = <_abc._abc_data object at 0x7c8f67922c40>

class DiagDBeta(line, dat_idx=None, **kwargs)[source]

Bases: Diagnostic

Measure delta beam beta.

Parameters:

line (DatLine)
dat_idx (int | None, default: None)
kwargs (str)

_abc_impl = <_abc._abc_data object at 0x7c8f67922cc0>

n_attributes: int | range | Collection = 4