ZGOUBI USERS' GUIDE - HEP

254 2 STORAGE FILES@¨The zgoubi procedures that create and fill these extra output files are the following (refer to Part A and Part B of theguide):Keywords FAISCNL, FAISTORE: fill a ‘.fai’ type file (normally named zgoubi.fai) with particle coordinates andother informations.Keyword SPNPRNL[A]: fill a ‘.spn’ type file (normally named zgoubi.spn) with spin coordinates and other informations., with field map keywords (e.g. CARTEMES, TOSCA) : fill zgoubi.map with 2-D field map.Option ¤ ²a, with magnetic and electric element keywords: fill zgoubi.plt with the particle coordinates, andexperienced field, step after step, all along the optical element.Option ¤¦¨ @Using the keyword MARKER with ’.plt’ as a secondzgoubi.plt.¨´¡W¢will cause storage of current coordinates intoTypical examples of graphics that one can expect from the post-processing of these files by zpop are the following (seeexamples, Part C):‘.fai’ type filesPhase-space plots (transverse and longitudinal), aberration curves, at the position where FAISCNL appears in theoptical structure. Histograms of coordinates. Fourier analysis (e.g. tune numbers in multiturn tracking), calculationof Twiss parameters from phase-space ellipse matching.zgoubi.mapIsomagnetic field lines of 2-D map. Superimposing trajectories read from zgoubi.plt is possible.zgoubi.pltTrajectories inside magnets and other lenses (these can be superimposed over field lines obtained from zgoubi.map).Fields experienced by the particles at the traversal of optical elements. Synchrotron radiation.zgoubi.spnSpin coordinates and histograms, at the position where SPNPRNL appears in the structure. Resonance crossingwhen performing multiturn tracking.