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 of the command used for the Zgoubi input data.
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).
-