insert_sceffects

• type: setup command.
• function: set up for transverse space charge calculation. N.B.: This feature is not designed for space charge calculations in guns or linacs. It is only intended for simulating space charge in rings.

&insert_sceffects
        STRING name = NULL;
        STRING type = NULL;
        STRING exclude = NULL;
        long disable = 0;
        long clear = 0;
        STRING element_prefix = "MYSC";
        long skip = 0;
        long vertical = 0;
        long horizontal = 0;
        long nonlinear = 0;
&end

• name -- Possibily wild-card containing string specifying the name of the elements after which to insert the space charge kick element.
• type -- Possibily wild-card containing string specifying the type of the elements after which to insert the space charge kick element.
• exclude -- Possibily wild-card containing string specifying the name of elements to be excluded from the insertion of the space charge kick element.
• disable -- If nonzero, the command is ignored.
• clear -- If nonzero, all prior space charge insertions are deleted.
• element_prefix -- Name under which the space charge kick will appear in the beamline.
• skip -- If nonzero, the given number of insertion locations are skipped. If zero, only one space charge kick is inserted at the end of beamline.
• vertical, horizontal, nonlinear -- If non-zero, then space charge is included in the plane in question.

Note: Some users use $\lq\lq matched\_to\_cell''$ or $\lq\lq use\_twiss\_command\_values''$ inside $\lq\lq bunched\_beam''$ command. Those options will erase SCMULT assignments along the beamline. In this case, user has to re-calculate twiss using $\lq\lq twiss\_output''$ just before tracking.