insert_sceffects

• type: setup command.
• function: set up for transverse space charge calculation.
• This feature can not work with concatenation matrix tracking.
• 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;
	long uniform_distribution = 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.
• uniform_distribution -- Used for bi-Gaussian distributed beam (coasting beam), i.e., beam that is uniform in z but gaussian in x and y.

Note: Some users use matched_to_cell or use_twiss_command_values in the bunched_beam command. Those options will erase SCMULT assignments along the beamline. In this case, user has to re-calculate twiss using twiss_output just before tracking.