insert_elements

• type: action command.
• function: Insert elements into a beamline at specified locations. This is a convenient way to add elements to a beamline without modifying the lattice file.
• notes: The modified beamline can be saved through save_lattice command. Be sure to use ``output_seq = 1'' option in that command.

&insert_elements
        STRING name = NULL;
        STRING type = NULL;
        STRING exclude = NULL;
        long skip = 1;
        long disable = 0;
        long add_at_end = 0;
        STRING element_def = NULL;
        long total_occurrences = 0;
        long occurrence[100]={0};
&end

• name -- Possibly wild-card containing string specifying the name of the elements after which the new element is inserted.
• type -- Possibly wild-card containing string specifying the type of the elements after which the new element is inserted.
• exclude -- Possibly wild-card containing string specifying the names of elements to be excluded from the specification.
• skip -- New elements are inserted at every $n^{th}$ specified location.
• disable -- If nonzero, the command is ignored.
• add_at_end -- If nonzero, the element is also inserted to the end of the beamline.
• element_def -- The definition of the new element should be just as it would be entered in the lattice file.
• total_occurrences, occurrence -- These parameters are used to insert the new elements after specified occurrences of the element name. total_occurrences specifies how many new elements to add, up to a maximum of 100, while the entries in the array occurrence specify the occurrences after which to add the new elements. If total_occurrences is non-zero, then skip must be set to zero and the name must be the exact name (no wild-card matching).