Home

turtle intro.p65

1. ga Globals A Paiste Charge fi ta Particle Mass 138 600000 mev lt 0 5110 2 22e 005 Beam Energy 24 693104 mev gt 0 0010 1 00e 010 x Beam Current fo 000000 0 0000 1 00e 007 Frequency 80 000000 e 1 93 Green Dots next to Global Parameters pom indicate the Native Inputs for the Current Application Context KvBeam decay DRFT QD 1 DRFT DRFT QP 2 DRFT DRFT D 3 DRFT DRFT D 4 DRFT DRFT HFQD xSect zero new ap xSect zero FINAL Global Parameters have Guidance Limits Alert User if Parameters built in Default Values N Are Outside Reasonable Bounds 3 0000 3 00e 004 0 0020 10 0000 Figure 6 Beamline Global Parameters in the Document Window 12 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Both TURTLE and DECAY TURTLE also use the Number of Macro Particles Global Parameter which 1s found on the Tracing Tracking Global tab panel Click on the Tracing Tracking tab in the Document Window to access the Number of Macro Particles Global Parameter as well as additional Global Parameters used by the DECAY TURTLE Application Module Figure 7 shows the Tracing Tracking Global Parameters tab panel In addition to the Number of Macro Particles Parameter DECAY TURTLE also uses the last three Global Parameters in this tab panel Particle Lifetime Parent Decay Particle 1 Mass and Decay Particle 2 Mass Th
2. Yy 2 7500 Pen Width a v LEGEND 0 0000 Y m vs X m 2 7500 5 500000 5 500000 2 7500 0 0000 2 7500 Y m vs X m 5 500000 Figure 46 Neutrino Y X Distribution at Marker after Quad HFQD Figures 47 and 48 show plots generated by this example following the Aperture Piece new ap 0 0055 0 0000 0 0055 Y m vs X m Figure 47 Pion Y X Distribution at Marker after Aperture Piece new ap 76 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules y Turtle Plot Window ecay Copy thew Lysis Zoo las SetScale 0 0055 Pen With s LEGEND 0 0000 Y m vs X m 0 0055 0 0055 0 0000 0 0055 Y m vs X m Figure 48 Muon Y X Distribution at Marker after Aperture Piece new ap In this example none of the neutrinos have survived passing through the vertical aperture applied to that component The result is that no data 1s available for the requested neutrino plot following the Aperture Piece An alert message is displayed to indicate that more plots have been requested than there are data sets generated by DECAY TURTLE Figure 49 below illustrates this the alert message PEO Lab ix There were more plot specs then there were id s in the Plot file Figure 49 Alert Indicating that No DECAY TURTLE Particles were generated for at least one of the requested plots 71 Muon Daughterl decay
3. 4 0 0000 INF 3 wi S Maximum Step Size fo 010000 m s vert Half Angle Cut Y fo 014276 ra 0 0000 INF s Long Half Aperture iz fo 005728 0 0000 INF Momentum Spread Cut fo 005283 Fractionfrad 0 0000 INF a uaa Semi Axis 1 000000 cm 0 1000 1 0000 4 ojx 0000 Shift Click for Position Z y Pen Width f ick for Position 0 0300 C LEGEND E ne Plot Window A x 4 he H Ku HR np 0 0000 Copy Sha non s ee EO ae Y rad vs Y m 0 0300 lOlx Pe 0 0300 Shift Click for Position Va Pen Width fi LEGEND x rad vs X m 0 012000 0 0300 0 0000 0 0000 0 0300 0 0300 0 0060 0 0000 0 0060 x rad vs X m 0 012000 0 0060 0 0000 0 0060 x rad vs X m 0 012000 0 012000 Figure 23 Example using the Aperture Piece with TURTLE 39 An aperture can be applied to any magnet element Bend Quad Sextupole Octupole etc using the Pipe Aperture parameter in the Geometry tab panel of the Piece Window Pipe Apertures specified in the Geometry tab panel of magnet Piece Windows can be applied or ignored using the Apertures Option in the TURTLE Options Window Pipe Apertures specified in the Geometry tab panel of magnet Piece Windows will apply to the particle type that is selected in the Apertures tab panel of the Options Window for DECAY TURTLE PBO Lab 2 0 Use
4. US Pen Width fi Y LEGEND Y In Bounds 0 0050 0 010000 Particle Distribution Histogram Figure 30 Example of Two Dimensional Scatter Plots 2 D Correlation Plots and One Dimensional Bar Graphs 1 D Projection Plots 55 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Named Particles in DECAY TURTLE When the Application Context is set for DECAY TURTLE in the Marker Piece Window the Open Button in the Diagnostics panel will open the DECAY TURTLE Plot Specification Window Figure 31 illustrates an example of a Marker with one 1 TURTLE plot specification and three 3 DECAY TURTLE plot specifications EB Location Marker Energy DECAY TURTLE Constraints Select a particle from the Named Particles popup for each DECAY TURTLE Open Remove Plot Specification Comments Sect The Plot Specification Window for DECAY TURTLE provides a pop up to select a particle for each plot specification Diagnostics Turtle scatter Y wa X Decay Turtle Scatter Y va Decay Turtle Scatter Y vs M H Decay Turtle Plot Specification Decay Turle Scatter Y va M Vertical fy 20 000000 cm 550 00000 550 000000 Delete Plot Selection 1 D Projection Plot f 2 0 Correlation Plot Projection Axis Bin Size Units Axis Range Horizontal x 29 000000 cm 550 00000 550 000000 Auto Scale Plots E mama MER jm
5. 0 550000 d 0 550000 0 2750 0 0000 0 2750 0 350000 m vs X m Figure 53 Muon Y X Distribution at Marker after Quad HFQD Ei Decay Turtle Plot Window Bis x Print Copy Dia Tyriis ER dag SetScale POPARA PIO AVIV OPNE POPA PIK Aeaee edoa 5 500000 Shift Click for Position x Po J 27500 Pen Width 3 v LEGEND mj vs X m 0 0000 2 7500 5 500000 5 500000 2 7500 0 0000 2 7500 5 500000 m vs X m Figure 54 Neutrino Y X Distribution at Marker after Quad HFQD 81 The muon Daughter1 decay particle beam cross section is unchanged except for statistical variations at the exit of the magnet labeled HFQD when magnet apertures are applied only to the Parent particles The neutrino Daughter2 decay particle beam cross section is also unchanged except for statistical variations when the magnet apertures are applied only to the Parent particles PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules This page is intentionally blank 82 PBO Lab 2 0 TURTLE User Manual User Manual Supplement TURTLE amp DECAY TURTLE Application Modules 83 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules 84
6. S 26 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules H Special Energy Parameters Value Units Limits Quad Aper Axis GAPA ooo ns 0 0090 0 5000 sjauad Hyper Aper AFH ooo m H 0 0090 0 5000 m E E E slvet Quad Aper QAPB ooo 00090 05000 Parent Charge PARENT 1 000000 s Decay 1 charge DAUCHTERT1 ooooco sjDecay 2 Charge DAUGHTER fo ooo H Special Parameter Settings PARENT decay PARENT symbolic Parameter Name PION 1 0000 1 0000 1 0000 1 0000 t amp amp amp 1 0000 1 0000 EA Special Parameter Settings DAUGHTER1 decay DALGHTERI C symbolic Parameter Mame fwon EA Special Parameter Settings DAUGHTER2 decay DAUGHTER Symbolic Parameter Mame WELT RRC Decay Turtle 9 Special Parameters must be defined by a Symbolic Parameter DAUGHTER Particle Name is NEUTRINO Name in the Special Parameter Settings Window that is accessed using the parameter s S Button Figure 14 Specifying Particle Names and Charges for DECAY TURTLE The charge for the primary particle is specified in the Globals tab panel of the Beamline Global Parameters in Parameters for the primary particle the Document Window Particle masses for the primary Charge rs i N BETH tone and secondary particles and the lifetime for the primary ey Pere Masses are WAT j specified in
7. TURTLE with MAD Input Trace Unlimited Rays Through Lumped Elements A Computer Program for Simulating Charged Particle Beam Transport Systems and DECAY TURTLE Including Decay Calculations describes the TURTLE and DECAY TURTLE programs and 1s included with this Supplement TURTLE TURTLE is a multi particle ray tracing program used to transport particles through a charged particle optical system TURTLE 1s an acronym for Trace Unlimited Rays Through Lumped Elements The TURTLE program is useful to support the analysis of beamlines designed for TRANSPORT or for other PBO Lab Modules and can be used to model misalignments apertures slits beam distortion and particle loss TURTLE is often used to evaluate the effect of aberrations which exist in beams with small phase space volume including higher order chromatic aberrations effects of non linearities in magnetic fields and higher order geometric aberrations due to the accumulation of second order effects The lumped element approximation implemented by TURTLE precludes conventional local geometric aberrations due to large phase space Refer to the TURTLE Documentation included with this Supplement for a complete discussion of the uses and limitations of the TURTLE program The TURTLE program can be used to evaluate the effects of aberrations in beams with small phase space volume including chromatic aberrations effects of non linearities in magnetic fields and geometric aberr
8. el l H _ p H _ ME a _ R tam SPEC Drift Marker Aperture Marker ina K Beam decay DRFT QD 1 DRFT DRFT QD 2 DRFT DRFT QD 3 DRFT DRFT D 4 DRFT DRFT HFQD xSect zero new ap xSect zero FINAL Decay Particle 1 Mass Decay Particle 2 Mass gt Figure 7 PBO Lab Global Parameters Used for DECAY TURTLE 13 The Particle Charge Particle M ass Beam Energy and Frequency are in the Globals tab panel in the Document Window The Number of Macro Particles Global Parameter is used to specify the number of rays that will be traced through the beamline The Decay product M asses are set in the Tracing Tracking panel of the Global Parameters However the Charges for decay particles are set using the PBO Lab Special SPEC Piece PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules The Particle Charge Particle Mass Beam Energy and Frequency are among the first five Global Parameters and are readily accessible in the Global Parameters Pane on the Work Space of the Document window These Parameters are used to generate native inputs such as the mass of particles in the beam the reference trajectory momentum and the reference momentum for magnetic fields for both TURTLE and DECAY TURTLE The Tracing Tracking Global Parameters tab panel is used to access the Number of Macro Particles Parameter and the Particle Lifetime Parent Decay Particle 1 Mass and Decay Particle 2 Mass used b
9. SPEC Piece Decay product masses are set in the Tracing Tracking panel of the Global Parameters The charges of the decay particles are set using the PBO Lab Refer to the Beamline Global Parameters Section for a SPEC Piece description of the Global Parameters used by DECAY TURTLE The Special Piece Section describes naming particles and specifying the charge parameters for decay particles the charge parameters for decay particles PBO Lab provides interactive Graph Plot Windows that replace the native character based plots generated by the TURTLE and DECAY TURTLE programs Examples of the PBO Lab Scatter Plots are shown in Figure 4 Turtle Plot Window PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules PBO Lab also provides graphic representations ofthe data generated by TURTLE and DECAY TURTLE Any plot specifications will result in PBO Lab Graph Plot Windows opening automatically after execution Plot Specifications can be created for any location n the beamline by placing a Marker Piece in the beamline model and accessing the Plot Specification Window with the Open Button in the Diagnostics panel The Plot List command n the Commands Menu TURTLE and DECAY TURTLE can be used to list and access all of the Plot Specifications for the entire beamline Refer to the Marker Piece Section n the Beamline Elements Chapter as well as the Plot Specifications Chapter n this Supplement PBO Lab interact
10. The pion beam is very similar to that shown on the previous page and 19 not displayed Shift Click for Position x yi 0 0055 Pen Width a k LEGEND Y m vs X m 0 0000 0 0055 0 0055 0 0000 0 0055 Y m vs X m Figure 50 Muon Y X Distribution at Marker after Aperture Piece new ap following a second execution of DECAY TURTLE 78 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules ZA Decay Turtle Plot Window Print Copy Gana yrhai Zo cat i SetScale F Shift Click for Position x eae 0 0055 Pen Width la z LEGEND Y m vs X m 0 0000 0 0055 0 0055 0 0000 0 0055 Y m vs X m Figure 51 Neutrino Y X Distribution at Marker after Aperture Piece new ap following a second execution of DECAY TURTLE As a final example of the use of DECAY TURTLE the Option to apply magnet apertures to the Parent particles is illustrated in Figure 52 The quadrupole magnet labeled HFQD has a Pipe Aperture radius specification of 0 5 cm The other quadrupoles in the Example B Pion Decay pbol model have larger radial apertures 1 0 cm The Apertures panel of the DECAY TURTLE Options window is used to apply the magnet apertures 79 Neutrino Daughter2 decay particle beam cross section at the exit of slits labeled new ap Now one of the neutrinos has survived the vertical slit aper
11. VERTICAL AXIS x INR 999 M FROM THE START VID 008 DU 00 008 OL TOTALS IA AR AR RR AR AR RR RR AR AR K T 014 TO 013 I I U UL ITO 012 I I U 012 y e 014 I I U TO UIU 1 L 0 010 TO 009 I I U m TO 6167 lt 14 I 0 003 IO 00T T I U l 7 TO 006 I da 1 1 2 006 TO 009 I 12 1 192122 12232 L Al VS TO a OR I H H R e S R 114323311 111 I 46 004 TO 003 17 14113872233114115442 32443142 1 2 I 84 Vo TO 002 I 121 3122115451146512352432344122 1221 1 I 89 ol tO p0 I 11 4 34432335463682365541234553411213 ih I iza 10 TO 000 I 1 12113321353338444229266 64453344 1 3 1 I LEI s ODO TO OUL I 12312 321535622425454454482141432343531211 I 127 UUL TO 002 1 1 242 17324523 45355374745414143612335411 T od s004 TO 003 I 113 2234 346244364244546333244522 242 I 113 DU TO 004 I 1 3321443333 443253161324211211131 I Od 004 TO c 0091 Act 1217 345 1221 I 54211 ja I 42 005 IO 006 I I la 2111 21923 SI 11 I 25 006 TO 007 I il I 1 0 0 re 008 I I U s009 TO 009 I I U 0023 TO UIU I T 0 s010 TO pO I I 0 011 TO Ola 1 I U s012 TO L I U 013 TO 014 I I 0 IA AR AR RR AR AR RR RR AR KK RAT ee I I I I I I I 1 2222234224344 3235435 5255322211121 TOTALS I 00012692867115810788006867558742239638721674310000 I 1000 TOTAL NUMBER OF ENTRIES 1000 INCLUDING UNDERFLOW AND OVERFLOW AS FOLLOWS LEFT RIGHT ABOVE U U U U 1000 0 BELOW U U U SUM OF SQUARES S152 CENTER 000 RMS HALF WIDTH 00
12. elliptical apertures is not fully implemented in current versions of TURTLE and DECAY TURTLE programs Default parameter values for the Aperture Piece are set for an infinite aperture for all trajectory coordinates i e no aperture restrictions on the beam The Observe Apertures option in the Options Window applies to Pipe Apertures that are specified on individual magnet elements This option does not apply to Aperture Pieces in the beamline model Refer to the Options Chapter of this Supplement for a description of the Observe Apertures option Each trajectory coordinate specifying a slit or aperture in the Aperture Piece Window is applied to only one type of particle in DECAY TURTLE To apply the same slit or aperture values to more than one particle type make a copy of the Aperture Piece for one particle type and then assign another particle type to each of the slit or aperture trajectory coordinates 35 Aperture The PBO Lab Aperture Piece is used to implement the SLIT element Type Code 6 for TURTLE and DECAY TURTLE The PBO Lab Aperture Piece W indow supports the three different aperture options Circular Rectangular and Elliptical which are described in the TURTLE Documentation However support for circular and elliptical apertures Is not fully implemented in the current versions of the TURTLE and DECAY TURTLE programs The Observe Apertures option does not apply to Aperture Pieces in the beamli
13. 0 011000 0 0055 0 0000 0 0055 0 011000 m vs X m Figure 44 P on Y X Distribution at Marker after Quad HFQD Decay Turtle Plot Window Bis P Print Copy Diary VETA ZOO KAK SetScale 0 550000 T Shift Click for Position Bi Yy 0 2750 Pen Width a e LEGEND Y m vs X m 0 0000 0 2750 0 550000 R 0 550000 0 2750 0 0000 0 2750 0 550000 Y m vs X m Figure 45 Muon Y X Distribution at Marker after Quad HFQD 75 The pion Parent particle beam cross section is approximately elliptical at the exit of magnet labeled HFQD Muon Daughterl decay particle beam cross section is not elliptical at the exit of magnet HFQD Note the difference in scale as compared to the Pion Parent particle beam Neutrino Daughter2 decay particle beam cross section at the exit of magnet HFQD Note the difference in scale as compared to the Pion and Muon beam plots Only 4 neutrinos are within the requested plot region The pion Parent particle beam cross section is approximately elliptical at the exit of slits labeled new ap The slits apertures are only applied to the muon and neutrino com ponents so the pion beam plot is identical to that following magnet HFQD PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Mile ES ZA Decay Turtle Plot Window 5 500000 Shift Click for Position x
14. An Swart se 20 990000 550 90909 550 099900 Hars 20 009900 550 00000F50 000000 oo SE Figure 31 DECAY TURTLE Plot Specifications Window Plot Specifications for DECAY TURTLE are similar to those of TURTLE described in the previous subsection However DECAY TURTLE requires a particle to be selected for each plot specification Particles are selected for a particular plot using the Symbolic Parameter Name assigned with the Special SPEC Piece Refer to the Special Piece Section in the Beamline Elements Chapter A pop up control is provided in the DECAY TURTLE Plot Specifications Window Figure 31 to chose from the named particles 56 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules Plot Specification Parameters Some care must be used n setting up the Plot Specification AE ne Bro ran HEARSE parameters and some iteration may be necessary inorder P Pen ful output An example af how PBOLabcanbe 5 Madden ka aa to get use sa P 77 D buis Range parameters for a TURTLE Plot used to assist in defining the plot specification parameters is discussed below Figure 32 illustrates setting up plot specifications for the two transverse x x and y y phase space plots of the rays at the end of the beamline EA Final Ellipse Plots Mil N gt Pe nal In Print Copy Show Symbols Tre ind SetScale Option for the Transport Plot Specification then Execute ER Write Input amp R
15. Application Module but also apply to DECAY TURTLE VO files for DECAY TURTLE can be identified by a capital D appended to the file name The TurtleInput text file which is used to run the TURTLE program is generated by PBO Lab for the Beamline in the Model Space of a Document Window Similarly the D TurtleInput file generated by PBO Lab is used to execute the DECAY TURTLE program Both TURTLE and DECAY TURTLE trace rays through the beamline and produce character based histograms of the results This character based output 19 presented in the TurtleOutput or D TurtleOutput text file after executing the program Enhanced graphic output 1s created by PBO Lab using the data generated by TURTLE which is written to the TURTLEPIotData file DECAY TURTLE plot data is written to the D TURTLEPIlotData file PBO Lab uses the Plot Specifications along with the plot data generated by TURTLE or DECAY TURTLE to create Bar Graphs and Scatter Plots in Interactive Graph Plot Windows Figure 25 shows some examples of the TURTLE VO files in PBO Lab Text Edit Windows Inputs for TURTLE and DECAY TURTLE are automat ically generated by PBO Lab when Write Input and Run commands are used in TURTLE or DECAY TURTLE Commands Menu The input file 1s not displayed before running the Application Module However the input file can be created and viewed in one step with Write Input and View command Refer to the Commands Menu
16. Reference Trajectory Momentum Magnetic Field Reference Momentum Particle Mass Tilt to Focal Plane Fringe Field Parameters Horizontal Half Width Half Pole Spacing Orbit Displacement Integral Fringe Field Factor K 1 Fringe Field Factor K2 Entrance Pole Face Curvature Exit Pole Face Curvature Expansion Parameters Second Order Field Third Order Field Excess Field Fraction Field Scaling Factor Vertical Dipole Factor Vertical Gradient Factor FOTILT HWIDTH FINTO FINT The Special Piece can be placed anywhere in the beamline by dragging the icon from the Palette Bar and inserting it at the desired location in the beamline model Special Pieces on the Work Space are ignored when generating special instructions SPEC cards 28 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules Special Pieces must precede any element s to which they apply Once a Special Parameter has been defined with a symbolic name and value it will apply to all succeeding elements of the appropriate type An exception is made for particle names and charges which apply to the entire beamline model Deleting the symbolic name for a Special parameter will disable the parameter without deleting the value assigned to that parameter in the Special Piece Window Moving a Special Piece from the Model Space to the Work Space will also disable any Special Parameters defined by that piece Figure 15 shows an example of the Special
17. Section of the Menu Commands Chapter for a description of these commands Alternatively an existing I O file can be opened in a Text Edit Window using commands from the View Menu in PBO Lab Document Window Refer to the View Menu Section in the Menu Commands Chapter for a description of these commands 43 PBO Lab generates the required input for executing the TURTLE and DECAY TURTLE programs Output data from TURTLE and DECAY TURTLE is used to generate Bar Graphs and Scatter Plots in PBO Lab interactive Graph Plot Windows Output may be specified at any location in the model by placing M arker Pieces in the beamline Existing I O files can be opened in Text Edit Windows using commands from the View Menu in the PBO Lab Document Window PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules File Edit Fort Turtle Model Example E Mod After Fit pbol 1000 UNIT 1 H aes 3 E File Edt Font UH LT 6 H HISTOGRAM NO 1 UN TT 7 E HORIZONTAL AXIS X INM 959 M FROM THE UHIT 10 GEV E VERTICAL AXIS X INR 959 M FROM THE UNIT 12 TUHE 02777778 u a0 on 002 UHIT 13 H x TAX k k kk kk kk kk kk T ORDER 1 1 _ I I SPEC PMASS 1 875000 I PRINT CENTROID OFF I BEAM E 0 006724 XF 0 029183 7 0 0051 gt 11 12 11 I L 0 011456 DEL 0 010566 PO 0 086626 S ae CORR C12 0 952111 C34 0 934271
18. _ u ig LEFT DRIFT L 0 173000 y 15 2246438 41132 ODi QUADRUPOLE L 0 096000 GRADb 39 x I 11 2 141 3322634222 2 I LEFT DRIFT L 0 029800 I 1321648332339327214 1 I LEFT DRIFT L 0 029800 E I 112323434466124221323 I QD2 QUADRUPOLE L 0 096000 GRAD 359 7 SE Ber DEFT DRIFT L 0 042700 I 2 1254452551A32412212 I DEFT DRIFT L 0 042700 I 132 41242289233515 53 2 I OD3 QUADRUPOLE L 0 096000 GRAD 345 I Zoe e re I ie I 1 33 75341583162 12311 2 ODA QUADRUPOLE 1 0 036000 GRAD 263 u Leo S I 23 231264 223443311 DEFT DRIFT L 0 045700 I 12112 2121328 1131 HFOD QUADRUPOLE L 0 045000 GRAD 26 I E ae 1 I PRINT BEAM N N AHIST 3 0 010700 0 010700 0 000400 l vE ke DHIST 4 0 014400 0 014400 0 001000 I I AHIST 1 0 010700 0 010700 0 000400 i I DHIST 2 0 014400 0 014400 0 001000 Tree it PRINT BEAM l PRINT CENTROID Z PRINT TRANS I 112255754775657543421 I PRINT 30 TOTALS I 00000000000015474974236763892218408640000000000000 I 1000 SENTINEL NUMBER OF ENTRIES 1000 INCLUDING UNDERFLOW AND OVERFLOW AS FOLLOWS LEFT RIGHT ABOVE 0 0 0 4 0 1000 0 Oooo BELOW U U U SUM OF SQUARES 3910 CENTER 000 RMS HAI File Edit Fort x Xp Y YD Z Zp S 18 0 242606EF 04 0 507194E 02 0 651567E 02 0 162556E 02 O 304778E 02 0 499912E 02 14 O 387934E 02 0 677700E 03 0 435035E 03 0 341222F 02 0 16939378E 0 0 410173E 02 18 O 275950E 02 0 196186E 0 2 0 632646E 02 0O 906514E 03
19. data in the graph plot This feature is generally used for multi variable plots generated with other Application Modules such as TRANSPORT or MARYLIE Above the Legend is a Pen Width pop up with selections that range from one to five The default is one and for most graphs this is the preferred pen width However for Scatter Plots from TURTLE or DECAY TURTLE a Pen Size of two may produce a more desirable result The Show Symbols button is used with Line Plots to display Symbols for each data point The coordinates of any plotted point can then be displayed by clicking on the symbol for that point while holding the shift key down This feature is used with multi variable line plots and is inactive for Bar Graphs and Scatter Plots generated with TURTLE and DECAY TURTLE Graph scales can be automatically calculated to fit the data set or they may be specified explicitly in the Plot Specification Once a Graph Plot Window 1s created the vertical and horizontal scales of the graph may be directly modified using the Set Scale button This button activates the m n and max plot scales on the plot axes S mply type n the desired values and press the Enter key Alternatively the mouse can be used to quickly zoom n on a specific region of the graph Some Graph Plot Windows also provide a drag box zoom feature that allows an unlimited number of zooms for any region of the graph by making a drag box with the mouse The Zoom Out button is used t
20. f 1 D Projection Plot f 2 0 Correlation Plot Projection Axis Bin Size Axis Range Set Vertical E 9 040000 E 070000 i OZOOOO Delete meni x 9 040000 E 070002 1 070000 pan Remove N Auto Scale Plots Figure 18 Specifying Diagnostic Plots with Location Markers in the beamline 34 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules Aperture Piece Apertures can be defined in two ways for TURTLE and DECAY TURTLE by using 1 Aperture Pieces or 2 using the Pipe Aperture parameter in the Geometry tab panel of Piece Windows for any magnet element Bend Quad Sextupole Octupole etc Aperture Pieces placed in the beamline model are used to impose an aperture or slit for succeeding Pieces The Pipe Aperture parameter used by magnet Pieces only applies to a single Piece not to succeeding Pieces The PBO Lab Aperture Piece s used exclusively by the TURTLE and DECAY TURTLE Application Modules to specify apertures slits at specific locations in the model The Aperture Piece implements the TURTLE SLIT element Type Code 6 and supports three different aperture types Circular Rectangular and Elliptical The Aperture Type pop up at the top of the Piece Window is used to select between these options Different parameters are activated in the Aperture Piece Window depending on the Aperture Type that is selected Parameters for each aperture are described separately However support for circular and
21. for the TURTLE or DECAY TURTLE Application Module Tab Panels Provide Access to Additional Global Parameters used by TURTLE and DECAY TURTLE PA PBO Lab Example B Pion After Fit pbol File Edit viewW Tommands Tools Tutorial TURTLE OS Diea om Bl x L ia Globals Tracing treckng ZO Foor Coordinates DECA Y TURTLE i s ame fates oi fi S i ac Green Dots Indicate which TRACE 3 D i v 2 S da 13300000 Mey nn Parameters are Native Inputs for 0 0010 1 00e 010 4 Beam Energy 24893104 Mev Beam Current o co0000 gt mAmp Frequency e0 000000 MHz Maximum Step Size ooroo m ore prer i 0 SE v Mla eri PA 101 4 a6 eam SPEC Marker Aperture Marker inal m the Current Application Context 0 0000 1 00e 007 4 3 0000 3 00e 004 4 0 0020 10 0000 4 S KYBeam decay DRFT QD 1 DRFT DRFT QD 2 DRFT DRFT QD 3 DRFT DRFT QD 4 DRFT DRFT HF D xSect zero newap xSect zero FINAL RBend Figure 5 TURTLE Application Context and Global Parameters The Application Context pop up in the Button Bar of the Document Window Figure 5 contains selections for all of the installed Application Modules The Application Context does not have to be set to a particular Application The selected Application Context is in order to execute menu commands However the used to activate application specific A
22. of Calculation for TURTLE 1s specified in the Calculation Order tab panel in the TURTLE Options Window shown in Figure 38 Similarly The Order of Calculation for DECAY TURTLE 1s specified in the Calculation Order tab panel in the DECAY TURTLE Options Window The Calculation Order represents the order of the expansion about the reference trajectory in each element The default setting for a new untitled PBO Lab Document 1s first order When second order is selected second order geometric and magnetic field effects are taken into consideration 67 The Order of Calculation set ting is saved with the beamline model in the Document Window using the Save or Save As commands DECAY TURTLE does not support a complete treatment of third order opticsfor decay products secondary particles The Aperture setting is saved with the beamline model in the Document Window using the Save or Save As commands in the File M enu PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Second order calculations are necessary to cause second order geometric transfer matrix elements or second order field variations in a bending magnet to have an effect Similarly second order 1s also required for the magnetic field of a sextupole to have an effect One differences to note with respect to the calculation order in TURTLE vs DECAY TURTLE 1s that DECAY TURTLE does not have a complete treatment of third order optics for decay produc
23. particle beam cross section at the exit of slits labeled new ap Most of the muons have been stopped by the 2 5mm horizontal slit aperture and are removed from the plot data Note the difference in scale as compared to the muon plot just prior to the slit i e following magnet HFQD Complete decay or loss of all particles of onetype dueto apertures or slits may result in tan alert indicating the lack of data for a requested plot Muon Daughterl decay particle beam cross section at the exit of slits labeled new ap Again most of the muons have been stopped by the 2 5mm horizontal slit aperture and are removed from the plot PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Iterative uses of the Write Input and Run DECAY TURTLE command creates a new initial distribution of particles for the simulation While the statistical properties of the initial distribution will be virtually identical 1 e the Semi Axis Beam Parameters the coordinates and momenta of the individual macro particles will be different This can result in noticeable differences in the Parent and decay product distributions downstream particularly if there are few particles available for a given plot Figures 50 and 51 show the muon and neutrino plots following the Aperture slit Piece new ap for a second execution of the Write Input and Run DECAY TURTLE command for the Example B Pion Decay pbol model
24. when a Quadrupole Piece is proceeded by a Special Piece with non zero Quadrupole Aperture Parameters in the Turtle tab panel If the Observe Apertures Option is set to None then the quadrupole aperture settings will not be observed and any apertures specified with Special Pieces will also be ignored The Observe Apertures Option does not apply to Aperture Pieces Slit elements in the beamline model The Special Piece is used to specify the particle names and charges for the primary and secondary particles in DECAY TURTLE The primary and secondary particles must be named in order to specify the Charge Parameters in the Special Piece Window and to specify plots for the different particle types in the Plot Specification Window On the left of each of the Charge Parameters in the Special Piece Window there are Special Parameter Settings buttons S buttons which provides access to Special Parameter Settings Windows that are used to name the particles PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Particle Names and Charge Parameters In order for DECAY TURTLE to calculate the decay of a primary particle into secondary particles the names and charges for the primary and secondary particles must be specified in the Turtle tab panel of the Special Piece Window The last three parameters in the Turtle tab panel are used exclusively by DECAY TURTLE to specify particle names and charges for pr
25. when there are plot specifications in the beamline model The TURTLE and DECAY TURTLE I O files are overwritten on each execution of the Write Input and Run or Run Input File Commands PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules This page is intentionally blank 50 PBO Lab 2 0 Plot Specifications User Manual Supplement TURTLE amp DECAY TURTLE Application Modules 51 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules 6 Plot Specifications Output from TURTLE and DECAY TURTLE must be explicitly requested at specific locations in the beamline model Marker and Final Pieces are inserted in the beamline to specify the locations for collecting ray trace One Dimensional Projection Plots data Any of the six beam parameters x x y y z 1 and Bar Graphs and Two Dimensional Correlation Plots Scatter Plots are Z DelP P may be selected for plotting Figure 28 a pan illustrates opening Marker Piece Windows to access Plot Window Specifications for TURTLE and DECAY TURTLE As many as s x different plots may be requested for each locat on Marker or Final Piece n the beamline for a max mum of one hundred Plot Specifications over the entire beamline PBO Lab Example B Pion Decay pbol File Edit View Commands Tools Tutorial ans Bel Dega Koll ana cd Globals Tracingrtrackng en Coordinates Particle Charge ho e 1 93 Particle Mass 1
26. 001000 234 0 000000 Tol 0 001000 gt 11 4 332400 Tol 0 061000 gt 33 6 929400 Tol 0 001000 TA 0 550000 Tol 0 001000 Frequency 50 000000 Maximum Step Size oot 0000 1 U IH 0 s 1 s Beam Sigma Matrix Turtle Scatter Y VE X Decay Turle Scatter Y ws N Trace3D Final Element in Profile Plot at this location in heamliny The Open Diagnos tics Button provides access to the Plot Specifications Window for the Store gt gt gt selected Application Context Trace3D Final Ellipse Plots at this location in beamline M th inserted at desired locations in Diagnostic data generated by u TURTLE or DECAY TURTLE ys commen Transport x MBEAM a J Transport v BEAM arker and Final Pieces may be e beamline to specify Scatter Plots and Bar Graphs from Constraints and Stored Parameters pen Rem are not supported by the TURTLE and DECAY TURTLE programs NAL Figure 17 Marker and Final Pieces are used to specify diagnostic plots at specific locations in the beamline model 32 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules The Final Marker Piece is simply a Marker Piece that by convention 1s used at the end of the beamline model but may be used anywhere in the beamline The Marker Piece Window includes an Application Context pop up that 1s used to access application specific Cons
27. 09 TO 008 I E 12 ILLL 11 I 13 006 TO 007 I 120915 21244 1 I 22 6 rt TO 005 I 15 2246438 41132 I 46 108 TO 009 I 11 2 141 3322634222 2 I 41 009 TO 004 I 152164835323539327214 1 I 68 7004 TO 005 I 112323434466124221323 I 59 00S TO 002 I 2122255235435 OSCE OO Lok I 71 gt DOE LO OUT 213446154413723342 1 I 60 UBI TO s000 I 2 1254452551A32412212 I 63 2000 TO 00T I Las 412422839235515 53 2 I 6 001 TO 002 E 1 1121475444227454224212 T TA 002 TO 20035 I 1134 64764225313443311 1 I 69 003 TO 004 I 1 33 1503413635102 12311 2 I 62 004 TO 005 I 2221433521542543145123 1 I 65 005 TO 00 I 2252 2356454631 2 1 I 53 006 TO OO I 23 231264 223443311 I 46 007 TO 008 I 12112 2121228 Ii I K 2006 TO 00 I 2111236123 1232 1 I 22 009 TO 020 I 2112 21121 I 13 s010 TO HS n nn i 7 4 1 I 1 OLL TO Jla I ho od I 3 012 TO O1 I I U 013 TO 014 I I U IA AR AR RR AR AR RR RR AR AR RAT I I I I I I I 112259754 775651 7543421 I TOTALS I 00000000000015474974236763892218408640000000000000 I 1000 TOTAL NUMBER OF ENTRIES 1000 INCLUDING UNDERFLOW AND OVERFLOW AS FOLLOWS LEFT RIGHI ABOVE U U U U 1000 0 BELOW U U U SUM OF SQUARES 2210 CENTER OO RMS HALF WIDTH 002 CENTER 2000 RMS HALF WIDTH 0 CORRELATION OLU Figure 34 Example of Output from TURTLE x x Phase Space 60 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules HISTOGRAM NO 2 HORIZONTAL AXIS Y IN M e207 M FROM THE START
28. 18 0 179346E 02 0 936698E 03 0 207286E 02 0 759823E 03 0 96779SE 02 0 679205E 02 14 0 158190F 02 0 274217E 02 O 238422E 02 O 516727E 02 O 245136E 02 0 304003E 02 15 0 269760E 03 O 900073E 02 0 160784E 02 0O 179149E 02 0 194919F 02 0O 464095E 02 18 O 14760S5E 02 0 567797E 02 0 598089E 02 O 205354E 02 0 302156E 02 O 211311E 02 14 O0 269094E 02 0 30808SE 02 0 224497E 03 O0 239045E 02 0 558118E 02 0 378497E 02 18 0 104786E 02 O 446321E 02 O0 215476E 02 0O 435416E 02 O 707706E 02 0O 176065E 02 18 0 177770E 02 0 225505E 03 0 560651E 04 0 190216E 02 0 868S37E 02 0 265256E 02 14 0 210160EF 02 0 49698SE 02 0 413441E 03 0 162785E 02 O0 82798SkE 02 0 619526E 02 15 0 225440E 02 1 653109E 02 0 1346 79E 02 0 111135E D U 603050E 02 0 252486E 0 2 Figure 25 PBO Lab Text Edit Windows for TURTLE TO Files 44 PBO Lab 2 0 Menu Commands User Manual Supplement TURTLE amp DECAY TURTLE Application Modules PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules 5 Menu Commands Application specific commands are accessed from sub menus in the PBO Lab Commands Menu and View Menu at the top of the Document Window Both the Commands Menu and the View Menu will contain application specific sub menus for any installed PBO Lab Application Modules This Chapter includes an outline of menu commands for the TURTLE and DECAY TUR
29. 1s a special PBO Lab Piece that s used to specify application specific Constraints Diagnostics and Stored Parameters at specific locations in the beamline rker and Final Pieces may be model The TURTLE and DECAY TURTLE Application Modules support the collection of Diagnostic data using Marker Pieces in the beamline model Constraints and Stored Parameters are not supported by TURTLE or DECAY TURTLE Diagnostic data s used by PBO Lab to generate Scatter Plots and Bar Graphs for TURTLE and DECAY TURTLE cted for Scatter Plots and Bar In order to specify a plot at a particular point in the Piece that by convention is beamline model insert a Marker Piece or Final Piece at used at the end of the beamline the desired location in the beamline and double click the model in the b File PA PBO Lab Example B Pion After Fit pbol but may be used anywhere Marker Piece icon to open the Piece Window as illustrated eamline in Figure 17 The Application Context can be Edit View Commands Tools Tutorial Selected in the Document Window ISESE or in the Piece Window Globals Tracingfiracking Floor Coogcinates Particle Charge b CE Particle Mass 133500000 Beam Energy 24693104 Beam Current o co0000 gt Nan Double Click a Marker Piece or Final Piece in the Beamline Model to Open the Piece Window PREF 1 0 ZIL wW FI gt 12 0 000000 Tol 0
30. 2 D Correlation Plot for that location in the beamline See Marker Piece Section in this Chapter The Beam Piece can be used to specify the initial distribution in two different ways referred to as the Semi Axes representation and the Twiss parameter or Courant Snyder representation Both the Semi Axes and Twiss parameters are shown in Figure 9 The Beam Parameters pop up near the top of the window Figure 8 is used to toggle between these two parameter representations 19 Parameter Tab Panels The parameters on the Centroid tab panel of the Beam Piece are not used by TURTLE or by DECAY TURTLE Phase Space Plots The Beam Piece Windows include phase space ellipse plots for the current Beam Parameters Particle Distribution Type TURTLE generates an initial particle distribution based on the specified Beam Parameters and the Particle Distribution Type pop up The Number of Macro Particles Global Parameter is used to specify the number of particles Beam Parameter Representations The native beam inputs for TURTLE can be generated from either the Semi Axes or Twiss Beam Piece parameters PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Open the Correlations Matrix Window with gg Compute Semi Axes Parameters from Twiss Parameters Semi Axes Parameters Selected EB or Compute Twiss Parameters from Semi Axes Element Control ha gne 7 Particle Distribution Type 4D Equivalent Uniform
31. 39800000 Mey 05110 2 228005 amp Beam Energy esse Mev o 0 0010 1 006010 Beam Current foo Imam x 0o00 1 00e 007 Frequency laman M lt 3 0000 3 00e 004 Maximum Step Size fomo In x 0 0020 10 0000 5 lt SE lma LA Ea Hy 90 2 E S a 5 Z 2 a E 2 zZ Beam Te BS oc ES nn oo Te 4 4 Insert Marker or Final Pieces in the beamline model to specify locations for collecting plot data 4 4 4 NEUTRINO MUON MEUTRING PON Cy A Pa Location Marker x EPI arker Energy TURTLE 7 Energy pecav TurTLE lt m Constraints zi N liii Select a particle from the E Named Particles popup ro nI x x lt for each DECAY TURTLE A Plot Specification Stor M Plot Selection 1 D Projection Plot I 2 D Correlation Plot Projection Axis Bin Size Units Axis Range Set Vertical cm N 20 000000 550 00000 550 000000 E Horizontal x B 20 000000 cm 550 00000 550 000000 a T Auto Scale Plots e m Plot Selection 1 D Projection Plot 2 D Correlation Plot Projection Axis Bin Size Units Axis Range Set Comments Vertical cm z v B 9 940000 1 070000 i 070000 Delete xSect Horizontal fx lt 9 040000 cm E 070000 i 070000 T Auto Scale Plots Tro Ae Sue tow Uw ho Ae Sue Low Umm Pa Ass Sze tow Um Pro axe Sue tow um 10
32. 4 CENTER 000 RMS HALF WIDTH 20038 CORRELATION 0444 Figure 35 Example of Output from TURTLE y y Phase Space 61 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Plot List Window The TURTLE Plot List item in the TURTLE Commands Menu 1s used to open the TURTLE Plot List Window as The Plot List Windows provide quick illustrated in Figure 36 below Similarly the DECAY access to al Or tne Pot apecuications TURTLE Plot List item in the DECAY TURTLE a bii ske j He fora Commands Menu is used to open the DECAY TURTLE pa M Plot List Window If no plots have been specified in the beamline model for TURTLE or DECAY TURTLE then there will be no entries in the respective Plot List Windows Commands TRANSPORT TURTLE MAR YLIE TRACE 3 2 Write Input and Run TURTLE l Im Bo r F Write Input and View View Turtle Input File Bun Turtle Input File Display and Access Plot Specifications for the Entire Beamline Compute All AutoCalcs Options EA Turtle Plot List Label Proj Axis Size Low Upg Fraj Axis Size Lowy para ver R sooo oaa es x 00 som sa Double Clicking an Entry in the 2 D Correlation Plots Scatter Plots have Plot List Window will Open the both Vertical and Horizontal Components Associated Marker or Final Piece 77 1 D Projection Plots Bar Graphs have a Window for that Plot aan Vertical Component only
33. 5 397 5 000000 0 000000 900000 5 000000 2 155 8397 551 67083 000000 9 0000 00000 00000 3 5 000000 9900000 34 734049 157 21196 5 000000 5 0000 4 5 000000 9900000 15721196 215 21099 500000 900000 5 000000 2 000000 2 000000 2 000000 13124451 1454659 ooo 9900000 9000000 ooo 14 64859 111 54035 Figure 10 Correlation Matrix Window 21 The Compute From button is in the Button Bar at the top of the Beam Piece window and is used to compute Twiss parameters from the Semi Axes parameters or to compute Semi Axes parameters from the Twiss parameters Correlation Matrix Correlations may be included in the beam description when the Semi A xes Beam Parameters representation is used The Beam Correlations Matrix window is opened with the Correlations button in the Button Bar of the Beam Piece window Correlations may be entered as off diagonal elements of the sigma matrix or by entering values for the reduced sigma matrix PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules The Tutorial button in the Button Bar at the top of the Beam Piece Window opens the PBO Lab Tutorial for the Beam Piece and leads to the Hypertext Window shown in The Beam Piece Tutorial provides a Figure 11 The Beam Piece Tutorial provides a variety of variety of useful information on useful information including descriptions of the beam modeling Beams in T
34. 6124221323 2122253354353384551311 213446154413723342 1 2 1254452551A32412212 132 41242289233515 53 2 1 1121475444227454224212 1134 64764225313443311 1 1 33 75341583162 12311 2 2221433521542543145123 1 2252 2356454631 2 1 23 231264 223443311 12112 2121328 1131 21113613 14323 1 2112 21121 La 41 HHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHBHH 112255754775657543421 I TOTALS I 00000000000015474974236763892218408640000000000000 I 1000 1000 INCLUDING UNDERFLOW AND OVERFLOW AS FOLLOWS 0 1000 0 SUM OF SQUARES 3910 CENTER 000 RMS HALF WIDIH CENTER 000 RMS HALF WIDIH CORRELATION 0103 Figure 2 Executing the TURTLE Application Module The native TurtleOutput file is automatically displayed in a scrollable Text Edit Window following the execution of TURTLE The content of the Output file w ll depend on the Plot Specifications and Options set by the user Use the Save As command in the File Menu of the Text Edit Window to rename the output file f desired The TurtleInput file TurtleOutput file and Turtle PlotData file will be overwritten on any subsequent execution of the TURTLE Application Module PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Running DECAY TURTLE Running DECAY TURTLE is the same as described for SE V nn SR E the TURTLE Application Module However DECAY E NE K TURTLE is executed from the DECAY TURTLE Commands menu shown in Figure 3 T
35. 70000 Herz x 040000 3 070000 4 070000 RRR 1 100000 1 100000 Horz x T 0 0000 1100000 100000 Mii iii vet SEN ELTDEITTIET TUN x EE 00000 Figure 28 Requesting plots at specific locations in the beamline 53 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules A Marker or Final Piece can be inserted anywhere in the beamline model to specify a location for collecting diagnostic data The Marker Piece Section in the Beamline BE Elements Chapter describes using the Marker and Final Refer to the Marker Piece Section in gt the Beamline Elements Chapter for a Pieces to define location specific Diagnostics for description of using the Marker and TURTLE and DECAY TURTLE Final Pieces to define location specific Diagnostics When the Application Context is set for TURTLE in the Marker Piece Window the Open Button in the Diagnostics panel will open the TURTLE Plot Speci fication Window as illustrated in Figure 29 Likewise the DECAY TURTLE Application Context is used to open the DECAY EH Big Location Marker Ww Energy TURTLE Constrat The Application Context can be set in the Document Window or in the Marker Piece Window Reni Remove SEI le Diagnostics for Any Installed Diagnostics Application Module are gt artle Scatter Y ve X Displayed in the Marker and A oscay uti scatter
36. BO Lab 2 0 DECAY TURTLE Example User Manual Supplement TURTLE amp DECAY TURTLE Application Modules PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules 8 DECAY TURTLE Example Example B Pion Decay pbol The Example B Pion Decay pbol file included n the DECAY TURTLE folder in the installed PBO Lab folder illustrates several features of the DECAY TURTLE Application Module Figure 41 shows the Document Window and Beamline Global Parameters for this example The magnet lattice 1s identical to that found in the Example B Mod After Fit pbol model file in the main Examples folder However the Particle Mass Global Parameter corresponds to that of a pion and the Beam Energy Global Parameter has been set so that the beam momentum will be the same as the Example B Mod After Fit pbol model PBO Lab Example B Pion Decay pbol S E File Edit View Commands Tools Tutorial Ire HIS IST Kol 99 x sE Globals Tracingftracking Floor Coordinates ap ae S Particle Charge 1 e 1 93 amp am Particle Mass 139 600000 Mev 0 5110 2 22e 005 Beam Energy 246931 04 Me 0 0010 1 00e 010 Beam Current 0 000000 mAmp 0 0000 1 00e 007 Frequency s0 000000 MHz 3 0000 3 00e 004 il 4 4 0 0020 10 0000 Maximum Step Size 0 010000 m 4 AI OA SPEC Marker Aperture Marker pam decay DRFT QD 1 DRFT DRFT QD 2 DRFT DRFT QD 3 DRFT DRFT QD 4 DRFT DRFT HF aD
37. Beamline Global particle are specified in the Tracing Tracking tab panel OF are a dje Document the Beamline Global Parameters Refer to the Beamline window Global Parameters Section in this Supplement for a description of these parameters 21 Special Pieces must precede any element s to which they apply Once a Special Parameter hasbeen defined fora location in the beamline model it will apply to all succeeding elements that are the appropriate type unless reset to a new value PBO Lab will only use Special Parameters that have been defined by a Symbolic Parameter Name in the parameters Special Parameter Settings Window Note that the Fringe Field Factor K2 FINT2 is no longer used but is included for compatibility with older versions Refer to the TURTLE Documentation for a description of individual special parameters Special Pieces on Work Space are ignored when generating special instructions SPEC cards PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Additional Special Parameters The Special Piece provides additional parameters for the definition of location specific inputs that can be used to change System parameters Fringe Field parameters and Expansion parameters Table 2 list the Special Parameters and the corresponding TURTLE and DECAY TURTLE keywords Table 2 Special Piece Parameters and Keywords LENGTH Special Piece Parameter System Parameters System Length
38. E Write Input and Vie View Turtle Input File Bun Turtle Input File The first TURTLE Command Prepares a Turtle Input file for the Beamline in the Model Compute All AutoCalcs Space and then Executes the TURTLE Program Turtle Plot List a Options 4 TurtleDutput File Edit Fort HISTOGRAM NO 1 Turtle VO files are ovate ritten on each HORIZONTAL AXIS x INM 959 M FROM THE START execution of the Write Input and Run De Cone Con en TOTALS I rt kkk KA kk kak kk kk kak x I Turtle or the Write Input and View Commands Figure 2 is an example of the TurtleOutput file displayed when execution is complete The content of the native TurtleOutput file will depend on various Plot Specifications and Options set by the user 014 TO 01 3 TO 012 TO 2011 TO 010 TO 009 TO 008 TO 007 TO 006 TO 005 TO 004 TO 003 TO 002 TO 001 TO 000 TO 001 TO 002 TO 003 TO 004 TO 005 TO 006 TO 007 TO 008 TO 009 TO 010 TO 011 TO 012 TO 013 TO TOTAL NUMBER OF ENTRIES LE 013 I sU 011 I O10 009 I 008 I 007 I 006 I 005 I 004 I 003 I 002 I 001 I 000 I 001 I 002 I 003 I 004 I 005 I 006 I 007 I 008 I 009 I 010 I 011 I 012 I ABOVE BELOW 11 12 11 1 41 132 1121 1 213 12 1111 11 123515 3123 41 1 15 2246438 41132 11 2 141 3322634222 2 1321648332339327214 1 11232343446
39. KY Beam Parameters Semi Axes v Parameters Value Units LF orizontal x sje Beam Extent x 0 672428 m sjHat Beam Divergence x 29 1 83400 mrad Emittance x x 60 000078 pi mm mrad Y Vertical y sjHat Beam Extent y 0 589356 cm sjHat Beam Divergence y 28 551 900 ULF s Emittance y y 59 999813 pi mm mrad Y Longitudinal z s Har Beam Extent z 1 145620 cm SI Momentum Spread z 1 056600 Percent lt Emittance z z Comments 4 L A Initial Beam a fe MBP BS LHA RBO MOY IGD PA Vaan Hn A Tutorial Comp From Axis Je MUSCAT FIUS STIL TILI TLIE Z O x y mm 350201 Transverse and Longitudinal xy Phase Space Ellipse Plots are ans mrad SV Provided for Beam Parameters 0 0 0 0000 10 0000 ZN 0 0000 1 00e 004 35 0201 0 0000 100 0000 8 0691 0 0 8 0691 Green Dots Indicate which Parameters will be used to zimmi Generate the Native Inputs for 0 0000 1 00e 004 amp SELE TLE and DECAY Pz 0 0000 100 0000 0 0000 10 0000 amp z mrad 00000 10 0000 amp 0 0 Auto Scale Phase Space 0 0000 100000 6 Ellipse Plots or Set the Plot Scales Directly E KYBeam Conrant Snyder L Tuanss im Conrant Strder Twiss Select between Semi Axes or Courant Snyder Twiss Beam Parameter Representations The Tutorial Button Opens the Beam Piece Tutorial window which Provides a Variety o
40. Laboratory This material was prepared as part of work sponsored by the United States Department of Energy The Department of Energy Universities Research Association Inc and their agents and employees make no warranty express or implied and assume no legal liability or responsibility Tor the accuracy completeness or usefulness of any information apparatus product or process disclosed nor represent that ts use would not infringe privately owned rights TURTLE Trace Unlimited Rays Through Lumped Elements 1s a FORTRAN program maintained and distributed by the Fermi National Accelerator Laboratory DECAY TURTLE is also a FORTRAN maintained and distributed by the Fermi National Accelerator Laboratory Both TURTLE and DECAY TURTLE are distributed with the PBO Lab software with the written permission of Fermi National Accelerator Laboratory Running either the TURTLE or DECAY TURTLE programs 1s accomplished directly from the PBO Lab interface each code 1s fully integrated with the graphic user interface The PBO Lab 2 0 Particle Beam Optics Laboratory User Manual describes the PBO Lab user interface Two separate PBO Lab Application Modules are available for TURTLE and DECAY TURTLE repectively This Supplement discusses the PBO Lab commands and options for both the TURTLE and DECAY TURTLE Application Modules Refer to the TURTLE User Manual distributed with this supplement for a description of the TURTLE program PBO Lab 2 0 Us
41. O 474681EF 02 O 2466831E 02 18 0 301774E 02 0 11996S5E 02 O 332604E 02 0 450146E 03 0 810620E 02 0 641347E 03 14 0 167285E 02 0 197038F 03 0 190647E 02 O 3776S50E 02 0 850014E 02 0 807363E 03 15 0O 447817E 03 0 878459E 02 0 133432E 02 0 131620E 02 0 636819E 03 O 617754E 02 18 0 278219E 02 O 366496E 02 O 318074E 02 0 882730E 03 0 224000E 02 0 566318E 02 18 O0 173420E 02 0 350812E 02 0 703543E 03 O0 945082E 04 0 93353494E 02 O 727962E 02 15 U 160666E 02 O 105312E 02 O 924195F 03 O 108683E 02 0 942146E 02 O 782565E 02 18 0 204544E 02 0 434345E 02 O 287337E 02 0 327210E 02 O 379739E 02 0 395713E 02 14 0 286153E 03 0 671394E 03 0 545131E 03 0 585025E 03 O 370886E 02 0 822577E 02 15 0 596633E 03 O 7685172E 03 O0 567416F O2 O0 144366E 02 O 2632271E 02 O 800990F 02 18 O 938061F 03 O 101471E 01 O 227011E 02 0 121458E 02 0 347912E 02 O 344892E 02 14 0 630290E 03 0 228493E 02 0 499463E 02 0 163653E 02 0 586052E 02 0 403405E 02 18 0 107340E 0D 0 606284E 02 0 453030E 02 0 137188E 02 0 653013E 0 0 496429E 02 18 O0 113204EF 02 0 354056E 02 O 136698F 02 O0 6408682E 03 O 583189F 02 0 592340E 02 14 0 582388E 03 0 103690E 02 0 179273E 02 0 147618E 02 0 674465E 02 0 963722E 02 14 0 246453F 07 0 44971 F 0 0 25988SE 02 0 413578FE 02 0 154722E 0D 0 329973E 02 18 O0 105551F d2 O0 575252E 02 O0 840029F 03 O 507631E 02 O 430502EF 02 O 241240E 03
42. PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules PBO Lab 2 0 Particle Beam Optics Laboratory User Manual Supplement TURTLE amp DECAY TURTLE Application Modules Distributed by AccelSoft Inc P O Box 2813 Del Mar CA 92014 USA 858 677 0133 accelsoft ghga com www ghga com accelsoft PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules PBO Lab 2 0 User Manual Supplement TURTLE and DECAY TURTLE Application Modules 2000 by G H Gillespie Associates Inc All Rights Reserved ISBN 1 892267 05 5 All rights reserved No part of this book may be reproduced in any form or by any means without permission from the publisher Printed in the United States of America Published by AccelSoft Inc San Diego California PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules TURTLE User Manual as used in this PBO Lab 2 0 User Manual Supplement refers to TURTLE with MAD Input Trace Unlimited Rays Through Lumped Elements A Computer Program for Simulating Charged Particle Beam Transport Systems and DECAY TURTLE Including Decay Calculations by D C Carey K L Brown and Ch Iselin September 1999 Fermi National Accelerator Laboratory report number Fermilab Pbu 99 232 Stanford Linear Accelerator Center report number SLAC R 544 Reproduced for distribution with PBO Lab by permission DISCLAIMER NOTICE TURTLE Fermi National Accelerator
43. Piece Window and Special Parameter Settings Window for the Reference Trajectory Momentum parameter Note that there is no tab panel for TURTLE or for DECAY TURTLE in the Special Parameter Settings Window for the Momentum parameter However a Symbolic Parameter Name must be specified in the Special Parameter Settings Window in order for the SPEC card to be included in the native TURTLE or DECAY TURTLE input Special Energy Fringes Expansions System Parameters Value Units Limits System Length LENGTH 9 000000 Im IMF IMF s eterence Traj Mom F 0 061285 GGV IG 0 0000 1 00e 007 Marield Ref Mom PREF n oonooo Gewe 0 0000 1 00e 007 Particle Na Special Parameter Settings Reference Trajectory Momentum Special Pieces effect all succeeding elements of the appropriate type An exception is made for particle names and charges which apply to the entire beamline model Moving a Special Piece from the Model Space to the Work Space will also disable any Special Parameters defined by that piece Transport f Reference Trajectory Momentum 0 061295 ST to Fr SPEC Reference Trajectory Momentum ss 4 Comments Symbolic Parameter Mame momentum lt lt SPEC defined by a Symbolic Parameter Name in the Special Parameter Settings Window that is accessed using the parameter s S Button Special Parameters must be Fitting Variable m
44. Specifications and will generate bar graphs and scatter plots for the same data shown in the native text output file Figure 33 shows an example of the scatter plots created by PBO Lab 58 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules Turtle Plot Window Print Copy P EAA E aki SetScale 0 01 4400 E s Shift Zlick for Position SE US 0 0072 Pen Width E b LEGEND 0 0000 x radij ve x m 0 0072 0 01 4400 0 010700 0 0054 0 0000 0 005 XY frad vs X m 0 01 4400 Shift Click for Position x y Fen Width I r LEGEND 0 0072 0 0000 Y grad ve Y m 0 0072 0 01 4400 0 010700 0 0054 0 0000 0 0054 0 010700 Y rad ve Y m Figure 33 PBO Lab Scatter Plots of x x and y y Phase Space Refer to the Graph Plot Windows Section in this Chapter for a description of features supported by PBO Lab Graph Plot Windows Additional information may also be found in the main PBO Lab User Manual in the Plot Tools Section of the PBO Lab Analysis Tools Chapter 59 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules HISTOGRAM NO 1 HORIZONTAL AXIS xX IN M 1252 M FROM THE START VERTICAL AXIS X IN R Sa M FROM THE START mono UUE mel UU 406 010 TOTALS IA AR AR RR AR AR RR RR AR AR RAT 014 TO 01351 I U Pl TO UlZ i I U 12 TO 6 5 I I I 0 01 TO 0 I tr 12 1 I 1 010 TO 00 I 1 41 132 1121 1 I 18 0
45. TLE Application Modules as well as references to other Chapters in this Supplement that provide more detailed descriptions of specific menu commands The menu commands for TURTLE and DECAY TURTLE are identical and are described here with respect to TURTLE but also apply to the DECAY TURTLE command menus Commands Menu The PBO Lab Commands menu contains sub menus for any installed PBO Lab Application Modules The sub menus for the TURTLE and DECAY TURTLE Application Modules contain several commands for specifying output and executing the programs The Commands Menu 1s divided into four sections as illustrated in Figure 26 below Commands TRANSPORT hk TURTLE Write Input and Run TURTLE DE_AY TURTLE K Write Inout and vi TRACE 30 p NIG OFCE Lnpu IE Run Turtle Input File Compute All 4utocalcs se TURTLE Options Turtle Flot List Options A 7 ow Commands for TURTLE and DECAY TURTLE are accessed from sub menus in the PBO Lab Commands M enu and View Menu at the top of the Document Window The sub menu for the TURTLE Application Module has several commandsfor specifying output and executing the TURTLE program Primary command for generating native input and executing TURTLE editing and executing th Commands for directly e native TURTLE input Display and access Plot Specifications for entire beamline Figure 26 PBO Lab TURTLE Commands Menu 47
46. The Turtlelnput file may be edited and saved by the user TURTLE will read and execute the edited file errors and all when the Run Turtlelnput File command is selected PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules The DECAY TURTLE Commands Menu 1s identical to the TURTLE Commands Menu shown in Figure 26 The first item in the TURTLE Commands menu 1s the primary command for generating input and executing TURTLE The second group of commands 1s for separately generating input and running TURTLE The last two commands are used to access TURTLE Plot Specifications and Options The Write Input amp Run TURTLE command writes a TurtleInput file for the model defined in the Model Space of the Document Window and then executes the TURTLE program which reads that input file and executes the commands written as a MAD Methodical Accelerator Design formatted input file Figure 2 illustrates an example of using this command The second section of the TURTLE Commands menu contains three items to assist the user in directly editing the TurtleInput file These commands are useful for implementing TURTLE parameters or instructions that might not be directly supported in the PBO Lab user interface Changes made to the Turtlelnput file are not retained in the PBO Lab model data and the TurtleInput file w ll be over written w th subsequent Write Input amp Run commands The third section of the TURTLE Commands menu c
47. URTLE and Sigma matrix Semi Axes and Twiss parameter Beam Tutorial DECAY TURTLE representations phase space projections the beam centroid and several other related topics Ba Initial Beam B Hemert Particle Distribution Type Ts Equivalent Unifo o 2 x y mm Beam Parameters Semi Axes IN 35 0201 K y Parameters Value Units Limits mrad NZ Horizontal x din 0 0 STZ Hatt Beam Extent x ogra fom 0 0000 NS 10 0000 FX sjHat Beam Divergence x 29 1 83400 mad 0 0000 1 0064004 35 0201 pi mm mrad 0 0000 100 0000 8 0691 00 faoa Vertical y Hal Beam Extent y 0 589356 lem 0 0000 100000 EKIPE VN EI Hal Beam Divergence y 28 551900 lad v 0 0000 1 00E 004 Emittance CP LCA Lab Tutorial P sa File Edit Navigate Help N Trajectory at st 2 0 Describing a Beam ML S an Mom Accelerator beams are composed of particles Real beams are co gt Trajectory Emittance typically many more particles than are possible to incorporate into E E approximation must be used to describe a beam for a computer t BEAMO have been developed to model beams including a number of appr studies The Beam Tutorial discusses several commonly used app Red is used to refer to the x horizontal direction amp Blue is used to refer to the y vertical direction beams and outlines some of the characteristics of these approxim h o getic ne l ng msgr Green is used to refe
48. Y vs A une Open B Za Pinal Piece Windows Decay Turtle Scatter Y ve A is used to access the Plot a ala Specification Windows S T 72 Remove E T DZ Specify Bin Size for Specify the Upper and Bar Graphs Lower Range for Vertical 1 D Projection Plot d Hori tal A Select Between 1 D Projection Tojeeuon 210 2 and Horizontal Axes Zs Plots Bar Graphs and 2 D FA Turtle Plot Specification Correlation Plots Scatter Plots s Plat Selection 1 D Projection Plot f 2 0 Correlation Plot 4 Projection Axis Bin Size Units Axis Range The Vertical Projection Axis popup is used to specify the Vertical fie mrad 14 400000 14 400000 p Vertical Component for Horizontal x 2 040000 em 4 070000 1 070000 s both 1 D and 2 D Plots Use the Horizontal Projection Axis popup to specify the vert Y 1 000000 jA 4 400000 14 4000001 Horz Y 0 040000 1 070000 1 070000 Sra anean S III RE R III R GHR 2 D Plots L Select Auto Scale Plots to Select Existing Plot Specifications Allow PBO Lab to Calculate with the Mouse to Edit or Delete Axis Range Values that Fit Data Figure 29 TURTLE Plot Specifications Window 54 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules After making selections for Projection Axes Bin Size and Range values the Set button s used to accept the Plot Specification The list at the bottom of the Plot Specification window displays
49. a penege DA Eaa Cony tom Find 4 D Equivalent Uruform EV Gaussian 5 51gma 0 5110 2328005 Tutorial Correlatio DE Comp From Twiss AutoScale Plots Set Plot Scales Maximum Step Size Particle Distribution Type Element Cet and Current 4 D Equivalent Uniform KY lt x y mm Beam Parameters Semi Axes 35 000000 E Parameters Value Units Limits Double Click the Beam Piece Icon in the Beamline to Open the Beam Piece Window Horizontal x Emittance x x 60 00007 pi mm mrad lt 0 0000 100 0000 Vertical G sjhat Beam Extent y 0589358 cm 0 0000 10 0000 amp se Beam Divergence y 28 551900 mrad s 0 0000 1 00e 004 Emittance Y Y ter z sjHar Beam Extent z 1 145620 cm X 0 0000 10 0000 amp Sinan Momentum Spread z 1 056600 2 Percent lt 0 0000 10 0000 amp Emittance z z Comments 4 D KY a SZ sjHar Beam Extent x 0572228 Te 672428 gt 20000 12000 S e Beam Divergence x 29 183400 a 0 0000 1 00e 004 amp 35 0000 8 0000 0 0 3 000000 pi mm mrad vw 0 0000 100 0000 pi mm mrad lt 0 0000 1000 0000 13 0000 0 0 13 000000 Figure 8 Opening the Initial Beam Piece Window 18 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules The Beam Piece Window has two tab panels for parameter input
50. all of the plot specifications for the associated location Marker or Final Piece This list s also displayed n the Diagnostics panel of the Marker or Final Piece Window Once a plot specification has been defined t can be removed by selecting t with the mouse in the list at the bottom of the window and pressing the Delete button Individual Plot Specifications can also be deleted directly from the Marker or Final Piece window by selecting the plot specification and pressing the Remove button Existing Plot Specifications can be edited in the Plot Specification window by selecting them in the list and then using the Set button after making any changes Plot Specifications that are selected with the mouse will be hilited in the list as shown in Figure 29 Figure 30 illustrates an example of PBO Lab Graph Plots Windows created for TURTLE Plot Specifications Turtle Plot Window Print Copy Gen Dyes auut vad setscale Em 0 032639 Ba Turtle Plot Window Print Copy Shaw ymha Yars vag SetScale te d 135 000000 0 0163 A gt ze Wa Ax E L L 101 2500 3 57e 005 67 5000 0 0163 33 7500 0 032568 0 006357 0 0032 3 13e 005 0 003 Y rad vs Y m 0 000000 0 01 0000 0 0050 0 0000 One Dimensional Projection Plots Bar Graphs and Two Dimensional Correlation Plots Scatter Plots like the ones shown in Figure 30 are defined in the Plot Specification window Bis x Shift Click for Position x
51. ations due to accumulation of second order effects A TURTLE or DECAY TURTLE option will be added to the Application Context pop up in PBO Lab Document Windows when the Application M odule is installed DECAY TURTLE includes the ability to track both the original Parent particles and two decay products Daughters for radioactive beams Professional Versions of both TURTLE and DECAY TURTLE for PBO Lab are available from AccelSoft PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules When the TURTLE Application Module is nstalled n PBO Lab a TURTLE option will be added to the Application Context pop up in PBO Lab Document Windows The Application Context s used to indicate native inputs and in some cases access application specific user interface windows TURTLE sub menus will also be placed in the View and Commands Menus DECAY TURTLE DECAY TURTLE 1s a FORTRAN code for simulating the propagat on of charged particles through an accelerator beamline or magnetic transport system It s similar to the TURTLE program in many respects but includes the additional ability to track both the original Parent particles and two decay products Daughters for radioactive beams When the DECAY TURTLE Application Module is installed in PBO Lab a DECAY TURTLE option will be added to the Application Context pop up in PBO Lab Document Windows DECAY TURTLE sub menus will also be placed in the View and Comma
52. ce du oon cued es eee oon eeaoedes 51 Named Particles in DECAY TURTLE 0 aaa 56 Plot Specification Parameters nnan anaana 57 Piot List WINdOW g sra gtgagiriraaaafoknabatrandenarahoassoena 62 Graph Plot Windows an en bassa kava Dann Eee 63 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Chapter and Subject Page 7 OPUON lt sagala reLja een ee ae ner bena ood ae ee Se 65 Calculation Order En REEL EEE RER 67 Observe Apertures Option 0 0 0 ce eee ees 68 8 DECAY TURTLE Example Example B Pion Decay pbol 71 9 Appendix TURTLE User Manual ka 24500001 AREA ok kk dsavakaku 83 TURTLE with MAD Input Trace Unlimited Rays Through Lumped Elements A Computer Program for Simulating Charged Particle Beam Transport Systems and DECAY TURTLE Including Decay Calculations Vi PBO Lab 2 0 Getting Started User Manual Supplement TURTLE amp DECAY TURTLE Application Modules PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules 1 Getting Started This Getting Started Section 1s intended as a quick start introduction for running the TURTLE and DECAY TURTLE Application Modules The remainder of this Supplement describes the PBO Lab user interface features that are specific to these two Application Modules Refer to the PBO Lab User Manual for more general information on the PBO Lab user interface The TURTLE Documentation
53. d Application Modules that support special settings for the particular parameter Special Parameter Settings for both TURTLE and DECAY TURTLE are only found on the Special Piece E The Symbolic Parameter Name for a Piece Parameter is application independent 1 e the same Parameter Name 1s used for specifying Special Parameter Settings for all installed Application Modules The Piece Comment Label and the 4 Special Parameter Settings Magnetic Field Gradient Piece Parameter name are displayed gt GD 4 Magnetic Field Gradient at the top of the S Window Symbolic Parameter Mame yanya Transport lt Magnetic Field Gradient 265 000000 kam The bottom portion of the Special Fitting Variable mna nn Parameter Settings Window contains Algebraic Expression varr z application specific tab panels for the different Application Modules that Import Parameter support special parameter settings for a particular parameter a g Figure 16 Special Parameter Settings Window g 30 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules Only Special Parameters that have been defined with a Symbolic Parameter Name in the parameters Special Parameter Settings Window are used to generate the native input for TURTLE or DECAY TURTLE If a Symbolic Parameter Name has not been assigned then a SPEC card will not be generated Special Parameters should be define
54. d with unique Symbolic Parameter Names particularly when the same Special Parameter is defined at different locations in the beamline model otherwise the last non unique Parameter Name and Value will be used for each Special Parameter defined by that Name Parameter Names should not be the same as Piece Labels Comment String in Piece Windows or unintended consequences may result Copying a Special Parameter Piece will also copy any Special Parameter Settings including Symbolic Parameter Names When a Special Piece is copied care should be taken to assign unique Symbolic Parameter Names All of the Special Parameter Settings for a PBO Lab beamline model are saved from the Document Window with the Save or Save As commands in the File Menu 31 PBO Lab will only use Special Parameters that have been defined by a Symbolic Parameter Name in the parameters Special Parameter Settings Window Special Parameter Names should be unique with respect to other Parameter Names and Piece Labels Copying Special Pieces will duplicate any Symbolic Parameter Names and may result in unintended consequences All Special Parameter Settings are saved with the beamline model document IheMa used to specify locations in the beamline where Diagnostic data isto be colle Graphs The Final Marker Piece is simply a M arker PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Marker Piece The Marker Piece
55. e is used to specify parameters for the entire beamline model in which case the Special Piece should be placed at the beginning of the beamline following Initial Beam Piece The Special Piece Window illustrated in Figure 13 has five tab panels for the different types of special parameters Each of these tab panels is described separately in this Section starting with the last tab panel which has parameters that are specific to both TURTLE and DECAY TURTLE Both TURTLE and DECAY TURTLE use the Quadrupole Aperture Parameters on the Turtle tab panel in the Special Piece Window In addition the Charge Parameters on the Turtle tab panel are used to define symbolic names for the primary and secondary particles for DECAY TURTLE and specify charges for these particles Although the Special Piece is generally used for location specific parameters settings the Particle Names and Charges apply to the entire beamline model regardless of the location of the Special Piece in the beamline Only one Special Piece should be used to specify particle names and charges However multiple Special Pieces may be used to define different Quadrupole Aperture parameters or other Special Parameters at various locations in the beamline model The remaining tab panels in the Special Piece Window are for changing System Parameters Fringe Field Parameters and Expansion Parameters at specific locations in the model The Floor Coordinate Parameters on the Floor
56. e remaining Global Parameters are used for a variety of PBO Lab calculations and displays or they may be used by other Application Modules Included with the beamline Global Parameters s a tab panel for Initial Floor Coordinates of the beam reference trajectory These parameters are not used by the TURTLE or DECAY TURTLE Application Modules The Number of M acro Particles Global Parameter used by TURTLE and DECAY TURTLE is found on the Tracing Tracking tab panel Additional Global Parameters found on the Tracing Tracking tab panel are used exclusively by the DECAY TURTLE M odule Particle Lifetime Parent Decay Particle 1 M ass and Decay Particle 2 Mass The Application Context is Additional Beamline Global Parameters for TURTLE and DECAY TURTLE are accessed from the Tracing amp Tracking tab Em s s s PBO Lab Example 5 Pion After Fit pbol x File Edit view Commands Tools Tutorial panel in the Document Window A Lr HIS Dos ef 9 GIB Sa 2 p A s KIA RTA ef Number of Macro Particles 4000 ee 1 10000 amp set in the Button Bar of the Document Window Output Distributions every Turns 10 100 0 000002 mitiseconds v 0 0000 INF 105 658389 Mev v 05110 139 6000 0 000000 Mev X 0 5770 33 9416 amp Number of Tracking Turns 100 10000 10 nae ae an Green Dots next to Global Parameters indicate the Native Inputs for the Current Application Context cee
57. eamline model have circular apertures by default with the radius taken from the individual Quadrupole Piece Windows However the quad Geometry tab panel in individual Quadrupole Piece Windows has a Pipe Aperture pop up that provides for Circular Rectangular and Elliptical apertures to be specified The individual quadrupole settings for Pipe Aperture and Radial Aperture parameters are overridden when the Quadrupole Piece is proceeded by a Special Piece with non zero Quadrupole Aperture Parameters in the Turtle tab panel Individual quadrupole apertures are also overridden by the Observe Apertures Option in the TURTLE Options Window for TURTLE or the DECAY TURTLE Options Window for DECAY TURTLE If the Observe Apertures Option is set to None then the quadrupole aperture settings will not be observed and any apertures specified with Special Pieces will also be ignored Note that the Observe Apertures Option does not apply to the Aperture Piece referred to as a Slit element in the TURTLE Documentation but it does apply to any magnet element such as Quadrupoles Bends Sextupoles and Octupoles The Quadrupole Aperture Parameters in the Special Piece Window apply only to Quadrupoles following the Special Piece in the beamline model not to other magnet elements or to Quadrupoles that precede the Special Piece in the beamline model 23 Individual quadrupole settings for Pipe Aperture and Radial Aperture parameters are overridden
58. ece is a Marker which by convention is used at the end of the beamline model The Open buttons in Marker Piece Windows open the appropriate windows for the current Application Context Location specific Constraints and Stored Parameters are not supported by TURTLE or DECAY TURTLE The Open Diagnostics button opens a Plot Specification Window tailored to the selected Application Context Refer to the TURTLE Plot Specifications Chapter for a description of using the Marker and Final Pieces for TURTLE Plot Specifications PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules PBO Lab Example B Pion Decay pbol File Edit wiew Commands Tools Tutorial ue gt Blei oeae aaa Ser Particle Charge 1 1 3 ASAN Penn EB Location Marker Marker and Final Pieces may be inserted at desired locations in the beamline to specify Scatter Plots and Bar Graphs from Diagnostic data generated by nau TURTLE or DECAY TURTLE N The Open button in the Diagnostics i ST A panel provides access to the Plot patr quad prise pan guad maner Is le Specifications Window for the zero 2N icati or oa BRET BRET Hab n selected Application Context Turtle Scatter Y vE Decay Turtle Scatter WER Decay Turtle Scatter Y vs M Decay Turle Scatter Y ve E Remove B8 Turtle Plot Specification Plot Selection
59. er Manual Supplement TURTLE amp DECAY TURTLE Modules This page is intentionally blank PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules Table of Contents Chapter and Subject Page Lo CCI SKICA go oa poss pee ee eee eek eee he saba neu chen he l TORILLE e eee seen een eeeehe ss hear oa aensedeeeus es 3 DECAY TURTLE pages da aoe aan rn anna a RE SE 4 R nmne TURTLE 4 442440064454 05 En nei era nEs ieee pas 5 Runnins DEC AY TURTLE 22020 200 beeen bh mts gad Ekona e upaksta 7 2 Applicaion Modules ernennen nn pidea oa es en eS eee ees S 9 Beam Line Global Parameters saa pa au ar u 0 aaa enkkupikugunkaaada 12 3 Beam Line EICMCOS ao5 44546 ws radu rajeposaeiteasapufsasuvone 15 Bram sic o PR vn u m ora 18 SPC PIECE 22450 a ae kaan ea nnd ame ae een 23 Quadrupole Apertures ernennen oboe ess ptd eee eh ee 25 Particle Names and Charge Parameters 0 0000 cc eee eee 26 Additional Special Parameters ija abn gada bene are 28 Special Parameter Settings Window 0 00 cece eee eee 30 Marker e 4444344445546 he pele ee ne ne eh a var aan we es eee res 32 APOP CE eera eteren ones ey eons eee GREER SERIER 35 Ee ACHES pa ha nen a Boe ede one Er ee da EE 40 de TURILE LO TCS 6 tne ieee rep Lana reee 41 I MICE COMMANOS ba un es ees dn be danja eee Darin Be Eee 45 Commands MENU RE EEE 47 MOWNENU 252 4544 beds ba ee ana ha E Ban Korn he ok 49 6 Plot Specifications 45 een an ad boun
60. f Information on Beam Parameters 7 Element jaa Centroid and Curre VW Particle Distribution Type Beam Parameters Parameters Horizontal x s Emitance x x Fa 0 0000 100 0000 sjalpha horizontal l 100 0000 100 0000 beta horizontal 7 0 0000 100 0000 8 0691 0 0 8 0691 Vertical y 59899813 pimm mrad 0 0000 100 0000 j 2620208 100 0000 100 0000 6 beta vertical Saans mad 0 0000 100 0000 Longitudinal 2 s Emittance z z 707 188845 pi deg kev 2 0 0000 1 00e 004 slapha longitudinal 0121006 Phase Energ 100 0000 100 0000 slbeta longitudinal 0 005 51 degkey 0 0000 100 0000 Comments 2 5048 0 0 2 5048 K Beam Phase deg Figure 9 Semi Axes and Twiss Beam Parameter Representations TURTLE and DECAY TURTLE both permit the use of the Twiss parameter representation only for the transverse phase planes horizontal and vertical of the initial beam The Semi Axes representation 1s more general and allows for the complete specification of any sigma matrix including correlations between different phase planes The Twiss parameter representation 1s useful for specifying initial beams in which the phase planes horizontal vertical and longitudinal are decoupled TURTLE and DECAY TURTLE permit the use of the Twiss parameter representation only for the transverse phase planes horizontal and vertical of the initial beam 20 PBO Lab 2 0 User Manua
61. he DECAY TURTLE Commands Menu is used to Execute DECAY TURTLE PA PBO Lab Example B Pion After Fit pbol File Edit View lazis Tools Tutorial DECAY TURTLE TRANSPORT rn 2 3 x ea muri N Saian SIS X ka Write Input and Run DECAY TURTLE Floor Coordinates MARYLIE gt TRACE 3 D gt The Parent Particle Lifetime and the Decay product Masses for DECAY TURTLE are accessed in the Tracing Tracking Global Parameters tab panel Write Input and View 1 10000 amp view DTurtleInput File 4 10000 Compute All AutoCalcs Run DTurtlelnput File Tre 10 100 Decay Turtle Plot List Particle Lifetime Parent 0 0000 INF Options Decay Particle 1 Mass OTT m 0 5110 139 6000 gt Decay Particle 2 Mass 9 000000 mev 0 5770 33 9416 DRFT QD 1 DRFT DRFT QD 2 DRFT DRFT D 3 DRFT DRFT Q D 4 DRFT DRFT HFQD xSect zero nmewap xSect zero FINAL The names and charges of the primary Parent particle and the L decay products are set using the 22 Pieces PBO Lab Special SPEC Piece NS 4 Figure 3 DECAY TURTLE Commands Menu DECAY TURTLE requires some additional Global Parameters to be specified for the Parent Particle Lifetime and the Decay Particle Masses which are set n the Tracing Tracking panel of the Global Parameters The names and charges of the pr mary Parent particle and the secondary decay particles are set using the PBO Lab Special
62. iece is used to specify particle charges for DECAY TURTLE The beamline model must include a Beam Piece in order to generate the native beam inputs for TURTLE and DECAY TURTLE The Green dots to the right of individual parameters indicate which will be used to generate TURTLE and DECAY TURTLE inputs PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Beam Piece The PBO Lab Beam Piece 1s used to define an initial particle distribution for TURTLE and DECAY TURTLE The beamline model must include a Beam Piece usually as the first piece in the beamline as illustrated in Figure 8 Double click the Beam Piece Icon in the beamline model to open the Beam Piece Window shown below The Beam Piece Window contains two tab panels one for Beam Element Parameters and the other for Beam Centroid and Current Parameters There is a Button Bar at the top of the window and dynamic phase space ellipse plots are provided to the right of the parameter tab panels When the Application Context is set for TURTLE or DECAY TURTLE the native beam inputs will be indicated with green dots Set the Application Context for TURTLE or DECAY TURTLE EA PBO Lab Example B Modified pbol Ele Edy em Edi 4 dew Commands Tools Tutorial one 2 015 Ieg 39 RIR Bie x 6 EE a THT Global Parameters Value Units Farticle Charge i 1 Particle Mass 1875 000000 Mev Beam Energy Beam Current i 2 Initial Beam m
63. imary and secondary particles The Parent Charge parameter is followed by two secondary particle charge parameters referred to as first daughter Daughter and second Daughter Daughter2 particles The default for the Parent particle and Daughter 1 particle is for unit positive charge and neutral for Daughter2 particle Only charges of 1 1 or O have any meaning for DECAY TURTLE Charge conservation is not required The primary and secondary particles must be named in order to specify the Charge Parameters in the Special Piece Window and to specify plots for the different particle types in the Plot Specification Window On the left of the Charge Parameters there are Special Parameter Settings buttons S buttons which provide access to Special Parameter Settings Windows that are used to name the particles Figure 14 on the following page illustrates opening the Special Parameter Settings Windows The Charge parameters are specified in the Special Piece Window and the S Buttons for each parameter are used to open the corresponding Special Parameter Settings Window for naming the particles The charge parameters are only defined for named particles In this example the parent particle has been given the Symbolic Parameter Name PION with a charge of 1 and the decay particles are named MUON and NEUTRINO with charges of 1 and 0 respectively When a name has been defined for a particle the S button will have a red
64. ive Graph Plot Windows such as those illustrated in Figure 4 below are automatically created for the data generated by TURTLE and DECAY TURTLE Print Copy Siera umio Zoot lt 4 SetScale 0 01 4400 0 0072 0 0000 0 0072 0 014400 0 010700 0 0054 0 0000 Y rad vs Y m Shift Click for Position x y Pen Width f lt E LEGEND L EAN 14 Fir GUA Y rad vs Y m pie Abo t T Cs a i pa Turtle Plot Window Bis Print Copy Disc Dykes Dart zz SetScale 0 014400 Shift Click for Position x L y Pen Width fi v LEGEND X rad vs X m 0 0072 0 0072 0 014400 0 010700 0 0054 0 0000 0 0054 0 010700 rad vs X m Figure 4 PBO Lab Graph Plot Windows for TURTLE 8 PBO Lab 2 0 Application Modules User Manual Supplement TURTLE amp DECAY TURTLE Application Modules PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules 2 Application Modules This Section describes the PBO Lab Application Context and beamline Global Parameters that are specific to the TURTLE and DECAY TURTLE Application Modules Refer to the Getting Started and User Interface Chapters of the PBO Lab User Manual for general information on the PBO Lab user interface The TURTLE Documentation included with this Supplement describes the specifics of both the TURTLE and DECAY TURTLE programs Set the Application Context pop up
65. k Figure 36 Example of Opening the TURTLE Plot List Window The Plot List Windows provide a cumulative display of all the user specified Plot Specifications for the entire beamline This window allows quick access to the individual Plot Specifications which are set from Final or Marker Pieces in the beamline without having to locate the specific Pieces in the model Double clicking an item in the list of Plot Specifications opens the Final or Marker Piece Window associated with that Plot Specification 62 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules Graph Plot Windows The native output files generated by TURTLE and DECAY TURTLE are automatically displayed in a scrollable Text Edit Window following program execution illustrated in Figure 2 of the Getting Started Chapter The output files contain the native character based plots created by TURTLE and DECAY TURTLE However PBO Lab also provides interactive Graph Plot Windows for this data These Graph Plot Windows one for each Plot Specification set by the user are also opened automatically following the execution of TURTLE or DECAY TURTLE Graph Plot Windows are independent once they are created and subsequent runs will generate new Graph Plot Windows for the same Plot Specifications Once a Graph Plot Window 1s closed the plot data must be generated again by running TURTLE or DECAY TURILE An unlimited number of Graph Plot Windows ma
66. l Supplement TURTLE amp DECAY TURTLE M odules When the Twiss Beam Parameters are selected the Compute From Semi Axes button in the Button Bar at the top of the Beam Piece Window will calculate the equivalent Twiss parameters for the current Semi Axes parameters Similarly when the Semi Axes parameter representation is selected the Compute From Twiss button will calculate the equivalent Semi Axes parameters Tor the current Twiss parameter representation When Semi Axes Beam Parameters are selected correlations may be included n the beam description using the Correlations button in the Button Bar of the Beam Piece Window The Correlations button opens the Correlation Matrix Window shown in Figure 10 Correlations may be entered directly as off diagonal elements of the sigma matrix or by entering values for the reduced sigma matrix Correlations may be entered for the Reduced Sigma Matrix or as off diagonal elements of the Sigma Matrix Correlation Matrix Reduced Sigma Matrix rti j Sigma Matrix Ci i mnm amp mrad Reduced Sigma Matrix r i j i Diagonal j 10 a x Units Jom and mrad 4 0 6724 cm 2 29 1834 mr 0 882111 3 0 5894 cm 2 900000 jo ccoooo 4 285519 mr 2 900000 jo ccoooo ossa 5 141456 cm 2 900000 o 00000 o c00000 0 000000 10 5660 mr 2 900000 jo ccoooo 19900000 o cooooo 0 121000 Sigma Matrix D mm amp mradi i i 1 2 4 6 1 45 215942 18
67. loor fia Special Coordinate Parameters that are not Energy used by TURTLE or DECAY TURTLE E Turtle a 40000 10000 Parameters Value Units Limits Quad Aper Axis GAPA fo ODO Im 0 0090 0 5000 O Quad Hyper Aper GAPH ooo ln 0 0090 05000 6 s ver Quad Aper 34 PB ooo fm m H 0 0090 0 5000 6 Parent Charge PARENT i ooo 1 0000 1 0000 6 s pecay 1 Charge DAUGHTER T 000000 e 1 0000 1 The Turtle Tab Panel in the Special Piece Window Decay 2 Charge D AUGHTER o coo000 x aooo Is used to define Quadrupole Apertures and to specify Names and Charges for the Primary and Secondary Particles in DECAY TURTLE IT Figure 13 Different Tab Panels from the Special Piece Window The Turtle tab panel shown in Figure 13 above 19 the Tenero istine E last tab panel in the Special Piece Window and 1s used panel in the Special Piece Window exclusively by the TURTLE and DECAY TURTLE and isused exclusivelybyTURTLEand Application Modules There are six parameters three for DECAY TURTLE Quadrupole Apertures and three for Particle Charges The Aperture parameters apply to both TURTLE and DECAY TURTLE but the Charge parameters are used exclusively by DECAY TURTLE 24 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules Quadrupole Apertures The first three parameters in the Turtle tab panel of the Special Piece Window are used to specify Quadrupole Apertures All quadrupoles in the b
68. nditions and assigned a Symbolic Parameter Name Use t e S button other particle specific purposes to the left of the Parameter name for each particle type in the SPEC Piece Window as illustrated in Figure 43 Energy Parameters Value Units Quad Aper Axis GAPA ooo in H 0 0090 0 5000 lt guad Hyper Aper QAPH ooo h BH 0 0090 0 5000 sven Quad Aper QAPR ooo ln H 0 0090 0 5000 s Parent Charge PARENT 1000000 e 1 0000 1 0000 be Particle Charges are specified in the Turtle tab panel of the Special Piece Window E L L N BS Special Parameter settings PARENT decay PARENT nn Symbolic Parameter Mame PION Particles must be named using the Special Parameter Settings Window for each Particle Type Decay Turtle A PARENT Particle Mame is ron Figure 43 Particle Names and Charges for DECAY TURTLE 74 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules Figure 44 llustrates one of plots generated by this example using the Write Input and Run DECAY TURTLE command Figures 45 and 46 show the two decay products muons and neutrinos at the same location EA Decay Turtle Plot Window Bis H Print Copy stow Sys Zoom Ga SetScal 0 011000 Shift Click for Position m i Ser 0 0055 0 0000 0 0055 0 011000
69. nds Menus of the PBO Lab Document Windows Professional Versions of both TURTLE and DECAY TURTLE Application Modules for PBO Lab are available for users who have custom or unique requirements Contact AccelSoft for further information This PBO Lab Supplement for the TURTLE Application Module describes the PBO Lab user interface features that are specific to the TURTLE and DECAY TURTLE Application Module Unless otherwise stated the features described for TURTLE are applicable to DECAY TURTLE However specific sub sections are provided for features that are exclusive to the DECAY TURTLE program PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules Running TURTLE TURTLE 1s executed from the TURTLE Commands menu shown in Figure 1 by selecting either the Write Input and Run TURTLE or Run Turtle Input File commands Commands TRANSPORT K TURTLE a Write Input and Run TURTLE MARYLIE K E TRACE 3D lt write Input and wiew Yiew Turtle Input File Compute All AutoCalcs Run Turtle Input File Turtle Plot List Options Figure 1 TURTLE Commands Menu The first command is the primary command for generating input and executing TURTLE The three commands in the second group are used to generate native TURTLE input without automatically executing the program The input file generated by PBO Lab can be edited directly and then the last command in this group can be used to execute TURTLE with
70. ne model DECAY TURTLE requires the specification of a particle type in order to apply an aperture defined by and individual trajectory coordinate PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules The Special Parameter Settings buttons S buttons DECAY TURTLE requires the located to the left of each parameter in the Aperture Piece a Window are used to assign the particle type for an ee use on coordinate will oe individual trajectory coordinate based on the Symbolic applied Parameter Names defined with a Special Piece Refer to the Special Piece Section in the Beamline Elements Chapter for a description of naming particles for DECAY TURTLE Pith a nn Figure 19 llustrates the Special Parameter Setting access Special Parameter Settings Windows for two trajectory coordinates of an Aperture Windows and assign A particle type Piece This example sets slits in the horizontal and to the individual trajectory vertical planes and applies each of the two slits to different coordinates particles H Rectangular Aperture Energy Aperture Type Rectangular Parameters Value Units Limits Radial Aperture 0 500000 em 0 1000 1 0000 s Horz Half Aperture x fo 002500 m Ey Special Parameter Settings ert Half Aperture Y orz Half Angle Cut LY In raq new ap Wert Half Aperture Y Symbolic Parameter Name 4 R siver 0 001 000 m a a a ee Assigning a Horizontal x INF rad Slit of an Ape
71. o return the graph to the previous zoom level This drag box Zoom feature 1s not supported for Scatter Plots and Bar Graphs generated with TURTLE and DECAY TURTLE 64 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Application Modules Options 65 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules 7 Options The last item in the Commands menu 1s the Options command The Options command 1s used to open an application specific Options Window Figure 38 shows the TURTLE Options Window There are two tab panels the first 1s for setting the Calculation Order and the second is for Aperture settings Similar Options are provided for DECAY TURTLE using the Options Command in the DECAY TURTLE Commands Menu Commands TRANSPORT TURTLE Write Input and Run TURTLE Options Windows provide optionsfor the Calculation Order and Aperture settings used by TURTLE and DECAY TURTLE DECAY TURTLE MARYLIE TRACE 3 0 Write Input and view wiew Turtle Input File Run Turtle Input File Compute All Autolalcs TUE Plot List The Options Windows for TURTLE and DECAY TURTLE both have tab panels for Calculation Order and Aperture Options J gt Turtle Options Calculation Order Calculation Order C Zero Order First Order Second Order Third Order Figure 38 Opening the TURTLE Options Window Calculation Order The Order
72. omentum Algebraic Expression momentum T Import Parameter Figure 15 Defining a Symbolic Parameter Name 29 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules A single Special Piece may be used to define multiple Special Parameters for a specific location Multiple Special Pieces can also be placed at different locations to redefine a single Special Parameter However PBO Lab will only use Special Parameters that have been defined by aSymbolic Parameter Name in the parameter s Special Parameter Settings Window as illustrated in Figures 15 and 16 Special Parameter Settings Window Many Piece Parameters support application specific special parameter settings that are accessed with the When an Application Module is Special Parameter Settings Buttons S Buttons located installed a corresponding tab panel next to each parameter in the PBO Lab Piece Windows wil be included in the specia The S Buttons open Special Parameter Settings Windows Parameter Settings Window if that parameter supports any special for the associated parameters The Special Parameter settings for that Application Module Settings Windows S Windows have a application Otherwise there will not be an independent panel at the top of the window as illustrated application specific tab panel inthe in Figure 16 The bottom part of the window contains gt Window for that Application application specific tab panels for any installe
73. ontains the TURTLE Plot List tem which s used to display a cumulative list of all the user specified TURTLE Plot Specifications for the entire beamline The TURTLE Plot List Window 1s discussed separately in the TURTLE Plot List Section TURTLE plots including both one dimensional bar graphs 1 D Projection Plots and two dimensional scatter plots 2 D Correlation Plots are specified in the TURTLE Plot Specification Window which s discussed separately n the TURTLE Plot Specifications Chapter The fourth section of the TURTLE Commands menu contains an Options command which opens the TURTLE Options window discussed in the TURTLE Options Chapter 48 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules View Menu The PBO Lab View also contains application specific sub menus for any installed Application Modules The sub menu for the TURTLE Application Module shown in Figure 27 contains three commands for opening TURTLE input output and plot data files These commands automatically open PBO Lab Text Edit Windows for the selection without having to go through a file open dialog and locate the file A file open dialog is provided from the Scratch Text Edit Window which can be used to open any text file in the PBO Lab environment Refer to the main PBO Lab User Manual for a description of the Open Scratch File command in the View Menu of the Document Window Commands for Directly Viewing and o
74. pplication Context is used to provide indicators for Controls and user Interface windows native input parameters based on the current context en en zu selection Native inputs are indicated in the Global Parameters and in each Piece Window using green dots that appear to the right of a parameter Figure 5 The Application Context 1s also used to access application specific windows ll PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Beamline Global Parameters The PBO Lab Beam Line Global Parameters are described in the Getting Started and User Interface Chapters of the PBO Lab Global Parameters are global PBO Lab User Manual This Section discusses the Global to the entire beamline model and include inputs for Parameters that are used by the TURTLE and DECAY Particle Charge TURTLE Application Modules Particle M ass Beam Energy and The native Global Parameters for TURTLE and DECAY Frequency TURTLE include the Particle Charge Particle Mass Beam Energy and Frequency These parameters are indicated with green dots as illustrated in Figure 6 when the Application Context s set for TURTLE or DECAY TURTLE in the Document Window eae ne ample B Pion After Fit pr m Hide and Show the Global Parameters from the View Menu or the Button Bar The Beamline Global B are accessed from three tab panels that float over the Work Space of the Document Window o
75. r Editing the Turtle Input and Output Files Hide Palette Bar Hide Global Parameters TRANSPORT TURTLE d Input File MARYLIE Output File K TRACE 3 D Flot File Open Scratch File Physical Constants Figure 27 TURTLE View Menu The DECAY TURTLE View Menu is identical to the TURTLE View Menu shown in Figure 27 and will be included when that Application Module is installed The View menu commands do not generate any data files If the respective files do not exist then they must be generated with the Write Input amp View or the Write Input amp Run commands in the Commands menu Changes made to these files must be saved with the Save As command in the File menu of the Text Edit Window Note that changes made to the input file are not reflected in the PBO Lab beamline model and the input file will be over written with any subsequent commands that cause PBO Lab to generate a new input file 49 The TURTLE and DECAY TURTLE View sub menus contain three commands for opening the input output and plot data files The View Menu commands do not generate any data files The files must exist in order to open them from the View Menu The Input file is generated with the Write Input amp View or the Write Input amp Run commands The output file is generated with the Write Input amp Run and the Run Input File commands The plot data file is generated with the Write Input amp Run and the Run Input File commands
76. r Manual Supplement TURTLE amp DECAY TURTLE Modules Pipe Apertures The Pipe Aperture parameter in the Geometry tab panel of Piece Windows for any magnet element Bend Quad Sextupole Octupole etc can be used to apply an aperture to a single Piece Figure 24 shows the Geometry tab panel from a Quadrupole Piece Window A Pipe Aperture on a particular Piece will not apply to succeeding Pieces in the beamline model as 1s the case for an Aperture Piece Pipe Apertures for the entire beamline can be toggled on and off for TURTLE using the Apertures Option in the TURTLE Options Window Apertures on individual magnet Pieces Bends Quads etc may also be applied to DECAY TURTLE particles For DECAY TURTLE apertures set using the Geometry tab panel of magnet Piece Windows may be either applied or ignored to a particular particle type The Aperture tab panel of the DECAY TURTLE Options Window is used to specify the particle type This 1s described in the Options Chapter of this Supplement 40 PBO Lab 2 0 TURTLE I O Files User Manual Supplement TURTLE amp DECAY TURTLE Application Modules PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules 4 TURTLE I O Files The Input files for TURTLE and DECAY TURTLE are generated by PBO Lab and the Output files are processed by PBO Lab following execution of either Application Module The VO files are described here with respect to the TURTLE
77. r these elements are indicated with green dots in the Piece Windows when the Application Context s setto TURTLE or DECAY TURTLE in the Document Window Green dots are displayed to the right of individual Piece Parameters that are used to generate the native input files for TURTLE and DECAY TURTLE Table 1 PBO Lab Pieces supported by TURTLE and DECAY TURTLE Bea en U X Drift Drift Edge Edge Align kJ ER JL r lek 3 Pere a Ep Solenoid Plasma Lens a Rectangular Bend The Piece Window user interface is described in the Getting Started and User Interface Chapters of the PBO Lab User Manual However the Beam Piece Marker Piece and Special Piece have features specific to TURTLE and DECAY TURTLE which are described in this Chapter The Aperture Piece is used exclusively by the TURTLE and DECAY TURTLE Application Modules and is also described in this Chapter 17 Not all of the beamline elements implemented in PBO Lab are supported by all Application M odules Table 1 lists all of the Pieces that are recognized by TURTLE and DECAY TURTLE Pieces in the beamline model that are not supported will be treated as zero length drifts when generating native input for TURTLE and DECAY TURTLE The Beam Piece is used to specify initial particle distributions The Marker Piece is used for setting Plot Specifications The Aperture Piece is used O exclusively by TURTLE and I DECAY TURTLE The Special P
78. r to the or computational modeling The following topics address different z longitudinal direction how to set up a beam for use in computations by the PBO Lab 2 1 Macro Particle Description Describing Trajectories 2 2 Moment Description and Coordinate Systems 2 2 1 The Beam Centroid aption R The Beam Sigma Matrix The reference trajectory is a mathematical construct that provides the reference coordinate o used to describe all other beam particles The reference trajectory defines a rectilinear 2221 Phase 2 LE Pro ections l system for most components but defines a curvilinear coordinate system in bending magnets 2 2 2 2 Sigma Matrix with Centroids ame HyperText 2 2 3 Modeling Beams in TRANSPORT PREY NEXT 2 2 3 1 The Beam Piece 2 2311 Semi Axes Beam Specification 2 2 3 1 2 Courant Snyder Twiss Parameter Beam Specification AN 2 2 3 2 The Centroid Shift Piece 2 2 3 3 The RMS Beam Piece 2 2 3 4 The Rotate Piece 2 2 3 5 The Dispersion Ray sz sovva aoa Topic 1 of 1 Marked gt Search Go To Mark Back Ber Figure 11 PBO Lab Beam Piece Tutorial Windows 22 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules Special Piece The Special Piece 1s used to define special parameters at specific locations in the model The Special Piece may be inserted at any location in the beamline for application to subsequent calculations In many cases the Special Piec
79. res tab panel of the Options Window PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules H Rectangular Aperture Energy Aperture Type Circuir Parameters Value Units Limits s radia Aperture foso ein 0 1000 1 0000 amp s Horz Half Aperture x oos z 0 0000 INF s Horz Hal Angle Cut tx m 0 0000 INF s Wert Half Aperture t oomoo 0 0000 INF IN Vert Half Angle Cut ty nr rad m 0 0000 INF C Long Half Aperture z nr 0 0000 INF 3 Momentum Spread Cut in Fractionfrad 0 0000 INF s Horizontal Semi Axis 0 500000 cm 0 1000 1 0000 Vertical V Semi Axis 0 200000 cin 0 1000 1 0000 Comments new ap ll Figure 20 Circular Aperture Parameters With the Elliptical Aperture Type selected the Aperture Piece can be used to directly specify the Horizontal x Semi Ax1s and Vertical y Semi Axis parameters for an elliptical aperture These parameters will be activated in the Aperture Piece Window Figure 22 when the the Elliptical option 1s selected with the Aperture Type Pop up H Rectangular Aperture Energy Aperture Type iaioa Parameters Value Units Limits Radial Aperture o 500000 em 0 1000 1 0000 s Horz Half Aperture x 3 002500 m 0 0000 INF dl s Horz Half Angle Cut c m 0 0000 INF Ver Half Aperture y ooo 0 0000 INF 3 Wert Half Angle Cut v m ag 0 0000 INF 5 Long Half Aperture Zz WE jn 0 0000 IMF l
80. rture Piece to be Applied to the Muon Particles Half Aperture 2 IMF PP u 7 of a DECAY TURTLE beam mi Momentum bread Cut In Fractic Horizontal x Semi xi fo 500000 Jom ra wend q Wertical Semi Axis fem IZ Apply Aperture to NEUTRINO new ap Horz Half Aperture x Symbolic Parameter Mame a a l N Assigning a Vertical y Slit of an Aperture Piece to be Applied za to the Neutrino Particles of a DECAY TURTLE Beam Decay Turtle IZ Apply Aperture to MUON NEUTRINO MUON MELITRING PION Use the Particle Type Popup to Check box to Apply Apperture to selected Particle select from Primary and Secondary DECAY TURTLE Particles Figure 19 Assigning Particle Types for DECAY TURTLE Apertures 36 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules Apertures on individual magnet Pieces Bends Quads etc may also be applied to DECAY TURTLE particles These apertures are set using the Pipe Aperture parameters on the Geometry tab panel in magnet Piece Windows Pipe Apertures specified with this approach will apply to the particle type that 19 selected in the Apertures tab panel of the Options Window Refer to the Pipe Apertures subsection at the end of this Section Refer to the Options Chapter for a description of Aperture Options for DECAY TURTLE With the Rectangular Ape
81. rture Type selection the Aperture Piece can be used to directly specify the Horizontal and Vertical Half Apertures x amp y and Half Angle Cuts x amp y as well as the Longitudinal Half Aperture z and the Momentum Spread Cut for a rectangular aperture These parameters will be activated in the Aperture Piece Window shown in Figure 21 when the Rectangular option is selected with the Aperture Type pop up H Rectangular Aperture Energy Aperture Type Retangdr lt Parameters Value Units Limits 3 Radial Aperture osom le Jem 01000 1 0000 s Horz Half Aperture x fooozsvo fm ln 0 0000 INF s Horz Half Angle Cut tx Tur lad lt 0 0000 MP s vert Hal Aperture v oomoo jn 0 0000 NE 2 vert Hal Angle Cut rw mo ied 0 0000 ME g Leng Hatt Aperture Z m hm 0 0000 KE s Memertum Spread Cut NE Fractiontrad 0 0000 MP 3 Horizontal Semi Axis 500000 Jen 0 1000 1 0000 s Vertical Semi Axis 20000 fe em 01000 1 0000 Comments new ap Figure 21 Rectangular Aperture Parameters With the Circular Aperture Type selection the Aperture Piece can be used to directly specify the Radial Aperture for a circular aperture type The Radial Aperture parameter will only be act vated n the Aperture Piece Window Figure 20 when the Circular option 1s selected with the Aperture Type pop up 37 Pipe Apertures for DECAY TURTLE will apply to the particle type that is selected in the Apertu
82. s Beam Element Parameters and Centroid Parameters The parameters on the Centroid tab panel are not used by TURTLE or by DECAY TURTLE However PBO Lab does provide a Centroid beamline element that is supported by TURTLE The Beam Piece Window includes dynamic phase space ellipse plots for the initial beam parameters The top plot shows the horizontal red and vertical blue transverse phase space ellipses The bottom plot shows the longitudinal phase space ellipse green The ax s scales for the phase space ellipse plots can be calculated automatically with the Auto Scale Plots button in the Button Bar at the top of the window or the scales may be set directly by the user with the Set Plot Scale button Changes made to any Beam Parameters or changing between the two parameter representations results in an update of the phase space ellipse displays The Particle Distribution Type pop up at the top of the Beam Elements tab panel 1s used to specify the type of particle distribution that will be generated using the users specified beam parameters This pop up is illustrated in Figure 6 and contains selections for 6 D Equivalent Uniform 4 D Equivalent Uniform KV Gaussian 5 Sigma and Rectangular distribution types The phase space ellipse plots in the Beam Window do not reflect the distribution selection To display the initial particle distribution place a Marker Piece after the Beam Piece in the beamline model and use it to specify a
83. t Momentum Spread Cut eo Fractiontrad 0 0000 INF 0 1000 1 0000 4 g Horizortal x Semi Axis 0 500000 cm s Yertical v Semi Axis 0 200000 cm 0 1000 1 0000 Comments new ap Figure 22 Elliptical Aperture Parameters 38 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules The example below shows an Aperture Piece inserted at the beginning of the model The initial particle distribution specified with the Beam Piece 1s displayed in Graph Plot Windows using a Marker Piece with TURTLE Plot Specifications set for x x and y y scatter plots The same plots are also specified with an Alias of that Marker Piece which 1s inserted directly after the Aperture Piece The plots on the left show initial particle distribution before the Aperture Piece and the plots on the right reflect the distribution following the Aperture Piece PBO Lab Example B Modified pbol H u Rectangular Aperture File Edit View Commands Tools Tutorial i ume ME ee Kos nn lt Globals Tracing Trackin es Rectangular Parameters Value Units Limits 0 1000 1 0000 Particle Charge Berie Wess er 375 OOOOOO s Radial Aperture fi An Beam Energy zoo fm non Mew s Herz Half Aperture x fo 003262 m 0 0000 IMF Beam Current ooo T mame sjHorz Half Angle Cut x fo 014592 0 0000 INF H il Frequency feo ooo000 MHZ s vert Half Aperture v fo 002947 N i t amp amp
84. tab panel are exclusive to the TRANSPORT Application Module and are not used by TURTLE or DECAY TURTLE 23 PREF 1 0 Fi 1 d EC Special SPEC Piece CO Quadrupole Aperture Para meters are used by both TURTLE and DECAY TURILE The Charge Parameters are used to define symbolic names and charges for the Primary and Secondary Particles in DECAY TURTLE Only one Special Piece should be used for specifying particle names and charges for the entire beamline PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules H Special The Special Piece can be used for the definition of location specific Special Parameters that modify System Fringe Field and Expansion inputs u for TURTLE and DECAY TURTLE J Parameters Value Units Limits s System Length LENGTH 9 000000 Im IMF IMF g Reference Traj Mom FO 9 000000 GEWIG 0 0000 1 00e 007 s Particie Mass PHASE Energy ST to Focal Plane Fi Parameters Value Units Limits sjHat Pole Spacing HGAP za lem 0 7000 100 0000 amp SE moli Fringe Field Int K1 s Fringe Field Factor Comments SPEC Ent Pole Face Cur Parameters alue Units Limits sje Pole Face Curi afana Order Field EPS 0 ooooo0 1im 2 INF INF 6 slana Order Field EPS3 I nadaan 1 ne INF INF g Excess Field Fraction IRMPSI o o00000 0 0000 10 0000 E 5 Scaling Factor RMMS o coooo The Floor Tab Panel contains F
85. th the Final Ellipse Plots option selected in the Transport Plot Specification window Refer to the TRANSPORT Application Module Supplement for more information on Transport After the TRANSPORT run 1s complete the data from the Final Ellipse Plots Figure 32 can be used to estimate the Axis Range for the x x y and y axis for each plot specification In this example the vertical axes are taken to be x and y with the Axis Range for both set to 14 milliradian mrad The horizontal axes are x and y with their Axis Ranges both set to 1 centimeter For 1 D Projection Plots Bar Graphs once the desired Ax1s Range s determined the Bin Size Figure 29 for each ax s must be set Reasonable 1 D Projection Plots are usually obtained for Bin Sizes that are in the region of one twentieth to one thirtieth of the Axis Range The values shown for the vertical and horizontal Bin Sizes in this example are not used since the Plot Selections are for 2 D Correlation Plots After the Plot Specifications are entered the Write Input amp Run command in the TURTLE or DECAY TURTLE Commands Menu 1s used to create the input file and execute the program A Output text window will be opened and data will be written to the window An echo of the input file data will appear initially and then the character based histograms are written as shown in Figures 34 and 35 PBO Lab will also open interactive Graph Plot Windows for each of the Plot
86. the modified input These commands are provided for users that are experienced with the native format and syntax supported by the TURTLE program The last two items in the TURTLE Commands menu are used to access TURTLE Options and Plot Specifications These are each described in separate Chapters in this Supplement Running the TURTLE Module is straightforward Simply select Write Input and Run TURTLE from the Commands Menu as illustrated in Figure 2 The command is executed after the mouse button is released causing PBO Lab to write the TurtleInput file for the current beamline model as defined in the model space of the Document Window and run the TURTLE Application Module Upon completion the TurtleOutput file will be displayed in a PBO Lab Text Edit Window as illustrated in Figure 2 The TURTLE Commands menu Is used to generate native TURTLE input and execute the TURTLE program Commands are also provided for Options and Plot Specifications The first TURTLE command is used to generate native input and execute TURTLE The second group of commands is used to generate the native input file for TURTLE without automatically executing the program Run the TURTLE program by simply selecting the Write Input and Run TURTLE command from the Commands M enu PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Commands TRANSPORT TURTLE MAR YLIE TRACE 30 write Input and Run TURTL
87. traints Diagnostics and Stored Parameters The Open buttons in the Marker Piece Window open the appropriate windows for the current Application Context Application specific windows tailored to the particular capabilities of each Application Module are used to specify Constraints Diagnostics and Stored Parameters There are three scrollable lists in the Marker Piece window that are used to display Constraints Diagnostics and Stored Parameters for all of the installed Application Modules Neither TURTLE nor DECAY TURTLE support parameter fitting so the Open button for Constraints will be inactive for the TURTLE and DECAY TURTLE Application Context The Open button for Stored Parameters is also inactive for the TURTLE and DECAY TURTLE applications The Open Diagnostics button opens a Plot Specification Window The Plot Specification Window is tailored to the particular capabilities of each Application Module for generating output at specific locations in the beamline The Application Context pop up must be set for the TURTLE Application Module as illustrated in Figure 18 in order to open the TURTLE Plot Specification Window Likewise the Application Context must be set for DECAY TURTLE in order to open the DECAY TURTLE Plot Specification Window from a Marker Piece The Plot Specification Windows are used to select a variety of plotting options which are described in Chapter 6 of this Supplement 33 The Final Marker Pi
88. ts See page 2 of the TURTLE Documentation for a description of the differences Observe Apertures Option The Apertures tab panel in the TURTLE Options Window is shown in Figure 39 below The Apertures tab panel has a pop up control that 1s used to toggle all specified apertures for the beamline The default setting for a new untitled PBO Lab Document s NONE 1 e specified apertures are not observed When the Apertures Pop up is set to INCLUDE apertures all specified apertures will be taken into account Particles passing outside the specified apertures will be lost This option does not apply to Aperture Pieces in the beamline model It does apply to all apertures that are specified on other elements such as bending magnets The INCLUDE Apertures selection is used to observe all apertures specified on magnet elements through out the beamline apertures are ignored when this Option is set to NONE INCLUDE 9 E NONE INCLUDE Sn Turtle Options Calculation Order Apertures Obzerve Apertures for Particle Lass Apertures INCLUDE 7 Figure 39 TURTLE Options for Observing Apertures 68 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules An Observe Apertures option 1s also provided for DECAY TURTLE However with DECAY TURTLE apertures are assigned for a particular particle This requires a particle to be selected for the Observe Apertures option using the pop up control that is pro
89. ture and appears in the plot The pion Parent particle beam cross section is approximately circular rather than elliptical at the exit of magnet labeled HFQD when the magnet apertures are applied to the Parent particles PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules EA Decay T urtle Plot Window Print Copy BANIJE 85 RER KAK i SetScale Shift Click for Position X T awan Bo LEGEND Y m vs X m 0 0055 0 0000 0 0055 0 0000 0 0055 Y m vs X m Figure 52 P on Y X Distribution at Marker after Quad Piece HFQD When the Apertures Option 1s used to apply magnet apertures to the Parent particles the decay product distributions are only affected to the extent that Parent particles can no longer decay once removed from the beam In this example only the aperture for the last quadrupole HFQD has an impact on the Parent particles so that the decay products at the exit of the magnet are unchanged except for differences associated with different initial distributions Figures 53 and 54 show the muon and neutrino distributions for this particular run 80 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules EA Decay Turtle Plot Window Bis x Print Copy raw EAA Zoni sad SetScale E Shift Click for Position x heey 0 2750 Pen Width 3 hg LEGEND Y Um vs X m 0 0000 0 2750
90. un Transport Shift Click for Position u y E x e LEGEND Get Estimates of the Range for Each TURTLE Projection x rad ve x m i 0 0000 Axis from the TRANSPORT u Final Ellipse Plot yen ve 0 0 0072 SELIO z 0 010700 0 0053 1 73e 015 0 0054 0 010700 Fhase Space Elipses EA Turtle Plot Specification x Hal P Projection Axis Bin Size Units Set lt i Plot Specification mrad x 14 400000 14400000 gt Delete cm 1 070000 1 070000 Yerlical x 1 000000 Horizontal x 9 040000 Tro se See tow Won po as See tow I umm Use Auto Scale Plot Option to let PBO Lab Calculate the Plot Range T Auto Scale Plots lt lt Plot Selection accept the TURTLE Ser RE E HEH IR neo rezano RT ema P of Plot Specifications to An Appropriate Bin Size for Edit or Delete Entries 1 D Projection Plots Bar Graphs is Typically the Axis Range Divided by 20 to 30 The Bin Size is not used for 2 D Correlation Plots Scatter Plots E Figure 32 Setting Up TURTLE DECAY TURTLE Plot Specifications 57 Reasonable 1 D Projection Plots are usually obtained for Bins Sizes that are one twentieth to one thirtieth of the Axis Range PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules To estimate values of the plot specification parameters to be used by TURTLE or DECAY TURTLE 1t 1s useful to first run TRANSPORT wi
91. vided in the Apertures tab panel of the DECAY TURTLE Options Window as illustrated in Figure 40 The DECAY TURTLE Aperture Option requires a particle type to be selected with the Aperture Popup Apertures are Ignored when this Option is set to None Decay Turtle Options Calculation Order Apertures Observe Apertures for Particle Lass Apertures NONE Figure 40 DECAY TURTLE Aperture Options As with the TURTLE Apertures Option when the DECAY TURTLE Apertures Pop up is set to NONE all of the specified apertures for the entire beamline are not observed When a particle is selected with the Apertures Pop up all specified apertures will be taken into account for the selected particle Particles of the selected type that pass outside the specified apertures will be lost Apertures are not observed for particles that are not the selected type The following Chapter provides a tutorial example that illustrates several features of the DECAY TURTLE Application Module which have been described through out this Supplement 69 The DECAY TURTLE M odule requires a particle type to be selected for the Observe Apertures Option The Apertures Option does not apply to Aperture Pieces in the beamline model It does apply to all Pipe Apertures that are specified on individual magnet elements PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules This page is intentionally blank 70 P
92. xSect zero mewap xSect z gt Figure 41 The Example B Pion Decay pbol file is in the DECAY TURTLE folder n the Examples folder of the installed PBO Lab In addition the Tracing Tracking Global Parameters used by DECAY TURTLE Particle Lifetime Decay Particle I Mass Decay Particle 2 Mass are set to correspond to the nt gt ut v decay process Figure 42 llustrates the set up for the Tracing Tracking Parameters to track the decay products for an initial distribution of 1000 pions Particle Mass 139 6 MeV 73 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules Globals Tracing Tracking Floor Coordinates Number of Macro Particles 4000 1 Number of Tracking Turns 100 Output Distributions every 10 Turns 10 100 Particle Lifetime Parent 26 000000 nanosecond Y 0 0000 INF Decay Particle 1 Mass 105 558389 Mev 0 0000 139 6000 Decay Particle 2 Mass 0 000000 mey 0 0000 33 9416 Figure 42 Tracing Tracking Global Parameters used for Example B P on Decay pbol The names and charges of the primary Parent particle A symbolic Parameter Name mustbe and the secondary Daughter particles are set using the assigned for each particle type that PBO Lab Special SPEC Piece Each particle to be is to be tracked These names are included in the DECAY TURTLE simulation must be used to define PBO Lab plot spec li he S fications aperture co
93. y DECAY TURTLE The Number of Macro Particles Global Parameter is used to specify the number of rays that will be traced through the beamline It is set to one thousand 1000 as a default value but has a practical range from one to ten thousand which is reflected by the Limits displayed in the Global Parameters Pane These are soft limits which do NOT restrict the user s input in any way They are simply indicators of a reasonable range for a parameter based on a variety of factors such as other Global Parameters The maximum number of rays Macro Particles is dependent on other storage requirements such as the number of elements in the beamline model Computation time is also a factor for tracing a very large number of macro particles The lifetime for the parent particle used by DECAY TURTLE and the decay product Masses are also set in the Tracing Tracking panel of the Global Parameters However the Charges for decay particles are set using the PBO Lab Special SPEC Piece The use of the Special Piece is described in the Special Piece Section of the Beamline Elements Chapter 14 PBO Lab 2 0 Beamline Elements User Manual Supplement TURTLE amp DECAY TURTLE Application Modules 15 PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE M odules 3 Beamline Elements The PBO Lab Pieces implemented for the TURTLE and DECAY TURTLE Application Modules are listed in Table I below Native inputs fo
94. y be created and left open for simultaneous viewing Figure 37 shows some example Graph Plot Windows a l D Projection Plots Bar Graphs A Graph Plot window is automatically opened for the TURTLE Plot Specifications when the Write Input amp Run Turtle command is issued Graph Plot windows from different runs may be created and left open for simultaneous viewing 2 D Correlation Plots Scatter Plots Figure 26 PBO Lab Graph Plot Windows 63 The Button Bar at the top of Graph Plot window provides controls for printing and copying the graph Clicking on a plot variable in the Legend will hide or show that data set in the graph plot The pen size used to draw plots can be specified for some plot types using the Pen Width pop up The Show Symbols button is used with Line Plots to display Symbols for each data point and allow access to data point coordinates The Set Scale button allows axis scales to be modified directly in the Graph Plot Window PBO Lab 2 0 User Manual Supplement TURTLE amp DECAY TURTLE Modules The Graph Plot Windows may be resized from thumb nail size to full screen and provide several interactive features A Button Bar at the top of the window provides options for printing the graph and for copying the graph to the system clipboard Plot variables are identified in the Legend in Graph Plot Windows Clicking on a plot variable in the Legend will hide or show that

turtle intro.p65

Contents

Download Pdf Manuals

Related Search

Related Contents