Mustafa environment description and users' guide with applications to CLIC

In the main linacs of future linear colliders, the control of the emittances and the stability of a train of bunches are critical. It was therefore important for the Compact Linear Collider study (CLIC) to have a tool allowing numerical investigations of these questions. An interactive environment called MUSTAFA (MUltibunch Simulation and Tracking Algorithm for Future Accelerators) has been created and different tools have been developed over the time according to the needs. Progressively, these code and interactive facilities evolved into two main features, their portability on PCs independent from the main frame computers and their analysis capability using animated graphics. All the codes have been written under the MS-DOS operating system. The main application MBTR has been written in FORTRAN, the animated graphics facility MOVIE and the so-called MBUNCH utility program in QUICKBASIC (MS V4.5). The MBUNCH code was created in order to manage in a user friendly set-up the other two mentioned as well as the graphics package TOPDRAW. This report describes the MBTR application and its associated utilities, summarizes the methods used, and provides a users' guide with the input/output characteristics. In addition, illustrative examples are given from applications to CLIC. Single-bunch and multibunch simulation results are briefly presented for the nowadays available CLIC parameters at 1 TeV in the centre of mass. The whole MUSTAFA environment has the purpose of making available to all potential users working on linear accelerator simulations a portable code supplemented with an animated graphics facility.