Home

User's Manual for elegant

1. http www maths mq edu au ross 4 von 4 19 01 2001 10 05 34 18 Jan 1995
2. e statistics A flag indicating if set that minimum maximum and average values of Twiss parameters should be computed and included in output http www aps anl gov asd oag manuals elegant ver14 1 node37 html 1 von 2 19 01 2001 10 01 10 twiss output radiation integrals A flag indicating if set that radiation integrals should be computed and included in output e beta X alpha X eta X etap X Ifmatched is zero the initial values for the X plane e concat order Order of matrix concatenation to use for determining matrix for computation of Twiss parameters Using a lower order will result in inaccuracy for nonlinear lattices with orbits However if the orbit is zero it is much faster to use concat order 1 reference file If given the name of a file from which twiss parameter data will be taken to give the starting values Ignored if mat ched is nonzero The file should have the beta and alpha functions with the same names as the file created by this command reference element Element in reference file at which to take the twiss parameter values If not given the values at the last element in reference file are used reference element occurrence Ignored if reference element is not given Otherwise the occurence number of reference element to use If 0 the last occurence is used Next track Up Namelist Command Dictionary Previous steering element Michael Borland 2000 04 10 http
3. SOLE A solenoid implemented as a matrix up to 2nd order Parameter Name Units Type Default L M double 0 0 xs RAD M cowie joo Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node98 html 19 01 2001 10 02 08 SREFFECTS Next STRAY Up Element Dictionary Previous SOLE SREFFECTS Simulation of synchrotron radiation effects damping and quantum excitation Parameter Name Units Type Default PREF Met doubt 00 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node99 htmi 19 01 2001 10 02 09 STRAY Next TMCF Up Element Dictionary Previous SREFFECTS STRAY A stray field element with local and global components Global components are defined relative to the initial beamline direction Parameter Name Units Type Default Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node100 html 19 01 2001 10 02 10 TMCF Next TRCOUNT Up Element Dictionary Previous STRAY TMCF A numerically integrated accelerating TM RF cavity with spatially constant fields pee re NN a to are PHASE g double foo RADIAL OFFSET yg doube 1 ACCURACY double 00000 IXMAX M double o0 IYMAX gdouble 00 PHASE REFERENCE long fo METHOD _ STRING runge kutta FIDUCIAL STRING tmedian Michael Borland 2
4. output_at_each_step A flag indicating whether matrix output is desired at every simulation step start_from The optional name of the accelerator element from which to begin concatenation and output start from occurrence If start_fromis not NULL the number of the occurrence of the named element from which to start Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node21 html 19 01 2001 10 00 57 optimize Next optimization constraint Up Namelist Command Dictionary Previous matrix output optimize e type action command e function perform optimization amp optimize long summarize setup 0 amp end e summarize setup A flag indicating if set that a summary of the optimization parameters should be printed Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node22 html 19 01 2001 10 00 57 optimization constraint Next optimization covariable Up Namelist Command Dictionary Previous optimize optimization constraint e type setup command e function define a constraint for optimization amp optimization constraint STRING quantity NULL double lower 0 double upper 0 amp end e quantity The quantity to be constrained given as an rpn expression in terms of the optimization variables the optimization covariables and and the final parameters see the entry for run setup for the last of these The optim
5. STRING matched to cell NULL double emit x 0 double beta x double alpha x double eta x double etap x double emit y double beta y double alpha y double eta y double etap y long use twiss command values 0 double Po 0 0 double sigma dp 0 0 double sigma s 0 0 double dp s coupling 0 II e Eo go g gw dog OoncoooccocnmnmpoI e ef ee N o oe o O OO Ooo0o0 e Ne Ne Ne e Ne N II c e long one random bunch 1 long symmetrize 0 long limit invariants 0 long limit in 4d 0 long enforce rms values 3 O double distribution_cutoff 3 Dos eg ud STRING distribution type 3 i ga ssian gaussian gaussisan double pentroid 6 0 0 0 0 0 0 0 0 0 0 0 0 long save_initial_coordinates 1 amp end 0 0 e bunch The incomplete name of an SDDS file to which the phase space coordinates of the bunches are to be written Recommended value s bun e n particles per bunch Number of particles in each bunch e time start The central value of the time coordinate for the bunch http www aps anl gov asd oag manuals elegant_ver14 1 node8 html 1 von 2 19 01 2001 10 00 45 bunched beam matched to cell The name of a beamline from which the Twiss parameters of the bunch are to be computed e emit X RMS emittance for the X plane e beta X alpha X eta X etap X Twiss parameters for the X plane use twiss command values If nonzero
6. 0 0 MAGNET ANGLE double 0 0 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node105 html 19 01 2001 10 02 14 TWLA Next TWMTA Up Element Dictionary Previous TUBEND TWLA A numerically integrated first space harmonic traveling wave linear accelerator a 0 00 0 ACCURACY double 0 0001 IXMAX M double o0 IXMAX M dobe oo BETA WAVE debl ALPHA uM m oo a ee NN memo geo FIDUCIAL STRING tmedian http www aps anl gov asd oag manuals elegant_ver14 1 node106 html 1 von 2 19 01 2001 10 02 15 TWLA Next TWMTA Up Element Dictionary Previous TUBEND Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node106 html 2 von 2 19 01 2001 10 02 15 TWMTA Next TWPL Up Element Dictionary Previous TWLA TWMTA A numerically integrated traveling wave muffin tin accelerator LEN NN a I a PHASE RAD doble o0 V M EZ double 0 0 ACCURACY double 0000 IXMAX M double oo ymax M double foo xx I M aoaie Joc BETA_ WAVE double r BSOL BSOL double 0 0 ALPHA ud 1l Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node107 html 19 01 2001 10 02 16 TWPL Next VKICK Up Element Dictionary Previous TWMTA TWPL A numerically integrated traveling w
7. 19 01 2001 10 01 41 MODRF Next MONI Up Element Dictionary Previous MAXAMP MODRF A first order matrix RF cavity with exact phase dependence plus optional amplitude and phase modulation Parameter Name Units Type Default PHASE REFERENCE long 0 FIDUCIAL STRING NULL Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node71 html 19 01 2001 10 01 43 MONI Next MULT Up Element Dictionary Previous MODRF MONI A two plane position monitor accepting two rpn equations for the readouts as a function of the actual positions x and y Parameter Name Units Type Default XCALIBRATION double YCALIBRATION double XREADOUT STRING NULL YREADOUT STRING NULL Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node72 html 19 01 2001 10 01 44 MULT Next NIBEND Up Element Dictionary Previous MONI MULT A canonical kick multipole Parameter Name Units Type Default KNL M ORDER double o0 BORE M double 0 0 woo pum eee 0 0 Michael Borland 2000 04 10 TEE http Awww aps anl gov asd oag manuals elegant_ver14 1 node73 html 19 01 2001 10 01 45 NIBEND Next NISEPT Up Element Dictionary Previous MULT NIBEND A numerically integrated dipole magnet with various extended fringe field models Parameter Name Units Type Defaul
8. CEPL A numerically integrated linearly ramped electric field deflector Parameter Name Units Type Defaut er pese wewe V em m eto be PHASE REFERENCE flong o METHOD STRING frunge kutta FIDUCIAL STRING tmedian Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node46 html 19 01 2001 10 01 19 CHARGE Next CSBEND Up Element Dictionary Previous CEPL CHARGE An element to establish the total charge of a beam Active on first pass only If given overrides all charge specifications on other elements Parameter Name Units Type Default TOTAL Io double 0 0 PER PARTICLE Ic double 0 0 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node47 html 19 01 2001 10 01 20 CSBEND Next CSRCSBEND Up Element Dictionary Previous CHARGE CSBEND A canonical kick sector dipole magnet INTEGRATION ORDER may be 2 or 4 Parameter Name Units Type Default L M double 0 0 ANGLE RAD double 0 0 http www aps anl gov asd oag manuals elegant_ver14 1 node48 html 1 von 2 19 01 2001 10 01 22 CSBEND INTEGRATION ORDER long 2 EDGEIL KICK LIMIT jdowle 1 EDGE2 KICK LIMIT double 1 KICK LIMIT SCALING long o USEBN BN JUSEBN Jong fo Next CSRCSBEND Up Element Dictionary Previous CHARGE Michael Borland 2000 04 10 http www
9. e function set parameters for computation of SASE FEL gain and other properties amp sasefel STRING output NULL STRING model Ming Xie double beta 0 double undulator K 3 1 double undulator period 0 033 amp end e output The incomplete filename of an SDDS file to which output will be written e model The name of the FEL model used At present only one model is supported the Ming Xie model is based on the simple parametrization M Xie 12 e beta The value of the beta function in meters e undulator K The K parameter of the undulator e undulator period The undulator period in meters Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node32 html 19 01 2001 10 01 05 save lattice Next sdds beam Up Namelist Command Dictionary Previous sasefel save lattice e type action command e function save the current accelerator element and beamline definitions amp save lattice STRING filename NULL amp end e filename The incomplete name of a file to which the element and beamline definitions will be written Recommended value s new Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node33 html 19 01 2001 10 01 06 sdds beam Next subprocess Up Namelist Command Dictionary Previous save lattice sdds beam e type setup command e function set up for tracking of particle coordinates stor
10. if you have a recirculation element you should give this flag verbosity A larger value results in more printouts during the computations http www aps anl gov asd oag manuals elegant ver14 1 node10 html 1 von 2 19 01 2001 10 00 47 closed orbit Next correct Up Namelist Command Dictionary Previous chromaticity Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node10 html 2 von 2 19 01 2001 10 00 47 correct Next correction matrix output Up Namelist Command Dictionary Previous closed orbit correct e type setup command e function set up for correction of the trajectory or closed orbit amp correct STRING mode trajectory STRING method global STRING trajectory output NULL STRING corrector output NULL STRING statistics NULL double corrector tweek 2 16 3 l1e 3 double corrector limrtlZ T0 O double correction fraction 2 Ll 1 double correction accuracy 2 le 6 le 6 double bpm noise 2 0 0 double bpm noise cutoff 2 14 0 1201 STRING bpm noise distribution 2 uniform uniform long verbose 1 long fixed_length 0 long fixed_length_matrix 0 long n xy cycles 1 long n iterations 1 long prezero correctors 1 long track before and after 0 long start from centroid 1 long use actual beam 0 double closed orbit accuracy 1e 12 long closed orbit iterations 10 double c
11. 0 SCRI Technical Publication 1994 11 M Borland and L Emery Tracking Studies of Top Up Safety for the Advanced Photon Source Proceedings of the 1999 Particle Accelerator Conference New York 1999 pg 2319 2321 12 M Xie Free ElectronLaser Driven by SLAC LINAC http www aps anl gov asd oag manuals elegant_ver14 1 node117 html 1 von 2 19 01 2001 10 00 38 Bibliography Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node117 html 2 von 2 19 01 2001 10 00 38 Capabilities of elegant Next Namelist Command Dictionary Up Introduction Previous Program Philosophy Capabilities of elegant elegant started as a tracking code and it is still well suited to this task elegant tracks in the 6 dimensional phase space x x y y 8 where x y is the horizontal vertical transverse p p X 5 y coordinate primed quantities are slopes s is the total distance traveled and is the fractional momentum deviation 3 Note that these quantities are commonly referred to as x xp y yp s dp in the namelists accelerator element parameters and output files dp is admittedly confusing it is supposed to remind the user of AP P Sometimes this quantity is referred to as delta Tracking may be performed using matrices of selectable order canonical kick elements numerically integrated elements or any combination thereof For most elements second order
12. 10 01 54 RECIRC Next RFCA Up Element Dictionary Previous RCOL RECIRC An element that defines the point to which particles recirculate in multi pass tracking Parameter Name Units Type Default I_RECIRC_ELEMENT long 0 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node85 html 19 01 2001 10 01 55 RFCA Next RFCW Up Element Dictionary Previous RECIRC RFCA A first order matrix RF cavity with exact phase dependence CHANGE P0 E i ar E NN C E a E a FIDUCIAL STR E NULL lon ENDI1 FOCUS o END2 FOCUS long o mmm N KICKS DY T REFERENCE Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node86 html 19 01 2001 10 01 56 RFCW Next REDF Up Element Dictionary Previous RFCA RFCW A combination of RFCA WAKE and TRWAKE Parameter Name Units Type Default PHASE REFERENCE ons fo FIDUCIAL STRING NULL WAKEFILE STRING NULL IZWAKEFLE STRING NULL ITRWAKEFLE STRING NULL TCOLUMN STRING NULL WXCOLUMN STRING NULL WYCOLUMN STRING NULL IWZCOLUMN STRING NULL http www aps anl gov asd oag manuals elegant_ver14 1 node87 html 1 von 2 19 01 2001 10 01 57 RFCW SG_HALFWIDTH en fk Next REDF Up Element Dictionary Previous RFCA Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver
13. 28 HISTOGRAM Next HKICK Up Element Dictionary Previous FMULT HISTOGRAM Request for histograms of particle coordinates to be output to SDDS file Parameter Name Units Type Default FILENAME STRING Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node56 html 19 01 2001 10 01 29 HKICK Next HMON Up Element Dictionary Previous HISTOGRAM HKICK A horizontal steering dipole implemented as a matrix up to 2nd order Parameter Name Units Type Default 1 M m T CALIBRATION doubleji Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node57 html 19 01 2001 10 01 30 HMON Next IBSCATTER Up Element Dictionary Previous HKICK HMON A horizontal position monitor accepting a rpn equation for the readout as a function of the actual position x Parameter Name Units Type Default CALIBRATION double i READOUT STRING NULL Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node58 html 19 01 2001 10 01 31 IBSCATTER Next KICKER Up Element Dictionary Previous HMON IBSCATTER A simulation of intra beam scattering Parameter Name Units Type Default Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node59 html 19 01 2001 10 01 32 KICKER Next KPOLY Up Element Dictionary
14. A series of examples of elegant input and output are given Finally appendices are included describing the post processing programs Subsections e Program Philosophy e Capabilities of elegant Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node1 html 19 01 2001 10 00 35 Program Philosophy Next Capabilities of elegant Up Introduction Previous Introduction Program Philosophy For all its complexity elegant is not a stand alone program For example most of the output is not human readable and elegant itself has no graphics capabilities These tasks are handled by a suite of post processing programs that serve both elegant and other physics programs These programs collectively known as the SDDS Toolkit 8 9 provide sophisticated data analysis and display capabilities They also serve to prepare input for elegant supporting multi stage simulation Setting up for an elegant run thus involves more than creating input files for elegant per se A complicated run will typically involve creation of a post processing command file that processes elegant output and puts it in the most useful form typically a series of graphs Users thus have the full power of the SDDS Toolkit the resident command interpreter e g the UNIX shell and their favorite scripting language e g Tcl Tk at their disposal The idea is that instead of continually rewriting the physics code to for example make another type
15. E g if you have a file from the shower program containing positrons electrons and photons you might want to select only the positrons e one random bunch A flag indicating whether for spiffe data a new random distribution should be calculated for each step of the simulation e prebunched A flag indicating if zero that the entire file is one bunch and otherwise that each page in the file is a different bunch e sample interval If non zero only every sample interval i particle is used e n tables to skip Number of SDDS pages to skip at the beginning of the file e center transversely If non zero the transverse centroids of the distribution are made to be zero e center arrival time If non zero the mean arrival time of particles at the start of the accelerator is set to zero e sample fraction If non unity the randomly selected fraction of the distribution to use e p lower p upper If different the lower and upper limit on B of particles to use e save initial coordinates A flag that if set results in saving initial coordinates of tracked particles in memory This is the default behavior If unset the initial coordinates are not saved but are reread from disk each time they are needed This is more memory efficient and is useful for tracking very large numbers of particles Next subprocess Up Namelist Command Dictionary Previous save lattice Michael Borland 2000 04 10 http www aps anl gov
16. about changes to parameters http www aps anl gov asd oag manuals elegant_ver14 1 node20 html 1 von 2 19 01 2001 10 00 56 load parameters Next matrix output Up Namelist Command Dictionary Previous link elements Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node20 html 2 von 2 19 01 2001 10 00 56 matrix output Next optimize Up Namelist Command Dictionary Previous load parameters matrix output e type setup action command e function generate matrix output or set up to do so later amp matrix output amp end STRING printout NULL long printout order 1 long full matrix only 05 STRING SDDS output NULL long SDDS output order 1 STRING SDDS output match NULL long output at each step 0 STRING start from NULL long start from occurrence 1 printout The incomplete name of a file to which the matrix output will be printed as text Recommended value s mpr printout order The order to which the matrix is printed full matrix only A flag indicating that only the matrix of the entire accelerator is to be output SDDS output The incomplete name of an SDDS file to which the matrix will be written Recommended value s mat SDDS_output_order The order to which the matrix is output in SDDS format SDDS_output_match A wildcard string which element names must match in order for data to appear in the SDDS output file
17. aps anl gov asd oag manuals elegant_ver14 1 node48 html 2 von 2 19 01 2001 10 01 22 CSRCSBEND Next CSRDRIFT Up Element Dictionary Previous CSBEND CSRCSBEND Like CSBEND but incorporates a simulation of Coherent Synchrotron radiation Parameter Name Units Type Default IL M double 0 0 ANGLE RAD double 0 0 s RAD double m E2 RAD double 0 0 TILT RAD double 0 0 s lu ps joo 0 http www aps anl gov asd oag manuals elegant_ver14 1 node49 html 1 von 2 19 01 2001 10 01 23 CSRCSBEND ISYNCHRAD Song 0 EDGEL EFFECTS leg EDGE EFFECIS ton f IINTEGRATION_ORDER long 2 SGDERIV HALFWIDTH long SGDERIV ORDER f OUTPUT FILE STRING NULL OUTPUT INTERVAL long fi HITS NENE NEN NE CNN Next CSRDRIFT Up Element Dictionary Previous CSBEND Michael Borland 2000 04 10 j M http www aps anl gov asd oag manuals elegant_ver14 1 node49 html 2 von 2 19 01 2001 10 01 23 CSRDRIFT Next DRIF Up Element Dictionary Previous CSRCSBEND CSRDRIFT A follow on element for CSRCSBEND that applies the CSR wake over a drift Parameter Name Units Type Default Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node50 html 19 01 2001 10 01 24 DRIF Next ECOL Up Element Dictionary Previous CSRDRIFT DRIF A drift space implemented as a matrix up to 2nd order Parameter
18. asd oag manuals elegant ver14 1 node34 html 2 von 2 19 01 2001 10 01 07 subprocess Next steering element Up Namelist Command Dictionary Previous sdds beam subprocess e type action command e function execute a system command in a shell amp subprocess STRING command NULL amp end e command The text of the command to execute The command may use the sequence Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node35 html 19 01 2001 10 01 08 steering element Next twiss output Up Namelist Command Dictionary Previous subprocess steering element e type setup command e function setup for use of a given parameter of a given element as a steering corrector e note any use of this command disables the built in definition of HKICK VKICK and HVKICK elements as steering elements amp steering element STRING name NULL STRING item NULL STRING plane iri double tweek le 3 double limit 0 STRING strength_log NULL amp end name The name of the element item The parameter of the element to be varied plane May be either h or v for horizontal or vertical correction limit The maximum allowed absolute value of the item be written as correction proceeds Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node36 html 19 01 2001 10 01 09 tweek The amount by which to change the item to compu
19. beam distribution to verify good transmission and show the centroid position vs z over three turns To execute this demo type the command ejoptk 7 ltp te These files provide a demonstration of transport line simulation The Linac to PAR transport line is simulated with errors and trajectory correction to predict the transmission losses and the steering error at the exit of the septum The trajectory correction uses tracking of a beam distribution which is slower than tracking the centroid but which produces better results in the presence of the large momentum spread The reader may wish to verify this by turning off this feature and running the simulation again To execute this demo type the command 1t p te The running time for this demo is quite long previous Next The rpn Calculator Up User s Manual for elegant Previous ZTRANSVERSE Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node115 html 2 von 2 19 01 2001 10 02 24 The rpn Calculator Next Bibliography Up User s Manual for elegant Previous Examples The rpn Calculator The program rpn is a Reverse Polish Notation programmable scientific calculator written in C It is incorporated as a subprogram into elegant and a number of the SDDS programs It also exists as a command line program rpn1 which executes its command line arguments as rpn operations and prints the result before exiting Use of rpn in any of these modes is extr
20. body To invoke a UDF simply type the name A file containing rpn commands can be executed by pushing the filename onto the string stack and invoking the operator rpn supports more general file I O through the use of functions that mimic the standard C I O routines Files are identified by integer unit numbers with units O and 1 being permanently assigned to the terminal input and terminal output respectively Next Bibliography Up User s Manual for elegant Previous Examples Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node116 html 19 01 2001 10 02 25 About this document Up User s Manual for elegant Previous Bibliography About this document User s Manual for elegant This document was generated using the LaTeX2HTML translator Version 99 2beta6 1 42 Copyright 1993 1994 1995 1996 Nikos Drakos Computer Based Learning Unit University of Leeds Copyright 1997 1998 1999 Ross Moore Mathematics Department Macquarie University Sydney The command line arguments were latex2html elegant The translation was initiated by Michael Borland on 2000 04 10 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node118 html 19 01 2001 10 02 26 Nikos Drakos Personal Details Nikos Drakos Contact Information Nikos Drakos is no longer employed at the Computer Based Learning Unit of the University of Leeds but can be reached at n
21. closed orbit Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node11 html 2 von 2 19 01 2001 10 00 48 correction matrix output Next correct tunes Up Namelist Command Dictionary Previous correct correction matrix output e type setup action command e function provide output of the orbit trajectory correction matrix sc rrect ion matrix output STRING response 2 NULL NULL STRING inverse 2 NULL NULL long Kn units 0 long BnL units 0 long output at each step 0 long output before tune correction 0 long fixed length 0 amp end e response Array of incomplete filenames for SDDS output of the x and y response matrices Recommnended values e inverse Array of incomplete filenames for SDDS output of the x and y inverse response matrices Recommnended values e KnL units Flag that if set indicates use of units of m KOL rather than m rad This results in a sign change for the horizontal data e BnL units Flag that if set indicates use of units of m T m rather than m rad This is useful for linac work in that the responses are automatically scaled with beam energy e output at each step Flag that if set specifies output of the data at each simulation step By default the data is output immediately for the defined lattice e output before tune correction Flag that if set specifies that when output at each step isset that outp
22. correction fraction after each step up interval steps e strength log The incomplete name of a SDDS file to which the quadrupole strengths will be written as correction proceeds Recommended value 96s qst e change defined values Changes the defined values of the quadrupole strengths This means that when the lattice is saved using save lattice the quadrupoles will have the corrected values This would be used for correcting the tunes of a design lattice for example but not for correcting tunes of a perturbed lattice e use perturbed matrix If nonzero requests use of the perturbed correction matrix in performing correction For difficult lattices with large errors this may be necessary to obtain http www aps anl gov asd oag manuals elegant_ver14 1 node13 html 1 von 2 19 01 2001 10 00 50 correct tunes correction In general it is not necessary and only slows the simulation Next error element Up Namelist Command Dictionary Previous correction matrix output Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node13 html 2 von 2 19 01 2001 10 00 50 error element Next error control Up Namelist Command Dictionary Previous correct tunes error element e type setup command e function assert a random error defintion for the accelerator amp error element STRING name NULL STRING element type NULL STRING item NULL STRING type gaussian double amplit
23. if you click on the picture you will get the full photo from which it was extracted 60k gif I am working on other projects and will get around to making this more interesting in due course RSN RSN real soon now or Rather Sooner than Never Ross is Slow at New things In the mean time here are links to some other local web pages Maths Dept Picture Gallery Vacation Scholars 1995 Vacation Scholars 1996 Bush Band Mathematical Sculpture Jane Austen Society Feathered Friends Mathematics at Macquarie Staff Mathematics at Macquarie Current Research http www maths mq edu au ross 1 von 4 19 01 2001 10 05 34 Ross Moore Teaching Courses 1999 1st semester e MATH 130 Mathematics 1E e MATH 132 Mathematics 1A Advanced e MATH 337 DI Algebra IIIA daytime e MATH 337 El Algebra IIIA evening Research interests Top of the list at the moment is LaTeX2HTML This program written in Perl is for translating documents marked up using LaTeX like syntax into well structured HTML pages It works with Unix Linux Windows NT OS 2 and even DOS Originally devised by Nikos Drakos this has been extended to become a really useful translation tool producing very nice images of mathematics for instance and capable of handling quite intricate technical documents See the online manual for details The above course descriptions and the exercise sheets and solutions to which they link were pr
24. node94 html 1 von 2 19 01 2001 10 02 04 SBEN EDGE ORDER long 0 TRANSPORT long 0 USE BN long 0 Next SCATTER Up Element Dictionary Previous SAMPLE Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node94 html 2 von 2 19 01 2001 10 02 04 SCATTER Next SCRAPER Up Element Dictionary Previous SBEN SCATTER A scattering element to add gaussian random numbers to particle coordinates Parameter Name Units Type Default Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node95 html 19 01 2001 10 02 05 SCRAPER Next SEXT Up Element Dictionary Previous SCATTER SCRAPER A collimating element that sticks into the beam from one side only The directions 0 1 2 and 3 are from x y X and y respectively Parameter Name Units Type Default POSmTION Im double 00 IINSERT_FROM STRING NULL Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node96 html 19 01 2001 10 02 05 SEXT Next SOLE Up Element Dictionary Previous SCRAPER SEXT A sextupole implemented as a matrix up to 2nd order Parameter Name Units Type Default IL M double 0 0 c 1 M sox T Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node97 html 19 01 2001 10 02 06 SOLE Next SREFFECTS Up Element Dictionary Previous SEXT
25. of an element to it amp vary element long index number 0 long index limit 0 STRING name NULL STRING item NULL double initial 0 double final 0 long differential 0 long multiplicative 0 long geometric 0 STRING enumeration file NULL STRING enumeration column NULL amp end e index number A non negative integer giving the number of the index index limit A positive integer giving the number of values the index will take Must be given if this index number has not been listed in a previous vary element command unless enumeration file is given name The name of an element item The parameter of the element to vary initial final The initial and final values of the parameter enumeration file Name of an SDDS file giving values for the item enumeration column Column of the SDDS file giving the values differential If nonzero the initial and final values are taken as offsets from the predefined value of the parameter e multiplicative If nonzero the initial and final values are taken as multipliers to be applied to the predefined value of the parameter in order to obtain the actual initial and final values e geometric If nonzero then variation is geometric rather than arithmetic Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node39 html 19 01 2001 10 01 11 Accelerator and Element Description Next Element Dict
26. of graph or squeeze another item into a crowded table one should allow the user to tailor the output to his specific needs using a set of generic post processing programs This approach has been quite successful and is believed particularly suited to the constantly changing needs of research Unlike many other programs elegant allows one to make a single run simulating an arbitrary number of randomizations or variations of an accelerator By using the SDDS toolkit to postprocess the data the user s postprocessing time and effort do not depend on how many random seeds or situations are chosen Hence instead of doing a few simulations with a few seed numbers or values the user can simulate hundreds or even thousands of instances of one accelerator to get an accurate representation of the statistics or dependence on parameters with no more work invested than in doing a few simulations In addition complex simulations such as top up tracking 11 can be performed involving thousands of runs with input created by scripts depending on the SDDS toolkit These simulations make use of concurrent computing on about 20 workstation using the Distributed Queueing System 10 Clearly use of automated postprocessing tools greatly increases the scale and sophistication of simulations possible This stands in stark contrast to the current trend toward graphical user interfaces which virtually force an inefficient one job one computer manual postprocessing way o
27. results in saving initial coordinates of tracked particles in memory This is the default behavior If unset the initial coordinates are not saved but are regenerated each time they are needed This is more memory efficient and is useful for tracking very large numbers of particles previous Next chromaticity Up Namelist Command Dictionary Previous analyze map Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node8 html 2 von 2 19 01 2001 10 00 45 chromaticity Next closed orbit Up Namelist Command Dictionary Previous bunched beam chromaticity e type setup command e function set up for chromaticity correction amp chromaticity STRING sextupoles NULL double dnux dp 0 double dnuy dp 0 double sextupole tweek le 3 double correction fraction 0 9 long n iterations 5 double tolerance 0 STRING strength log NULL long change defined values 0 double strength limit 0 long use perturbed matrix 0 amp end e sextupoles List of names of elements to use to correct the chromaticities e dnux dp dnuy dp Desired chromaticity values e sextupole tweek Amount by which to tweak the sextupoles to compute derivatives of chromaticities with respect to sextupole strength The word tweak is misspelled tweek in the code e correction fraction Fraction of the correction to apply at each iteration In some cases correction is unstable at this number
28. the user may see a variable listed in the printout that is not in this manual These are often obsolete and are retained only for backward compatibility or else associated with a feature that is not fully supported Use of such undocumented features is discouraged Subsections e alter elements amplification factors analyze map bunched beam chromaticity closed orbit correct correction matrix output correct tunes http www aps anl gov asd oag manuals elegant_ver14 1 node4 html 2 von 3 19 01 2001 10 00 41 Namelist Command Dictionary e error element error control find aperture floor coordinates link control link elements load parameters matrix output optimize optimization constraint optimization covariable optimization setup optimization term optimization variable print dictionary rpn expression run control run setup sasefel save lattice sdds beam subprocess steering element twiss output track vary element Next alter elements Up User s Manual for elegant Previous Capabilities of elegant Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node4 html 3 von 3 19 01 2001 10 00 41 alter elements Next amplification factors Up Namelist Command Dictionary Previous Namelist Command Dictionary alter elements type action command function modify the value of a parameter for one or more elements amp alter elements am
29. the voltage factor vs time in seconds Parameter Name Units Type Default PHASE REFERENCE ons 0 VOLT WAVEFORM STRING NULL PHASE_WAVEFORM STRING NULL FREQ_WAVEFORM string NULL IFDUCHL STRING NULL Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node82 html 19 01 2001 10 01 52 RBEN Next RCOL Up Element Dictionary Previous RAMPRF RBEN A rectangular dipole implemented as a SBEND with edge angles Parameter Name Units Type Default L M double 0 0 ANGLE RAD double 0 0 x 1 M odi T E RAD double 0 0 E RAD double 0 0 TILT RAD double 0 0 1 M double 0 0 u double joo o 1 double oo aa double 0 0 ETILT double 0 0 EDGE EFFECTS long l EDGE2 EFFECTS long 1 ORDER long o http www aps anl gov asd oag manuals elegant_ver14 1 node83 html 1 von 2 19 01 2001 10 01 53 RBEN EDGE ORDER long 0 TRANSPORT long 0 USE BN long 0 Next RCOL Up Element Dictionary Previous RAMPRF Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node83 html 2 von 2 19 01 2001 10 01 53 RCOL Next RECIRC Up Element Dictionary Previous RBEN RCOL A rectangular collimator Parameter Name Units Type Default Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node84 html 19 01 2001
30. with different initial x coordinates Finally the tunes and Twiss parameters are computed by tracking they are very close to the analytical values The post processing commands make phase space plots and plots of FFTs of the motion showing that the motion becomes chaotic at the stability limit To execute this demo type the command par10h 2 par sympl These files provide a demonstration of the symplecticity of tracking with elegant kick elements A single large amplitude particle is tracked for pis turns The invariant Jx is then computed and plotted as a function of turn number To execute this demo type the command par sympl The post processing takes quite some time because of the very large number of points 3 par chrom These files provide a demonstration of computing chromaticity and other parameters as a function of momentum offset using map analysis The lattice is the same as parl0h lte except all of the elements are implemented using second order matrices Hence the chromaticity from tracking should be nearly identical to the analytical results computed by the twiss output command which it is To run this demonstration enter par chrom The reader may wish to try this demo again using ksbend csbend or nibend elements in place of the sbend elements and kquad ksext elements in place of the quad sext elements 4 par damp These files provide a demonstration of damping partition calculation using single tur
31. 000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node101 html 19 01 2001 10 02 11 TRCOUNT Next TRFMODE Up Element Dictionary Previous TMCF TRCOUNT An element that defines the point from which transmission calculations are made Parameter Name Units Type Default DUMMY long 0 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node102 html 19 01 2001 10 02 11 TRFMODE Next TRWAKE Up Element Dictionary Previous TRCOUNT TRFMODE A simulation of a beam driven TM dipole mode of a RF cavity Parameter Name Units Type Default PLANE STRING both Michael Borland 2000 04 10 i http www aps anl gov asd oag manuals elegant_ver14 1 node103 html 19 01 2001 10 02 12 TRWAKE Next TUBEND Up Element Dictionary Previous TRFMODE TRWAKE Transverse wake specified as a function of time lag behind the particle Parameter Name Units Type Default JINPUTFILE string NULL TCOLUMN STRING NULL WXCOLUMN STRING NULL WYCOLUMN STRING NULL INTERPOLATE long 10 SGHALFWIDTH long 4 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node104 html 19 01 2001 10 02 13 TUBEND Next TWLA Up Element Dictionary Previous TRWAKE TUBEND A special rectangular bend element for top up backtracking Parameter Name Units Type Default MAGNET WIDTH double
32. 1 LOWERFRACTION double 0 0 UPPERFRACTION double 0 0 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node78 html 19 01 2001 10 01 49 QUAD Next QUFRINGE Up Element Dictionary Previous PFILTER QUAD A quadrupole implemented as a matrix up to 2nd order Parameter Name Units Type Default IL M double 0 0 x 1 M m T Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node79 html 19 01 2001 10 01 50 QUFRINGE Next RAMPP Up Element Dictionary Previous QUAD QUFRINGE An element consisting of a linearly increasing or decreasing quadrupole field Parameter Name Units Type Default IL M double 0 0 x 1 M m T Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node80 html 19 01 2001 10 01 51 RAMPP Next RAMPRF Up Element Dictionary Previous QUFRINGE RAMPP A momentum ramping element that changes the central momentum according to a mpl format file of the momentum factor vs time in seconds Parameter Name Units Type Default WAVEFORM STRING NULL Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node81 html 19 01 2001 10 01 51 RAMPRF Next RBEN Up Element Dictionary Previous RAMPP RAMPRF A voltage ramped RF cavity implemented like RFCA The voltage ramp pattern is given by a mpl format file of
33. 14 1 node87 html 2 von 2 19 01 2001 10 01 57 RFDF Next REMODE Up Element Dictionary Previous RFCW RFDF A deflecting TM RF cavity using an approximate analytical solution Parameter Name Units Type Defaut BFELD T jdwbe 00 PHASE REFERENCE long fo Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node88 html 19 01 2001 10 01 58 RFMODE Next RFTM Up Element Dictionary Previous RFDF RFMODE A simulation of a beam driven TM monopole mode of a RF cavity Parameter Name Units Type Default PRELOAD FACTOR double 1 RECORD STRING NULL Next RFTM Up Element Dictionary Previous RFDF Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node89 html 19 01 2001 10 01 59 RFTM Next RMDF Up Element Dictionary Previous REMODE RFTM Not implemented LUN NN er Tr Ra Dan PHASE RAD double o0 RADIAL_OFFSET M double 00 accuracy double 0 0001 PHASE_REFERENCE ins o oo FILENAME STRING METHOD _ STRING runge kutta _ FIDUCIAL STRING ftmedian Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node90 html 19 01 2001 10 02 00 RMDF Next ROTATE Up Element Dictionary Previous RFTM RMDF A linearly ramped electric field deflector using an approximate analytical solution
34. CTU PEPPOT PFILTER UAD QUFRINGE RAMPP RAMPRF RBEN RCOL RECIRC RFCA RFCW REDF Oo 000 0 c0 c ccc ccc ccc 000000000000 0 http www aps anl gov asd oag manuals elegant_ver14 1 3 von 4 19 01 2001 10 00 34 User s Manual for elegant o RFMODE RFTM RMDF ROTATE SAMPLE SBEN SCATTER SCRAPER SEXT SOLE SREFFECTS STRAY TMCF TRCOUNT TRFMODE TRWAKE TUBEND TWLA TWMTA TWPL VKICK VMON WAKE WATCH ZLONGIT Oo ZTRANSVERSE e Examples e The rpn Calculator e Bibliography e About this document 000000000000 00000000000 0 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 4 von 4 19 01 2001 10 00 34 Introduction Next Program Philosophy Up User s Manual for elegant Previous User s Manual for elegant Introduction elegant stands for ELEctron Generation ANd Tracking a somewhat out of date description of a fully 6D accelerator program that now does much more than generate particle distributions and track them elegant written entirely in the C programming language 1 uses a variant of the MAD 2 input format to describe accelerators which may be either transport lines circular machines or a combination thereof Program execution is driven by commands in a namelist format This document describes the features available in elegant listing the commands and their arguments The differences between elegant and MAD formats for describing accelerators are listed
35. Name Units Type Default L m double 0 0 ORDER long 0 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node51 html 19 01 2001 10 01 24 ECOL Next ELSE Up Element Dictionary Previous DRIF ECOL An elliptical collimator Parameter Name Units Type Default Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node52 html 19 01 2001 10 01 25 ELSE Next ENERGY Up Element Dictionary Previous ECOL ELSE Not implemented Parameter Name Units Type Default Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node53 html 19 01 2001 10 01 26 ENERGY Next FMULT Up Element Dictionary Previous ELSE ENERGY An element that matches the central momentum to the beam momentum or changes the central momentum or energy to a specified value Parameter Name Name Parameter Name Units Type Default CENTRAL ENERGY MC double 0 0 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node54 html 19 01 2001 10 01 27 FMULT Next HISTOGRAM Up Element Dictionary Previous ENERGY FMULT Multipole kick element with coefficient input from an SDDS file Parameter Name Units Type Default FILENAME STRING NULL Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node55 html 19 01 2001 10 01
36. Parameter Name Units Type Default PHASE REFERENCE long fo Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node91 html 19 01 2001 10 02 01 ROTATE Next SAMPLE Up Element Dictionary Previous RMDF ROTATE An element that rotates the beam coordinates about the longitudinal axis Parameter Name Units Type Default TILT RAD double 0 0 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node92 html 19 01 2001 10 02 02 SAMPLE Next SBEN Up Element Dictionary Previous ROTATE SAMPLE An element that reduces the number of particles in the beam by interval based or random sampling Parameter Name Units Type Default FRACTION double 1 INTERVAL long 1 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node93 html 19 01 2001 10 02 03 SBEN Next SCATTER Up Element Dictionary Previous SAMPLE SBEN A sector dipole implemented as a matrix up to 2nd order Parameter Name Units Type Default IL M double 0 0 ANGLE RAD double 0 0 x 1 M odi T E RAD double 0 0 E RAD double 0 0 TILT RAD double 0 0 1 M double 0 0 u double joo er double 00 aa double 0 0 ETILT double 0 0 EDGE EFFECTS long l EDGE2 EFFECTS long 1 ORDER long o http www aps anl gov asd oag manuals elegant_ver14 1
37. Previous IBSCATTER KICKER A combined horizontal vertical steering magnet implemented as a matrix up to 2nd order Parameter Name Units Type Default r 1 M oi T HCALIBRATION doubiej1 VCALIBRATION double Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node60 html 19 01 2001 10 01 32 KPOLY Next KQUAD Up Element Dictionary Previous KICKER KPOLY A thin kick element with polynomial dependence on the coordinates in one plane clc a Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node61 html 19 01 2001 10 01 34 KQUAD Next KSBEND Up Element Dictionary Previous KPOLY KQUAD A canonical kick quadrupole which differs from the MULT element with ORDER L1 in that it can be used for tune correction Parameter Name Units Type Default 7 IM 0 SYSTEMATIC MULTIPOLES STRING NULL RANDOM_MULTIPOLEE STRING NULL IINTEGRATION ORDER flong j Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node62 htmi 19 01 2001 10 01 35 KSBEND Next KSEXT Up Element Dictionary Previous KQUAD KSBEND A kick bending magnet which is NOT canonical but is better than a 2nd order matrix implementation Parameter Name Units Type Default IL M double 0 0 ANGLE RAD double 0 0 E RAD double 0 0 E2 RAD double 0 0
38. TILT RAD double 0 0 m I M awe 00 w AIM se 00 http www aps anl gov asd oag manuals elegant_ver14 1 node63 html 1 von 2 19 01 2001 10 01 36 KSBEND ETILT jdebe foo METHOD STRING modified midpoint next previous Next KSEXT Up Element Dictionary Previous KQUAD Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node63 html 2 von 2 19 01 2001 10 01 36 KSEXT Next MAGNIFY Up Element Dictionary Previous KSBEND KSEXT A canonical kick sextupole which differs from the MULT element with ORDER 2 in that it can be used for chromaticity correction Parameter Name Units Type Default IM pe 0 SYSTEMATIC MULTIPOLES STRING NULL RANDOM_MULTIPOLEE STRING NULL IINTEGRATION ORDER flong j Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node64 html 19 01 2001 10 01 37 MAGNIFY Next MALIGN Up Element Dictionary Previous KSEXT MAGNIFY An element that allows multiplication of phase space coordinates of all particles by constants Parameter Name Units Type Default Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node65 html 19 01 2001 10 01 38 MALIGN Next MARK Up Element Dictionary Previous MAGNIFY MALIGN A misalignment of the beam implemented as a zero order matrix Parameter Name Units Type De
39. User s Manual for elegant Next Introduction User s Manual for elegant Program Version 14 1 Advanced Photon Source Michael Borland April 10 2000 e Introduction O Program Philosophy O Capabilities of elegant e Namelist Command Dictionary O alter elements o amplification factors analyze map bunched beam chromaticity closed orbit correct correction matrix output correct tunes error element error control find aperture floor coordinates link control link elements load parameters matrix output optimize oO 00 00 0c ccc ccc cO O http www aps anl gov asd oag manuals elegant_ver14 1 1 von 4 19 01 2001 10 00 34 User s Manual for elegant O 0000000000000 0 O O optimization_constraint optimization_covariable optimization_setup optimization_term optimization_variable print dictionary rpn expression run control run setup sasefel save lattice sdds beam subprocess steering element twiss output track vary element e Accelerator and Element Description e Element Dictionary o ALPH 0000000000 O 0O O BMAPXY BUMPER CENTER CEPL CHARGE CSBEND CSRCSBEND CSRDRIFT DRIF ECOL ELSE ENERGY FMULT http www aps anl gov asd oag manuals elegant_ver14 1 2 von 4 19 01 2001 10 00 34 User s Manual for elegant o HISTOGRAM HKICK HMON IBSCATTER KICKER KPOLY KQUAD KSBEND KSEXT MAGNIFY MALIGN MARK MATR MATTER MAXAMP MODRE MONI MULT NIBEND NISEPT O
40. als elegant ver14 1 node1 11 html 19 01 2001 10 02 20 WATCH Next ZLONGIT Up Element Dictionary Previous WAKE WATCH A beam property motion monitor allowed modes are centroid parameter coordinate and fft Parameter Name Units Type Default FRACTION doube I FILENAME STRING MODE STRING coordinates Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node112 html 19 01 2001 10 02 21 ZLONGIT Next ZTRANSVERSE Up Element Dictionary Previous WATCH ZLONGIT A simulation of a single pass broad band or functionally specified longitudinal impedance Parameter Name Units Type Default ZREAL STRING NULL ZIMAG STRING NULL WAKES STRING NULL Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node113 html 19 01 2001 10 02 22 ZTRANSVERSE Next Examples Up Element Dictionary Previous ZLONGIT ZTRANSVERSE A simulation of a single pass broad band or functionally specified transverse dipole impedance Parameter Name Units Type Default BROAD BAND leg fo JINPUTFILE STRING NULL FREQCOLUMN STRING NULL IZXREAL STRING NULL ZXMAG STRING NULL ZYREAL STRING NULL ZYIMAG STRING NULL INTERPOLATE leg fo Next Examples Up Element Dictionary Previous ZLONGIT Michael Borland 2000 04 10 http www a
41. at if set specifies that output will contain the coordinates of the centers of all magnets By default the coordinates of the downstream end are given Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node17 html 19 01 2001 10 00 54 link control Next link elements Up Namelist Command Dictionary Previous floor coordinates link control e type setup command e function overall control of element parameter links amp link control long clear links 1 long summarize links 0 long verbosity 0 amp end e clear links Clear all previously set links e summarize links Summarize all current set links e verbosity A larger value results in more output during computations Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node18 html 19 01 2001 10 00 54 link elements Next load parameters Up Namelist Command Dictionary Previous link control link elements e type setup command e function assert a link between parameters of accelerator elements amp link elements STRING target NULL STRING exclude NULL STRING item NULL STRING source NULL STRING source_position before STRING mode dynamic STRING equation NULL amp end e target The name of the elements to be modified by the link May contain wild cards e exclude Wildcard sequence to match to element names If a match is found the element
42. ation of the closed orbit amp closed orbit amp end STRING output NULL long output monitors only D long start from centroid 1 double closed orbit accuracy 1e 12 long closed orbit iterations 105 double iteration fraction 1 long fixed length 0 long start from recirc 0 long verbosity 0 output The incomplete name of an SDDS file to which the closed orbits will be written Recommended value s clo output monitors only If non zero indicates that the closed orbit output should include only the data at the locations of the beam position monitors start from centroid A flag indicating whether to force the computation to start from the centroids of the beam distribution closed orbit accuracy The desired accuracy of the closed orbit in terms of the difference between the start and end coordinates in meters e closed orbit iterations The number of iterations to take in finding the closed orbit e iteration fraction Fraction of computed change that is used each iteration For lattices that are very nonlinear or close to unstable a number less than 1 can be helpful Otherwise it only slows the simulation fixed length A flag indicating whether to find a closed orbit with the same length as the design orbit by changing the momentum offset start from recirc A flag indicating whether to compute the closed orbit from the recirculation recirc element in the beamline In general
43. ave stripline deflector Parameter Name Units Type Defaut ee pese wewe V em m zumr r me PHASE REFERENCE log o METHOD STRING frunge kutta FIDUCIAL STRING tmedian Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node108 html 19 01 2001 10 02 17 VKICK Next VMON Up Element Dictionary Previous TWPL VKICK A vertical steering dipole implemented as a matrix up to 2nd order Parameter Name Units Type Default 1 M m T CALIBRATION doubleji Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node109 html 19 01 2001 10 02 18 VMON Next WAKE Up Element Dictionary Previous VKICK VMON A vertical position monitor accepting a rpn equation for the readout as a function of the actual position y ED et cause ee jr Michael Borland 2000 04 10 lll http www aps anl gov asd oag manuals elegant_ver14 1 node110 html 19 01 2001 10 02 19 WAKE Next WATCH Up Element Dictionary Previous VMON WAKE Longitudinal wake specified as a function of time lag behind the particle Parameter Name Units Type Default JINPUTFILE STRING NULL TCOLUMN STRING NULL WCOLUMN STRING NULL FACTOR Q double f INTERPOLATE long fo SG HALFWIDTH lng 4 Michael Borland 2000 04 10 http www aps anl gov asd oag manu
44. bution 2 May be either gaussian uniform or plus or minus e verbose If non zero information about the correction is printed during computations e fixed length Indicates that the closed orbit length should be kept the same as the design orbit length by changing the momentum offset of the beam e fixed length matrix Indicates that for fixed length orbit correction the fixed length matrix should be computed and used This will improve convergence but isn t always needed n xy cycles Number of times to alternate between correcting the x and y planes n iterations Number of iterations of the correction for each x y cycle prezero correctors Flag indicating whether to set the correctors to zero before starting track before and after Flag indicating whether tracking should be done both before and after correction e start from centroid Flag indicating that correction should start from the beam centroid For orbit correction only the beam momentum centroid is relevant e use actual beam Flag indicating that correction should employ tracking of the beam distribution rather than a single particle e closed orbit accuracy Accuracy of closed orbit computation e closed orbit iterations Number of iterations of closed orbit computation e closed orbit iteration fraction Fraction of change in closed orbit to use at each iteration Next correction matrix output Up Namelist Command Dictionary Previous
45. e orbit or trajectory tunes and chromaticity after adding errors then compute Twiss parameters track or perform a number of other operations In addition to randomly perturbing accelerator elements elegant allows one to systematically vary any number of elements in a multi dimensional grid As before one can track or do other computations for each point on the grid This is a very useful feature for the simulation of experiments e g emittance measurements involving beam size measurements during variation of one or more quadrupoles 6 Like many accelerator codes elegant does accelerator optimization While elegant is not designed to replace matching codes like MAD it will fit the first order matrix and beta functions Of more interest is the ability to optimize results of tracking using a user supplied function of the final beam and transport http www aps anl gov asd oag manuals elegant_ver14 1 node3 html 1 von 2 19 01 2001 10 00 39 Capabilities of elegant parameters This permits solution of a wide variety of problems from matching a kicker bump in the presence of nonlinearities to optimizing dynamic aperture by adjusting sextupoles elegant provides several methods for determining accelerator aperture whether dynamic or physical One may do straightforward tracking of an ensemble of particles that occupies at uniform grid in x y space A more efficient variant of this procedure involves tracking a series of constant x line
46. ed in an SDDS file amp sdds beam STRING input NULL STRING input type elegant long n particles per ring 0 STRING selection parameter NULL STRING selection string NULL long one random bunch 0 long reuse bunch 0 long prebunched 0 long sample interval 1 long n tables to skip 0 long center transversely 0 long center arrival time 0 double sample fraction 1 double p lower 0 0 double p upper 0 0 long save initial coordinates 1 amp end e input Name of an SDDS file containing coordinates of input particles e input type May be elegant or spiffe indicating the name of the program that wrote the input file The expected data quantities for the different types are O elegant x xp Y yp t p where x and y are in meters Xp x and xp y are dimensionless t is in picoseconds and p fi Fy is the dimensionless momentum o spiffe r z pr pz t where r and z are in meters pr Be pz Ay andt is in picoseconds e n particles per ring For spiffe data gives the number of particles to generate for each ring of charge e selection parameter The name of a parameter in the SDDS file to be used for selection of pages of data http www aps anl gov asd oag manuals elegant_ver14 1 node34 html 1 von 2 19 01 2001 10 01 07 sdds beam e selection string The value of the selection parameter selection parameter required for a page to be used
47. emely straightforward Use of the program in its stand alone form is the best way to gain familiarity with it Once you ve entered rpn entering help will produce a list of the available operators with brief summaries of their function Also the rpn definitions file ron defns distributed with elegant gives examples of most rpn operation types Like all RPN calculators rpn uses stacks In particular it has a numeric stack a logical stack and a string stack Items are pushed onto the numeric stack whenever a number token is entered or whenever an operation concludes that has a number as its result items are popped from this stack by operations that require numeric arguments Items are pushed onto the logical stack whenever a logical expression is evaluated they are popped from this stack by use of logical operations that require logical arguments e g logical ANDing or by conditional branch instructions Items enclosed in double quotes are pushed onto the string stack items are popped from this stack by use of operations that require string arguments e g formatted printing rpn supports user defined memories and functions To create a user defined memory one simply stores a value into the name as in 1 sto unity the memory is created automatically when rpn detects that it does not already exist To create a user defined function enter the udf command rpn will prompt you for the function name and the text that forms the function
48. epared using this tool Here are some more examples created locally e National Symposium in Mathematics e a Geo Mathematics paper e Quantum Groups see below e Xy pic User s Guide see below Xy pic This is a suite of macros for typesetting mathematical and other technical diagrams using TeX or LaTeX Written originally by Kristoffer Rose of DIKU Denmark it has undergone extensive revision and extension over the past couple of years http www maths mq edu au ross 2 von 4 19 01 2001 10 05 34 Ross Moore Basically Kris provides the computing structures while I contribute mathematical ideas though sometimes it is the other way round Check out the Xy pic Home Page Peruse the Xy pic User s Guide to see the power and versatility of these macros From the younger continents in the world it may be easier to visit Kris Rose s home Xy pic at BRICS Try here to get the latest version of Xy pic version 3 7 local ftp site Alternatively a CTAN site may be more convenient e by ftp from a mirror site in Australia UNSW Sydney e by ftp Univ of Queensland e use the search engine very convenient el e or find the one nearest you Quantum Groups This is a book written by a colleague Ross Street which I have typeset using LaTeX and LaTeX2HTML It is full of categorical diagrams specified using Xy pic Mathematica Graphics Some attractive graphics that I have produced using Mathematica can be fo
49. f working Next Capabilities of elegant Up Introduction Previous Introduction Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node2 html 19 01 2001 10 00 36 Bibliography Next About this document Up User s Manual for elegant Previous The rpn Calculator Bibliography 1 B W Kernighan and D M Ritchie The C Programming Language Prentice Hall Englewood Cliffs N J second edition 1988 2 H Grote F C Iselin The MAD Program Version 8 1 CERN SL 90 13 AP June 1991 3 K L Brown R V Servranckx First and Second Order Charged Particle Optics SLAC PUB 3381 July 1984 4 M Borland A High Brightness Thermionic Microwave Electron Gun SLAC Report 402 February 1991 Stanford University Ph D Thesis 5 H A Enge Achromatic Mirror for Ion Beams Rev Sci Inst 34 4 1963 6 M Borland private communication 7 W H Press et al Numerical Recipes in C Cambridge University Press Cambridge 1988 8 M Borland A Self Describing File Protocol for Simulation Integration and Shared Postprocessors Proc 1995 PAC May 1 5 1995 Dallas Texas pp 2184 2186 1996 9 M Borland A Universal Postprocessing Toolkit for Accelerator Simulation and Data Analysis Proc 1998 ICAP Conference Sept 14 18 1998 Monterey California to be published 10 T P Green Research Toward a Heterogeneous Networked Computer Cluster The Distributed Queuing System Version 3
50. fault Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node66 html 19 01 2001 10 01 39 MARK Next MATR Up Element Dictionary Previous MALIGN MARK A marker equivalent to a zero length drift space Parameter Name Units Type Default FITPOINT long 0 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node67 html 19 01 2001 10 01 39 MATR Next MATTER Up Element Dictionary Previous MARK MATR Explicit matrix input from a text file in the format written by the print matrix command Parameter Name Units Type Default FILENAME STRING Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node68 html 19 01 2001 10 01 40 MATTER Next MAXAMP Up Element Dictionary Previous MATR MATTER A Coulomb scattering and energy absorbing element simulating material in the beam path Parameter Name Units Type Default Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node69 html 19 01 2001 10 01 41 MAXAMP Next MODRF Up Element Dictionary Previous MATTER MAXAMP A collimating element that sets the maximum transmitted particle amplitudes for all following elements until the next MAXAMP Parameter Name Units Type Default Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node70 html
51. function NULL STRING corrected orbit function NULL STRING kick function NULL STRING name NULL STRING type NULL STRING item NULL STRING plane NULL double change 1e 3 long number to do 1 double maximum z 0 amp end e output The incomplete name of a file for text output Recommended value s af e uncorrected orbit function The incomplete name of a file for an mp1 format output of the uncorrected orbit amplification function Recommended value s uof e corrected orbit function The incomplete name of a file for an mp1 format output of the corrected orbit amplification function Recommended value s cof e kick function The incomplete name of a file for an mp1 format output of the kick amplification function Recommended value s kaf name The optionally wildcarded name of the orbit perturbing elements type The optional type name of the the orbit perturbing elements item The parameter of the elements producing the orbit plane The plane Ch or v to examine change The parameter change to use in computing the amplification number to do The number of elements to perturb maximum z The maximum z coordinate of the elements to perturb Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node6 html 19 01 2001 10 00 42 analyze map Next bunched beam Up Namelist Command Dictionary Previous amplificati
52. h final phase space coordinates will be written Recommended value s out http www aps anl gov asd oag manuals elegant_ver14 1 node31 html 1 von 2 19 01 2001 10 01 04 run setup centroid The incomplete name of an SDDS file into which beam centroids as a function of s will be written Recommended value s cen sigma The incomplete name of an SDDS file into which the beam sigma matrix as a function of z will be written Recommended value s sig final The incomplete name of an SDDS file into which final beam and transport parameters will be written Recommended value s fin acceptance The incomplete name of an SDDS file into which the initial coordinates of transmitted particles will be written Recommended value s acc losses The incomplete name of an SDDS file into which information on lost particles will be written Recommended value s lost magnets The incomplete name of an SDDS file into which a magnet layout representation will be written Recommended value 96s mag semaphore file The incomplete name of file that will be created just before exit from the program but only if no errors occured If the file exists it is deleted This file can be used to record the fact that the run completed without error parameters The incomplete name of an SDDS file into which parameters of accelerator elements are written combine bunch statistics A flag indicating w
53. hether to combine statistical information for all simulation steps If non zero then the sigma and cent roid data will be combined over all simulation steps wrap around A flag indicating whether the z coordinate should wrap around or increase monotonically in multipass simulations e default order The default order of transfer matrices used for elements having matrices e concat order If non zero the order of matrix concatenation used print statistics A flag indicating whether to print information as each element is tracked random number seed A seed for the random number generators If zero a seed will be generated from the system clock correction iterations Number of iterations of tune and chromaticity correction p central Central momentum of the beamline about which expansions are done expand for Name of an SDDS file containing particle information from which the central momentum will be set The file contents are the same as required for elegant input with the sdds beam namelist tracking updates A flag indicating whether to print summary information about tracking previous Next sasefel Up Namelist Command Dictionary Previous run control Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node31 html 2 von 2 19 01 2001 10 01 04 sasefel Next save lattice Up Namelist Command Dictionary Previous run setup sasefel e type setup action command
54. hod simplex double tolerance 0 01 double target 0 long soft failure 1 long n passes 2 long n evaluations 500 STRING log file NULL long output sparsing factor 0 amp end e equation An rpn equation for the optimization function expressed in terms of any parameters of any optimization variables and the final parameters of the beam as recorded in the final output file available in the run_set up namelist The optimization variables or covariables may appear in the equation in the form lt element name gt lt parameter name gt all in capital letters Data from MARK elements with FITPOINT 1 may be used via symbols of the form lt element name gt lt occurrence number gt lt parameter name gt where lt parameter name gt can be a Twiss parameter name if the twiss command was given a floor coordinate name if the floor command was given or a beam size or centroid name The parameter names are the same as those used in the corresponding output files Beam sizes and centroids are from tracking the particle distribution If the twiss command was given you may also refer to statistics of Twiss parameters in the form lt statistic gt lt parameter name gt where statistic is either min or max You may also use the symbols nux dnux dp and corresponding symbols for y alphac and alphac2 These are the tune chromaticity and first and second order momentum compaction factors The fi
55. how strong the steering magnets will need to be Next Namelist Command Dictionary Up Introduction Previous Program Philosophy Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node3 html 2 von 2 19 01 2001 10 00 39 Namelist Command Dictionary Next alter elements Up User s Manual for elegant Previous Capabilities of elegant Namelist Command Dictionary The main input file for an elegant run consists of a series of namelists which function as commands Most of the namelists direct elegant to set up to run in a certain way A few are action commands that begin the actual simulation FORTRAN programmers should note that unlike FORTRAN namelists these namelists need not come in a predefined order elegant is able to detect which namelist is next in the file and react appropriately Each namelist has a number of variables associated with it which are used to control details of the run These variables come in three data types 1 Long for the C long integer type 2 double for the C double precision floating point type 3 STRING for a character string enclosed in double quotation marks All variables have default values which are listed on the following pages STRING variables often have a default value listed as NULL which means no data this is quite different from the value which is a zero length character string 1ong variables are often used as logical flags with a zero value
56. ikos mpn com The LaTeX2HTML archives will continue to be maintained and will be kept at the usual address at http cbl leeds ac uk nikos tex2html doc latex2html latex2html html Interests Many Work Groups Graphical Programming and Intelligent User Interfaces Publications Nikos Drakos LaTeX2HTML Usage Statistics Internal Report Computer Based Learning Unit University of Leeds June 1994 html Nikos Drakos From Text to Hypertext A Post Hoc Rationalisation of LaTeX2HTML To appear in The Proceedings of the First WorldWide Web Conference May 1994 CERN Geneva Switzerland html postscript Nikos Drakos Text to Hypertext conversion with LaTeX2HTML Baskerville December 1993 Vol 3 No 2 pp 12 15 Reprinted with minor modifications in the MAPS TeX Journal postscript or html e A LaTeX to HTML translator postscript or hypertext e Interactive graphical programming environments and software construction hypertext Object Orientation and Visual Programming Extended abstract in postscript or hypertext More publications http cbl leeds ac uk nikos personal html 1 von 2 19 01 2001 10 05 29 Nikos Drakos Personal Details Nikos Drakos Wed Nov 17 20 11 11 GMT 1993 http cbl leeds ac uk nikos personal html 2 von 2 19 01 2001 10 05 29 Ross Moore You have arrived at Ross Moore s Home Page Sorry this is pretty boring at the moment However
57. indicating false and a non zero value indicating true On the following pages the reader will find individual descriptions of each of the namelist commands and their variables Each description contains a sequence of the form amp namelist name lt variable type gt variable name default value amp end This summarizes the parameters of the namelist Note however that the namelists are invoked in the form amp lt namelist name gt lt variable name gt value lt array name gt lt index gt value lt value gt gend The square brackets enclose an optional component Not all namelists require variables to be given the defaults may be sufficient However if a variable name is given it must have a value Values for STRING variables must be enclosed in double quotation marks Values for double variables may be in floating point exponential or integer format exponential format uses the e character to introduce the http www aps anl gov asd oag manuals elegant_ver14 1 node4 html 1 von 3 19 01 2001 10 00 41 Namelist Command Dictionary exponent Array variables take a list of values with the first value being placed in the slot indicated by the subscript As in C the first slot of the array has subscript 0 not 1 The namelist processor does not check to ensure that you do not put elements into nonexistent slots beyond the end of the array doing so may cause the processor to hang u
58. ionary Up User s Manual for elegant Previous vary element Accelerator and Element Description As mentioned in the introduction elegant uses a variant of the MAD input format for describing accelerators With some exceptions the accelerator description for one program can be read by the other with no modification Among the differences e elegant does not support the use of MAD style equations to compute the value of a quantity The link element namelist command can be used for this purpose and is actually more flexible than the method used by MAD Also rpn style equations may be given in double quotes these are evaluated once only when the lattice is parsed e elegant does not support substitution of parameters in beamline definitions e elegant contains many elements that MAD does not have such as kick elements wake fields and numerically integrated elements e The length of an input line is not limited to 80 characters in elegant as it is in MAD However for compatibility any lattice created by elegant will conform to this limit elegant sprint dictionary command allows the user to obtain a list of names and short descriptions of all accelerator elements recognized by the program along with the names units types and default values of all parameters of each element The present output of this command is listed in the next section The reader is referred to the MAD manual 2 for details on sign conventions for angles focusi
59. is excluded from the link e item The parameter that will be modified e source The name of the elements to be linked to moss ID NN moss e source position May be one of before after adjacent nearest or same occurrence e mode May be either dynamic or static A dynamic link is asserted whenever the source is changed during correction for example A static link is asserted only when an error or variation is imparted to the source and at the end of correction e equation n rpn equation for the new item value in terms of the item values for the source The prior value of the item is on the top of the stack To refer to the source parameter values use the name of the parameters These names must appear in capital letters Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node19 html 19 01 2001 10 00 55 load parameters Next matrix output Up Namelist Command Dictionary Previous link elements load parameters e type setup command e function load parameters for elements from an SDDS file amp load parameters STRING filename NULL long change defined values 0 long clear settings 0 long allow missing elements 0 long verbose 0 amp end e filename Name of SDDS file from which to take data The file must contain some of the following columns o ElementName Required string column The name of the element to change o ElementParame
60. it the magnet into halves XSN and DPN allow momentum filtration at the midpoint Parameter Name Units Type Default WIDTHPUCK M doubie 0 0 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node42 html 19 01 2001 10 01 15 BMAPXY Next BUMPER Up Element Dictionary Previous ALPH BMAPXY A map of Bx and By vs x and y METHOD NULL STRING NULL FILENAME NULL STRING NULL Michael Borland 2000 04 10 i http www aps anl gov asd oag manuals elegant ver14 1 node43 html 19 01 2001 10 01 16 BUMPER Next CENTER Up Element Dictionary Previous BMAPXY BUMPER A time dependent uniform field rectangular kicker magnet with no fringe effects The waveform is in mpl format with time in seconds and amplitude normalized to 1 Parameter Name Units Type Default PHASE REFERENCE fling fo WAVEFORM STRING NULL SPATIAL DEPENDENCE STRING NULL Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node44 html 19 01 2001 10 01 17 CENTER Next CEPL Up Element Dictionary Previous BUMPER CENTER An element that centers the beam transversely on the ideal trajectory Parameter Name Units Type Default y wj Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node45 html 19 01 2001 10 01 18 CEPL Next CHARGE Up Element Dictionary Previous CENTER
61. ization co variables are referred to as lt element name gt lt parameter name gt in all capital letters e lower upper The lower and upper limits allowed for the expression Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node23 html 19 01 2001 10 00 58 optimization covariable Next optimization setup Up Namelist Command Dictionary Previous optimization constraint optimization covariable e type setup command e function define an element parameter to be varied as a function of optimization parameters amp optimization covariable STRING name NULL STRING item NULL STRING equation NULL amp end e name The name of the element e item The parameter of the element to be changed e equation n rpn equation for the value of the parameter in terms of the values of any parameters of any optimization variable These latter appear in the equation in the form lt element name gt lt parameter name gt in all capital letters Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node24 html 19 01 2001 10 00 59 optimization setup Next optimization term Up Namelist Command Dictionary Previous optimization covariable optimization setup e type setup command e function define overall optimization parameters and methods amp optimization setup STRING equation NULL STRING mode minimize STRING met
62. list Command Dictionary Previous error control find aperture e type action command e function find the aperture in x y space for an accelerator amp find aperture STRING output NULL STRING boundary NULL STRING mode many particle double xmin 0 1 double xmax 0 1 double ymin 0 0 double ymax 0 1 long nx 21 long ny 11 long n splits 05 double split fraction 0 5 double desired resolution 0 01 long verbosity 0 long assume nonincreasing 0 amp end e output The incomplete name of an SDDS file to send output to Recommended value 6s aper e boundary The incomplete name of an SDDS file for the boundary points of the aperture search Recommended value s bnd e xmin xmax ymin ymax Region of the aperture search e mode May be many particle or single particle Many particle searching is much faster but does not allow interval splitting to search for the aperture boundary e nx Number of x values to take in initial search e ny Number of y values to take in search e n splits If positive the number of times to do interval splitting Interval splitting refers to searching between the original grid points in order to refine the results e split fraction If interval splitting is done how the interval is split e desired resolution If interval splitting is done fraction of xmax xmin to which to resolve the aperture e assume
63. losed orbit iteration fraction 1 amp end e mode Either trajectory or orbit indicating correction of a trajectory or a closed orbit e method For trajectories may be one to one or global For closed orbit must be global e trajectory output The incomplete name of an SDDS file to which the trajectories or orbits will be written Recommended value s traj or s orb e corrector output The incomplete name of an SDDS file to which information about the final corrector strengths will be written Recommended value s cor e statistics The incomplete name of an SDDS file to which statistical information about http www aps anl gov asd oag manuals elegant_ver14 1 node11 html 1 von 2 19 01 2001 10 00 48 correct the trajectories or orbits and corrector strengths will be written Recommended value s scor e corrector tweek 2 The amount by which to change the correctors in order to compute correction coefficients The word tweak is misspelled tweek in the code e corrector limit 2 The maximum strength allowed for a corrector e correction fraction 2 The fraction of the computed correction strength to actually use for any one iteration e correction accuracy 2 The desired accuracy of the correction in terms of the RMS BPM values e bpm noise 2 The BPM noise level e bpm noise cutoff 2 Cutoff values for the random distributions of BPM noise e bpm noise distri
64. matrices are available matrix concatenation can be done to any order up to third Canonical kick elements are available for bending magnets quadrupoles sextupoles and higher order multipoles all of these elements also support optional classical synchrotron radiation losses Among the numerically integrated elements available are extended fringe field bending magnets and traveling wave accelerators A number of hybrid elements exist that have first order transport with exact time dependence e g RF cavities Several elements support simulation of collective effects such as wakefields and intra beam scattering Some of the more unusual elements available are third order alpha magnets 4 5 time dependent kicker magnets voltage ramped RF cavities beam scrapers and beam analysis screens A wide variety of output is available from tracking including centroid and sigma matrix output along the accelerator In addition to tracking internally generated particle distributions elegant can track distributions stored in external files which can either be generated by other programs or by previous elegant runs Because elegant uses SDDS format for reading in and writing out particle coordinates it is relatively easy to interface elegant to other programs using files that can also be used with SDDS to do post processing for the programs elegant allows the addition of random errors to virtually any parameter of any accelerator element One can correct th
65. n tracking with synchrotron radiation The expected value of the longitudinal damping partition http www aps anl gov asd oag manuals elegant_ver14 1 node115 html 1 von 2 19 01 2001 10 02 24 Examples for PAR is J 1 758 The user may edit the lattice file par damp 1te to invoke a different element for the dipole magnet In particular definitions for numerically integrated dipoles with extended fringe fields are present To execute this demo type the command par damp 5 par dynap These files provide a demonstration of dynamic aperture runs for a series of randomized machines Also exhibited here are orbit tune and chromaticity correction The post processing commands make a plot of the dynamic apertures with the physical aperture superimposed The orbcorr plots script can also be used to plot orbit correction information To execute this demo type the command par dynap The lattice has been stripped down so that only a few of the more significant multipoles are present Also fictitious extra sextupoles have been added to compensate the lack of second order edge terms in the bending magnets these would result in nonsymplectic tracking if included Still the running time is many hours 6 ejoptk These files provide a demonstration of the optimization of a multi turn ejection bump for PAR using a time dependent kicker waveform formed from two cubic splines After optimization the lattice is tracked with a realistic
66. nal values of the Twiss parameters are referred to simply as bet ax etax etc If the twiss command was given and radiation integral computation was requested you may use ex0 and Sdelta0 for the equilibrium emittance and energy spread plus J lt plane gt and tau lt plane gt for the damping partition and damping time where plane is x y or delta If the floor_coordinates command was given you may use X Z and theta to refer to the final values of the floor coordinates http www aps anl gov asd oag manuals elegant ver14 1 node25 html 1 von 2 19 01 2001 10 01 00 optimization setup Finally you may use any of the names from the final output file see run setup e g Sx x beamsize or eny y normalized emittance These refer to tracked properties of the beam The equation may be left blank in which case the user must give one or more optimization term commands These use the same symbols of course e mode May be either minimize or maximize Moss e method May be one of simplex grid and sample e tolerance The convergence criterion for the optimization with a negative value indicating a fractional criterion target The value which if reached results in immediate termination of the optimization whether it has converged or not soft failure A flag indicating if set that failure of an optimization pass should not result in termination of the optimization e n passes The n
67. nation of which terms are causing problems for the optimization Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node26 html 19 01 2001 10 01 01 optimization variable Next print dictionary Up Namelist Command Dictionary Previous optimization term optimization variable e type setup command e function defines a parameter of an element to be used in optimization amp optimization variable STRING name NULL STRING item NULL double lower limit 0 double upper limit 0 double step size 1 amp end e name The name of the element e item The parameter of the element to be varied e lower limit upper limit The lower and upper limits allowed for the parameter If these are equal the range of the parameter is unlimited e step size The initial step size simplex optimization or the grid size in this dimension C grid or sample optimization Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node27 html 19 01 2001 10 01 01 print dictionary Next rpn expression Up Namelist Command Dictionary Previous optimization variable print dictionary e type action command e function print dictionary of supported accelerator elements amp print dictionary STRING filename NULL amp end e filename The name of a text file to which the dictionary will be printed Michael Borland 2000 04 10 http www aps a
68. ng strength and so forth previous Next Element Dictionary Up User s Manual for elegant Previous vary element Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node40 html 19 01 2001 10 01 12 Element Dictionary Next ALPH Up User s Manual for elegant Previous Accelerator and Element Description Element Dictionary Subsections e ALPH BMAPXY BUMPER CENTER CEPL CHARGE CSBEND CSRCSBEND CSRDRIFT DRIF ECOL ELSE ENERGY FMULT HISTOGRAM HKICK HMON IBSCATTER KICKER KPOLY KQUAD KSBEND KSEXT MAGNIFY MALIGN http www aps anl gov asd oag manuals elegant ver14 1 node41 html 1 von 3 19 01 2001 10 01 14 Element Dictionary e MARK MATR MATTER MAXAMP MODRF MONI MULT NIBEND NISEPT OCTU PEPPOT PFILTER UAD QUFRINGE RAMPP RAMPRF RBEN RCOL RECIRC RFCA RFCW REDE REMODE RFTM RMDF ROTATE SAMPLE SBEN SCATTER SCRAPER SEXT SOLE SREFFECTS http www aps anl gov asd oag manuals elegant ver14 1 node41 html 2 von 3 19 01 2001 10 01 14 Element Dictionary e STRAY IMCFE TRCOUNT TREMODE TRWAKE TUBEND IWLA TWMTA TWPL VKICK VMON WAKE WATCH ZLONGIT ZTRANSVERSE Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node41 html 3 von 3 19 01 2001 10 01 14 ALPH Next BMAPXY Up Element Dictionary Previous Element Dictionary ALPH An alpha magnet implemented as a matrix up to 3rd order PART is used to spl
69. nl gov asd oag manuals elegant_ver14 1 node28 html 19 01 2001 10 01 02 rpn expression Next run control Up Namelist Command Dictionary Previous print dictionary rpn expression e type action setup command e function pass an expression directly to the rpn submodule for execution amp rpn expression STRING expression NULL amp end e expression An rpn expression This expression is executed immediately and can be used for example to read in rpn commands from a file or store values in rpn memories Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node29 html 19 01 2001 10 01 03 run control Next run setup Up Namelist Command Dictionary Previous rpn expression run control e type setup command e function set up the number of simulation steps and passes amp run control long n steps 1 double bunch frequency 0 long n indices 0 long n passes 1 amp end e n steps The number of separate repetitions of the action implied by the next action command If random errors are defined this is also the number of separate error ensembles e bunch frequency The frequency to use in calculating the time delay between repetitions e n indices The number of looping indices for which to expect definitions in subsequent vary element commands If nonzero then n steps is ignored e n passes The number of passes to make through the beamline per repetition Michael B
70. nonincreasing If this variable is non zero the search assumes that the aperture at http www aps anl gov asd oag manuals elegant_ver14 1 node16 html 1 von 2 19 01 2001 10 00 53 find aperture y sign y Ay is no larger than that at y This results in tracking of fewer particles but may give a pessimistic result e verbosity A larger value results in more printouts during computations Next floor coordinates Up Namelist Command Dictionary Previous error control Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node16 html 2 von 2 19 01 2001 10 00 53 floor coordinates Next link control Up Namelist Command Dictionary Previous find aperture floor coordinates e type action command e function compute floor coordinates for an accelerator amp floor coordinates STRING filename NULL double X0 0 0 double ZO 0 0 double theta0 0 0 long include vertices 0 long vertices only 0 long magnet centers 0 amp end e filename The incomplete name of an SDDS file to send output to Recommended value Ys flr e X0 Z0 thetaO Initial X Z and angle coordinate of the e include vertices Flag that if set specifies including in the output the coordinates of the vertices of bending magnets e vertices only Flag that if set specifies that output will contain only the coordinates of the vertices of bending magnets e magnet centers Flag th
71. on factors analyze map e type action command e function find the approximate first order matrix and related quantities for an accelerator by tracking amp analyze map SIRING output NULL double delta x le 6 double delta xp le 6 double delta y le 6 double delta yp 1e 6 double delta s 1e 60 double delta dp le 6 long center on orbit 0 long verbosity 0 amp end e output The incomplete name of a file for SDDS output o Recommended value s ana o File contents A series of dumps each consisting of a single data point containing the centroid offsets for a single turn the single turn R matrix the matched Twiss parameters tunes and dispersion functions e delta X The amount by which to change the quantity X in computing the derivatives that give the matrix elements e center_on_orbit A flag directing the expansion to be made about the closed orbit instead of the design orbit e verbosity The larger this value the more output is printed during computations Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node7 html 19 01 2001 10 00 43 bunched beam Next chromaticity Up Namelist Command Dictionary Previous analyze map bunched beam e type setup command e function set up for tracking of particle coordinates with various distributions amp bunched beam STRING bunch NULL long n particles per bunch 1 double time start 0
72. orland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node30 html 19 01 2001 10 01 03 run setup Next sasefel Up Namelist Command Dictionary Previous run control run setup e type setup command e function set global parameters of the simulation and define primary input and output files SUN setup STRING lattice NULL STRING use_beamline NULL STRING rootname NULL STRING output NULL STRING centroid NULL STRING sigma NULL STRING final NULL STRING acceptance NULL STRING losses NULL STRING magnets NULL STRING semaphore_file NULL STRING parameters NULL long combine_bunch_statistics 0 long wrap around 1 long default order 2 long concat order 0 long print statistics 0 long random number seed 987654321 long correction iterations 1 double p central 0 0 STRING expand for NULL long tracking updates 1 long echo lattice 0 amp end e lattice Name of the lattice definition file e echo lattice If nonzero the lattice input is echoed to the standard output as the lattice is parsed This can help detect certain problems with the lattice that cause elegant to crash e use beamline Name of the beamline to use e rootname Filename fragment used in forming complete names from incomplete filenames By default the filename minus extension of the input file is used e output The incomplete name of an SDDS file into whic
73. p end STRING name NULL STRING item NULL STRING exclude NULL double value 0 long differential 0 long multiplicative 0 long verbose 0 long allow_missing_parameters 0 e name A possibly wildcard containing string giving the names of the elements to alter e item The name of the parameter to alter e item A possibly wildcard containing string giving the names of elements to excluded from alteration value The new value for the parameter differential If nonzero the new value is the predefined value of the parameter plus the quantity given with value multiplicative If nonozero the new given value is the predefined value of the parameter times the quantity given with value verbose If nonzero information is printed to the standard output describing what elements are changed allow_missing_parameters If nonzero then it is not an error if an element does not have the parameter named with item Normally such an occurence is an error and terminates the program Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node5 html 19 01 2001 10 00 41 amplification factors Next analyze map Up Namelist Command Dictionary Previous alter elements amplification factors e type action command e function compute corrected and uncorrected orbit amplification factors and functions amp amplification factors STRING output NULL STRING uncorrected orbit
74. p or crash Wildcards are allowed in a number of places in elegant and the SDDS Toolkit The wildcard format is very similar to that used in UNIX e stands for any number of characters including none e stands for any single character e list of characters stands for any single character from the list The list may include ranges such as a z which includes all characters between and including a and Z in the ASCII character table The special characters and are entered literally by preceeding the character by a backslash e g Vv In many places where a filename is required in an elegant namelist the user may supply a so called incomplete filename An incomplete filename has the sequence 26s imbedded in it for which is substituted the rootname The rootname is by default the filename less the extension of the lattice file The most common use of this feature is to cause elegant to create names for all output files that share a common filename but differ in their extensions Post processing can be greatly simplified by adopting this naming convention particularly if one consistently uses the same extension for the same type of output Recommended filename extensions are given in the lists below When elegant reads a namelist command one of its first actions is to print the namelist back to the standard output This printout includes all the variables in the namelist and their values Occasionally
75. ps anl gov asd oag manuals elegant_ver14 1 node114 html 19 01 2001 10 02 23 Examples Next The rpn Calculator Up User s Manual for elegant Previous ZTRANS VERSE Examples Example runs and post processing files are included along with the distribution of elegant These are drawn from the author s research and all concern various aspects of the Argonne Positron Accumulator Ring PAR and its injection and ejection lines LTP and PTB respectively The examples are intended to demonstrate program capabilities with minimal work on the user s part Each demo is invoked using a command a C shell script that can both run elegant and post process the output After running the demo the output can be viewed again without rerunning elegant by invoking the command with the word review added to the command line Including the word hardcopy on the command line results in the graphs being sent to your default printer which is assumed to accept Postscript The post processing is typically handled by a lower level script that is called from the demo script These lower level scripts are good models for the creation of customized scripts for user applications 1 par10h These files provide a demonstration of Twiss parameter computation tracking element variation and map analysis The lattice is defined with kick elements which are used for all tracking After computation of the Twiss parameters for the PAR 6 a series of particles are tracked
76. s of particles with fixed y values with elimination of any given y value whenever a stable particle is found Finally one may use a single particle search method that can locate the aperture for a series of y values to a predefined resolution in x In addition to using analytical expressions for the transport matrices elegant supports computation of the first order matrix and linear optics properties of a circular machine based on tracking A common application of this is to compute the tune and beta function variation with momentum offset by single turn tracking of a series of particles This is much more efficient than for example tracking and performing FFTs though e1egant will do this also This both tests analytical expressions for the chromaticity and allows computations using accelerator elements for which such expressions do not exist e g a numerically integrated bending magnet with extended fringe fields A common application of random error simulations is to set tolerances on magnet strength and alignment relative to the correctability of the closed orbit A more efficient way to do these calculations is to use correct orbit amplification factors 6 elegant the computes amplification factors and functions for corrected and uncorrected orbits and trajectories pertaining to any element that produces an orbit or trajectory distortion It simultaneously computes the amplification functions for the steering magnets in order to determine
77. should be reduced e n iterations Number of iterations of the correction to perform e tolerance Stop iterating when chromaticities are within this value of the desired values e strength log The incomplete name of an SDDS file to which the sextupole strengths will be written Recommended value s ssl e change defined values Changes the defined values of the sextupole strengths This means that when the lattice is saved using save lattice the sextupoles will have the corrected values This would be used for correcting the chromaticity of a design lattice for example but not for correcting chromaticity of a perturbed lattice e strength limit Limit on the absolute value of sextupole strength Ka e use perturbed matrix If nonzero requests use of the perturbed correction matrix in performing correction For difficult lattices with large errors this may be necessary to obtain http www aps anl gov asd oag manuals elegant ver14 1 node9 html 1 von 2 19 01 2001 10 00 46 chromaticity correction In general it is not necessary and only slows the simulation Next closed orbit Up Namelist Command Dictionary Previous bunched beam Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node9 html 2 von 2 19 01 2001 10 00 46 closed orbit Next correct Up Namelist Command Dictionary Previous chromaticity closed orbit type setup command function set up for comput
78. t L o M je foo m m jdwe ft FSE double 0 0 erur double 0 0 ACCURACY double 0 0001 MODEL STRING linear METHOD STRING runge kutta Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node74 html 19 01 2001 10 01 46 NISEPT Next OCTU Up Element Dictionary Previous NIBEND NISEPT A numerically integrated dipole magnet with a Cartesian gradient Parameter Name Units Type Default ACCURACY double 0 0001 METHOD STRING runge kutta MODEL STRING linear Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node75 html 19 01 2001 10 01 47 OCTU Next PEPPOT Up Element Dictionary Previous NISEPT OCTU Not implemented use the MULT element Parameter Name Units Type Default Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node76 html 19 01 2001 10 01 47 PEPPOT Next PFILTER Up Element Dictionary Previous OCTU PEPPOT A pepper pot plate Parameter Name Units Type Default TRANSMISSION double 0 0 Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node77 html 19 01 2001 10 01 48 PFILTER Next QUAD Up Element Dictionary Previous PEPPOT PFILTER An element for energy and momentum filtration Parameter Name Units Type Default DELTALIMIT double
79. te the steering strength strength log The incomplete name of a SDDS file to which the strengths of the item will twiss output Next track Up Namelist Command Dictionary Previous steering element twiss output e type action setup command e function compute and output Twiss parameters or set up to do so amp twiss output STRING filename NULL long matched 1 long output at each step 0 long output before tune correction 0 long final values only 0 long statistics 0 long radiation_integrals 0 long eoncat_order 3 double beta_x 1 double alpha_x 0 double eta_x 0 double etap_x double beta_y double alpha_y double eta_y 0 double etap_y 0 STRING reference file NULL STRING reference element NULL long reference element occurrence 0 amp end FOr e e filename The incomplete name of an SDDS file to which the Twiss parameters will be written Recommended value s twi e matched A flag indicating if set that the periodic or matched Twiss parameters should be found e output at each step A flag indicating if set that output is desired at each step of the simulation e output before tune correction A flag indicating if set that output is desired both before and after tune correction e final values only A flag indicating if set that only the final values of the Twiss parameters should be output and not the parameters as a function of s
80. ter Required string column The name of the parameter of the element to change O ParameterValue Optional double column If given gives value of the parameter named in ElementParameter for element named in ElementName O ParameterValueString Optional string column If ParameterValue is not present then this column must be present The string data will be scanned if necessary to obtain a value for the parameter O ParameterMode Optional string column If given for each row the value must be one of absolute differential ignore or fractional Unless change defined values is set successive pages of the file are used for successive steps of the simulation Several elegant commands generate output that may be used on a subsequent run with load_parameters among these are the tune and chromaticity correction commands and the run_setup command parameters output e change defined values Changes the defined values of the parameters This means that when the lattice is saved using save lattice the parameters will have the altered values Also if you want to alter the values for all steps of the simulation you must set this flag e clear settings Ifset clear all settings and files being used for loading parameters e allow missing elements If set allow elements in the file that are not in the lattice In this case the nonapplicable data is simply ignored e verbose If set provide informational printouts
81. then the values for B GO 1 and y are taken from the twiss command It is an error if no twiss command has been given Po Central momentum of the bunch sigma_dp sigma_s Fractional momentum spread and bunch length dp s coupling Specifies the coupling between s and defined as sd auc 5 f one_random_bunch If non zero then only one random particle distribution is generated Otherwise a new distribution will be generated for every simulation step enforce_rms_values 3 Flags one for each plane indicating whether to force the distribution to have the specified RMS properties e distribution cutoff 3 Distribution cutoff parameters for each plane e distribution type 3 Distribution type for each plane May be gaussian moss hard edge uniform ellipse shell or dynamic aperture limit invariants If non zero the distribution cutoffs are applied to the invariants rather than to the coordinates limit in 4d If non zero then the transverse distribution is taken to be a 4 d gaussian or uniform distribution One of these must be chosen using the distribution type control It must be the same for x and y symmetrize Ifnon zero the distribution is symmetric under changes of sign in the coordinates Automatically results in a zero centroid for all coordinates e centroid 6 Centroid offsets for each of the six coordinates e save initial coordinates A flag that if set
82. ude 0 0 double cutoff 3 0 long bind 1 long bind number 0 long post correction 0 long fractional 0 long additive 1 STRING after NULL STRING before NULL amp end e name The possibly wildcarded name of the elements for which errors are being specified e element type An optional possibly wildcarded string giving the type of elements to which the errors should be applied E g element type MON would match all beam position monitors If this item is given then name may be left blank e item The parameter of the elements to which the error pertains Moss e type The type of random distribution to use May be one of uniform gaussian or plus or minus A plus or minus error is equal in magnitude to the amplitude given with the sign randomly chosen e amplitude The amplitude of the errors e cutoff The cutoff for the random distribution e bind bind number If bind number is positive then a positive value of bind indicates that bind number successive elements having the same name will have the same error value If bind is negative then the sign of the error is alternated between successive elements e post correction A flag indicating whether the errors should be added after orbit tune and chromaticity correction e fractional A flag indicating whether the errors are fractional in which case the amplitude refers to the amplitude of the fractional error http ww
83. umber of optimization passes made to achieve convergence simplex only e n evaluations The number of allowed evaluations of the optimization function If simplex optimization is used this is the number of allowed evaluations per pass log file A file to which progress reports will be written as optimization proceeds For SDDS data use the final output file from the run setup namelist output sparsing factor If set to a value larger than 0 results in sparsing of output to the final file see run setup This can make a significant difference in the optimization speed Next optimization term Up Namelist Command Dictionary Previous optimization covariable Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant ver14 1 node25 html 2 von 2 19 01 2001 10 01 00 optimization term Next optimization variable Up Namelist Command Dictionary Previous optimization setup optimization term e type setup command e function define optimization equation via individual terms amp optimization_ STRING term NULL amp end e term An rpn expression giving one term to be optimized If more than one optimization term command is given then the terms are added The advantage of using this command over giving an equation via optimization setupisthat elegant will report the value of each term as it performs the optimization if a log file is given to optimization setup This permits determi
84. und in Garnet Surfaces These reconstruct foliation surfaces i e deformed layers of included minerals within rock samples in the presence of crystals of garnet Indeed here is a QuickTime movie of such a reconstructed inclusion surface viewed from different angles so apparently rotating Spiral Movie 354k Other uses of Mathematica for Geo physical modelling are described in a Geo Mathematics paper to be published in a special volume of Computers amp Geosciences late in 1999 Here is a Mathematica Notebook containing frames for a movie of a reconstruction of foliation surfaces forming a millipede microstructure Millipede 431k Here are some QuickTime movies of the same thing sectioned in different ways e Millipede YZ sections 1MB e Millipede XZ sections 800k e Millipede XY sections 820k For viewing QuickTime movies on various platforms I recommend http Awww maths mq edu au ross 3 von 4 19 01 2001 10 05 34 Ross Moore e Macintosh Simple Player or many other utils e Unix XAnim Rev 2 69 7 7 2 May 95 by Mark Podlipec e Unix XAnim Rev 2 68 5 23 Aug 94 by Mark Podlipec e Windows QuickTime for Windows Dr Ross R Moore X500 Mathematics Department Macquarie University Australia 2109 Fax 61 2 850 8914 Work Phone 61 2 850 8955 Internet ross mpce mq edu au M P C E MPCE Home Page ross mpce mg edu au Ba Ross Moore Mathematics Department ross 9 mpce mq edu au
85. ut shall occur prior to correcting the tunes e fixed length Flag that if set specifies output of the fixed path length matrix Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node12 html 19 01 2001 10 00 49 correct tunes Next error element Up Namelist Command Dictionary Previous correction matrix output correct tunes e type setup command e function set up for correction of the tunes amp correct tunes STRING quadrupoles NULL double tune x 0 double tune y 0 long n iterations 5 double correction fraction 0 9 double tolerance 0 long step up interval 0 double max correction fraction 0 9 double delta correction fraction 0 1 STRING strength log NULL long change defined values 0 long use perturbed matrix 0 amp end e quadrupoles List of names of quadrupoles to be used Only two may be given tune x tune y Desired x and y tune values If not given the desired values are assumed to be the unperturbed tunes n iterations The number of iterations of the correction to perform correction fraction The fraction of the correction to apply at each iteration tolerance When both tunes are within this value of the desired tunes the iteration is stopped step up interval Interval between increases in the correction fraction max correction fraction Maximum correction fraction to allow delta correction fraction Change in
86. w aps anl gov asd oag manuals elegant_ver14 1 node14 html 1 von 2 19 01 2001 10 00 51 error element e additive A flag indicating that the errors should be added to the prior value of the parameter If zero then the errors replace the prior value of the parameter e after The name of an element If given the error is applied only to elements that follow the named element in the beamline e before The name of an element If given the error is applied only to elements that precede the named element in the beamline Next error control Up Namelist Command Dictionary Previous correct tunes Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node14 html 2 von 2 19 01 2001 10 00 51 error control Next find aperture Up Namelist Command Dictionary Previous error element error control e type setup command e function overall control of random errors amp error control long clear error settings 1 long summarize error settings 0 STRING error log NULL amp end e clear error settings Clear all previous error settings e summarize error settings Summarize current error settings e error log The incomplete name of a SDDS file to which error values will be written Recommended value 6s erl Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node15 html 19 01 2001 10 00 51 find aperture Next floor coordinates Up Name
87. www aps anl gov asd oag manuals elegant ver14 1 node37 html 2 von 2 19 01 2001 10 01 10 track Next vary element Up Namelist Command Dictionary Previous twiss output track e type action command e function track particles amp track long center on orbit 0 long center momentum also 1 long soft failure 1 long use linear chromatic matrix 0 long longitudinal ring only 0 amp end e center on orbit A flag indicating whether to center the beam transverse coordinates on the closed orbit before tracking e center momentum also A flag indicating whether to center the momentum coordinate also e soft failure If there is an error during tracking e g a failure of orbit correction continue to produce file output This creates essentially empty slots in the files corresponding to the failed steps e use linear chromatic matrix For each particle a first order matrix is computed for the particular momentum offset of the particle using the linear chromaticity and linear dependence of the beta functions on momentum e longitudinal ring only Tracks longitudinal coordinates only for a ring Michael Borland 2000 04 10 http www aps anl gov asd oag manuals elegant_ver14 1 node38 html 19 01 2001 10 01 11 vary element Next Accelerator and Element Description Up Namelist Command Dictionary Previous track vary element e type setup command e function define an index and or tie a parameter

User's Manual for elegant

Contents

Download Pdf Manuals

Related Search

Related Contents