Chambre

class zgoubidoo.commands.commands.Chambre(label1: str = '', label2: str = '', *params, **kwargs)[source]

Bases: zgoubidoo.commands.commands.Command

Long transverse aperture limitation.

Zgoubi manual description

CHAMBR causes the identification, counting and stopping of particles that reach the transverse limits of the vacuum chamber. The chamber can be either rectangular (IFORM = 1) or elliptic (IFORM = 2). The chamber is centered at YC, ZC and has transverse dimensions ±Y L and ±ZL such that any particle will be stopped if its coordinates Y, Z satisfy.

The conditions introduced with CHAMBR are valid along the optical structure until the next occurrence of the keyword CHAMBR. Then, if IL = 1 the aperture is possibly modified by introducing new values of YC, ZC, Y L and ZL, or, if IL = 2 the chamber ends and information is printed concerning those particles that have been stopped.

The testing is done in optical elements at each integration step, between the EFB’s. For instance, in QUADRUPO there will be no testing from −XE to 0 and from XL to XL + XS, but only from 0 to XL ; in DIPOLE, there is no testing as long as the ENTRANCE EFB is not reached, and testing is stopped as soon as the EXIT or LATERAL EFB’s are passed.

In optical elements defined in polar coordinates, Y stands for the radial coordinate (e.g., DIPOLE, see Figs. 3C, p. 27, and 11, p. 82). Thus, centering CHAMBR at Y C = RM simulates a chamber curved with radius RM, and having a radial acceptance RM ± YL. In DRIFT, the testing is done at the beginning and at the end, and only for positive drifts. There is no testing in CHANGREF.

When a particle is stopped, its index IEX (see OBJET and section 4.6.10) is set to the value -4, and its actual path length is stored in the array SORT for possible further use.

Command attributes

LABEL1=''

Primary label for the Zgoubi command (default: auto-generated hash).

Type

str

LABEL2=''

Secondary label for the Zgoubi command.

Type

str

IA='0'

0 (element inactive), 1 ((re)definition of the aperture), 2 (stop testing and reset counters,print information on stopped particles

Type

int

IFORM='1'

1 (rectangular aperture), 2 (elliptical aperture)

Type

int

J='0'

0 (default) or 1

Type

int

C1='100 centimeter'

If J=0, Y opening, if J=1, inner Y opening

Type

Quantity

C2='100 centimeter'

If J=0, Z opening, if J=1, outer Y opening

Type

Quantity

C3='0 centimeter'

If J=0, Y center, if J=1, inner Z opening

Type

Quantity

C4='0 centimeter'

If J=0, Z center, if J=1, outer Z opening

Type

Quantity

Default initializer for all Commands.

Attributes Summary

KEYWORD

Keyword of the command used for the Zgoubi input data.

PARAMETERS

Parameters of the command, with their default value, their description and optinally an index used by other commands (e.g.

Attributes Documentation

KEYWORD: str = 'CHAMBR'

Keyword of the command used for the Zgoubi input data.

PARAMETERS: dict = {'C1': (<Quantity(100, 'centimeter')>, 'If J=0, Y opening, if J=1, inner Y opening'), 'C2': (<Quantity(100, 'centimeter')>, 'If J=0, Z opening, if J=1, outer Y opening'), 'C3': (<Quantity(0, 'centimeter')>, 'If J=0, Y center, if J=1, inner Z opening'), 'C4': (<Quantity(0, 'centimeter')>, 'If J=0, Z center, if J=1, outer Z opening'), 'IA': (0, '0 (element inactive), 1 ((re)definition of the aperture), 2 (stop testing and reset counters,print information on stopped particles'), 'IFORM': (1, '1 (rectangular aperture), 2 (elliptical aperture)'), 'J': (0, '0 (default) or 1'), 'LABEL1': ('', 'Primary label for the Zgoubi command (default: auto-generated hash).'), 'LABEL2': ('', 'Secondary label for the Zgoubi command.')}

Parameters of the command, with their default value, their description and optinally an index used by other commands (e.g. fit).