Home

User Manual - calabazas creek research, inc.

1. Project MSOC Project ee Case Example id Analysis Ty Date Modif Comments Clean Up Case Display Edit Comments Close Case Save Case 5 amk eee y a ne ot tht athens 1 Ta A ms gt a S f a ee FIGURE 203 Save Case As on the Case sub menu 4 Uncheck the Copy Meshes checkbox You will generate a different initial mesh for this case Leave the other checkbox checked 5 Click OK The new case will appear in the Project Case Man ager tree control and the model will appear in the graphics display region 6 To add comments for Example 2B right click on the new case Case Example 2B in the Project Case Manager tree control Select Display Edit Comments from the sub menu The Display Edit Comments dialog will appear 7 Modify the comments as shown in Figure 205 154 5 10 BOA Version 4 User Manual v0 5 updates in progress 8 Click OK to close the dialog 4 2 2 2 Saving a Case As you continue through this example it is a good idea to save your work occasion ally To save a case right click on the Case name in the Project Case Manager tree control and select Save Case Alterna tively open the File pulldown menu and click Save Case 4 2 2 3 Defining Analysis Type In Example 2B you will add an external Dis play Edit Comments User Manual Example 2B ElectroMagnetostatic Analysis for MSDC with secondary emissions Based on Example 24 with addition of 1 10 axial field
2. c ccc cccccceeccccecceceeeeeeeeeeeeeeeeeeeees 183 6 2 2 Terminal Particle Output File Enpa Output cc cccccccccceeeccceeeeeceeeeeeeeeeeees 183 6 2 3 CDO OMtput Pile naaa aa ede hata neuer A 183 62 Case SUMMA Pile aaeanoa a ltucsseacasl a packs Janeen sins cankteameneas 183 6 3 Appendix C Intermal Fes eciccascisarssccadehoticclasedadehatic donetis vantiatdeatenesabteatuasesasanes 183 Calabazas Creek Research Inc 650 312 9575 Fax 650 312 9536 Email RLIves CalCreek com www CalabazasCreekResearch or www calcreek com Copyright 2010 BOA Version 4 User Manual v0 5 updates in progress 5 10 1 0 Introduction Beam Optics Analyzer BOA is an advanced 3D charged particle simulation code with optimiza tion Its principle applications include the design of electron guns collectors and charged particle devices Features include e Incorporates finite element analysis with adaptive and user controlled meshing e Compatible with commercial 3D CAD programs e User friendly intuitive graphical user interface GUI e Integral electrostatic and magnetostatic solvers e Import of spent beam and magnetics files e Accurate simulation of grids e Secondary electron emission e Fully relativistic e Includes space charge and self magnetic fields e Built in materials database e Optimization of beam optics design of guns collectors and beam lines e Optimization of electrostatic and magnetostatic circuits e Optimization of mult
3. FIGURE 148 Execute dialog for Example 1B After BOA completes you must again run the post processor to view the Electrostatic results l Open the View Results pulldown menu and select Electrostatic As with the first run a warning message will indicate that time is required to format the output for plotting Click Yes and wait for the postprocessor to complete As in Example 1A the default electrostatic results will appear in the graphics display region and the Electrostatic Display Parameters dialog will automatically pop up on top The results shown correspond to the default settings on the Electrostatic Display Parameters dialog 1 e Display Vector Field E set to On and Display Scalar Field set to V meaning display the voltage contours This is shown in Figure 149 You may notice that the vectors are spaced differently as compared with the vectors shown in Figure 137 on page 110 for Example 1A This is due to the difference between the initial mesh 118 5 10 BOA Version 4 User Manual v0 5 updates in progress and the adapted mesh The vectors are located at the mesh corners and the mesh for this example has been adapted Electric Field V m 2 98e 006 1 31 64006 3E0605 2 02e 006 3 69 006 1 806 004 Cape Example I Potential V 35e 004 00e 003 4 50e 003 T ibik Projects JLo Kyara Gun Propet E Case Eupe i Lae PF Electr
4. BE 1 0 Nz G 1 j 0 B 1 1 0 B 1 1 1 BE 1 1 Nz G 1j 1 B Nx Ny 0 B Nx Ny 1 BINx Ny Nz G Nx j Ny 6 1 3 3 CCR Imported Magnetic Flux Density bf file File Format The CCR formatted file can be generated via PostPro for a Boa Magnetostatic run If you are using an unsupported magnetostatic solver and want to import its magnetic field into BOA the easiest thing to do is to write a translator to convert the format to the CCR format 6 1 4 Excel Optimization File TBD get info from MR or TB 182 5 10 BOA Version 4 User Manual v0 5 updates in progress 6 2 Appendix B Output Files 6 2 1 Planar Particle Output File Papa output TBD note that default filename can be changed Note that papa output file can also be used as injected beam file considered a CCR file format type 6 2 2 Terminal Particle Output File Enpa output TBD The default name for the file is n Enpa out where n corresponds to the Particle Iteration 6 2 3 Cibo Output File TBD see ibf file format 6 2 4 Case Summary File TBD 6 3 Appendix C Internal Files By convention all files post fixed wit the character _ are for internal usage only Examples are CaseName_ ebm CaseName_ cde and ModelName_E_ sat A file pre fixed with a number and indicates this file is for that particular particle iteration number An example is 0 CaseName_ spd O stands for Oth iteration List of BOA generated files e ssv fil
5. Clipping State This radio button turns the clipping state on and off For an explanation of Clip ping State see discussion of the Clipping State section of the Electrostatic Display Parameters dialog in the section below The Close button closes the Scalar Field Cut Plane dialog and returns to the Electrostatic Display Parameters dialog shown in Figure 73 TBD discuss Hide vs Exit Also do more bug checking to see if I can reproduce the odd behav ior I initially saw when using Hide on the jlab klystron case 3 11 1 2 01 1D Display Line Plots amp Data Point Extraction 3 11 1 2 1 Line Plots The Line Plot button in the i rem OD ID section of the Electro You may enter line endpoint coordinates directly into the edit static Display Parameters A a button to the right to select endpoints Surface Select dialog shown in Figure 73 The 3D Select button enables you to locate endpoints anywhere i Field to Plot within the bounding box of the model The Surface Select button brings up the Electrostatic Voltage will only allow you to locate endpoints on the surface of the model Line Plotter dialog shown In Charge Density Starting Point Ending Point Number of Points to Plot cme i Figure 82 This rad oan x o7 1 0875 ET og enables you to create line Loz Lasz AbsdssaT 8 I C Electric Flux Density D ADAS d Ree no a plots for various fields Use A o aa ores f 0 Arc Leng the Field to Plot radio bu
6. g3 9 Before proceeding confirm that the part colors appear as shown in Figure 131 Use the mouse to orient the model so that you can see the cathode as shown in Figure 131 10 To return to the previ ous orientation open the View menu and select Reset View It is a good idea to save your work occasionally cun tagt 1a sa an Take this opportunity to FIGURE 131 Electrostatic Model with Attributes Assigned save changes to the case by right clicking on the case name in the Project Case menu bar and selecting Save Case 4 1 1 8 Generating the Initial Electrostatic Mesh Once you complete the attribute assignments you are ready to generate the initial electrostatic mesh In this example the default mesh parameters are sufficient so you do not need to open the Mesh Parameters dialog 106 5 10 BOA Version 4 User Manual v0 5 updates in progress 1 Open the Meshing pulldown menu and select Generate Initial Mesh 2 A DOS window will appear indicating progress during the mesh generation process When the process completes the following text will appear at the bottom of the window Mesh Genera tion Complete mesh file created JUAB Gun_E sms Press any key to continue exit Hit any key to close the DOS window and return control back to the user interface 4 1 1 9 Viewing the Initial Electrostatic Mesh 1 To view the initial mesh BoaGui Project Jlab Klystron Gun Project Case Example 1A Fil
7. Axis E Grid Urit im B_ theta a Tesla Largest Field Radius 54251696 in f Field Parameters sd ere eer reer Enable Mum r Coord First Point xi z y z 2 Sea Avis Second Paint Starting Point Oe a ae ae ee Bee I hr lv Plot Parameters Open gt gt Plat to Verify Field to Plat to Verify Field Field Sox Hum of Plot Points Cancel FIGURE 37 Dialog for importing a Magnetic Flux Density File in ID Axial format for the Maxwell 2D RZ Magnetic Flux Density option See the previous section for details Note that BOA calculates the off axis or 2nd component of the flux Bp internally 3 8 2 4 Optically Transparent Parts 36 5 10 BOA Version 4 User Manual v0 5 updates in progress The Optically Transparent ee ee ae ee ae Parts section of the Attribute g Cet OR 3 Assignment dialog Beam Optically Transparent Parts Optics tab enables you to a Part Name gd define parts in the modelas z Emitter 3 yellow optically transparent E Delete Pi To make a part optically transparent click the Add button next to the table shown in Figure 38 Refer back to Figure 23 to see the complete Beam Optics tab This will bring up the graph ics display window contain ing the geometric model Find the desired part and select it by pressing Ctrl Left mouse button Click enter to select The part will appear in the table at ai ga gaia d Lentini ath TA iv
8. 3 8 3 Magnetostatics Attributes The Magnetostatics tab shown in Figure 42 is enabled whenever the Analysis menu is set to the Magnetostatic analysis type Use it to make the attribute assignments required for magnetostatic analyses It contains three sections The top section Properties at the Part Level specifies the basic magnetostatic properties for all parts in the model The middle section Current Density Attribute Assignment specifies current densities for parts that are conductors The bottom section specifies homogenous Dirichlet boundary conditions for surfaces eS a Attribute Assignment Properties iml Magnetostatics Properties at the Pat Level Rel Pemeab Tag Material Name Opacity 1 0 1 1 SqBox Vacuum Background 2 Vacuum 0 8 Name Color H Relative Permeability Material fMterial Selector Format Curent Density Attribute Assignment InletColor Axis OutletColor Select Current Vector Type Analytic Cylindrical Solenoid wv Add Part s Modify Delete Homogeneous Dirichlet BC Bn 0 Color Add Modify Delete FIGURE 42 Attribute Assignment dialog box Magnetostatics tab 3 8 3 1 Properties at the Part Level The Properties at the Part Level section enables you to assign attributes to the parts that make up the geometric model The table at the top of the section summarizes all of the parts in the geome try file To modify a part s properties first select the par
9. and the Plot Display Location dropdown box to Main Window or New Window 4 1 3 8 Viewing Beam Analysis Results Once BOA completes you can immediately view the beam optics results 1 Open the View Results pulldown menu Click on Beam Analysis The Beam Optics Display Control Panel dialog will open and the trajectories will automatically appear per the default settings as shown in Figure 175 ox Project Jlab Klystron Gun Project 3 Case Example 14 Beam Optics Display Control Panel Particle Iteration Emitters and Trajectories 9 see Emitters Display Power Densities Ml emitter Off C On Display Traj Planar Particles Generate Terminal Particles File Generate Particles File Name 9 Enpa out Ea Hide this dialog temporarily Hide Case Example 14 Iteration 9 Current 1 46736 FIGURE 175 Trajectories On shown with the model sliced 136 5 10 BOA Version 4 User Manual v0 5 updates in progress 2 To get a better look at the trajectories slice the Slice Electrostatic Model model First click on the View menu item and Choose Plane select Slice Model The Slice Electrostatic ee ee 2x plane y Center Model dialog will appear Figure 176 C xy plane z Center C xyzplane Normal Distance 3 In the Choose Plane section select the zx mee radio button y Normal 2 Normal 4 In the Slicing Side section select Negativ
10. 4 1 8668010E 01 1 66666 0E 04 2 3 38222 70E 04 6 6694970E 04 1 44115 0E 04 2 009090E 04 1 91696 0E O01 1 66666 0E 04 3 5 2359660E 04 7 2006180E 04 3 5160920E 04 7 4083330E 04 2 0058560E 01 1 66666 0E 04 Ee 6 1164580E 04 9 6352890E 04 2 8 49810E 05 4 2423080E 04 2 2906040E 01 1 66666 0E 04 2 6 04607 30E 04 4 5901410E 04 1 3084300E 06 2 3342050E 05 2 38532090E 01 1 66666 70E 04 6 6 2472 00E 04 4 8604500E 04 3 88 76260E 05 1 8921320E 04 2 3820220E 01 1 66666 0E 04 i 6 725 030E 04 5 0210640E 04 1 3460020E 04 6 61L04400E 04 2 36840590E 01 1 66666 0E 04 B 009 7260E 04 4 1262030E 04 5 041 8290E 04 6 5 63610E 04 2 4451 760E 01 1 66666 0E 04 9 6 9121630E 04 2 80 6950E 04 68 31270E 04 2 2555660E 04 2 53295030E 01 1 66666 70E 04 10 6 7483210E 04 1 9827570E 04 8 9837490E 04 9 7045210E 05 2 0128200E 01 1 66666 0E 04 TI 6 0 4030E 04 1 7343090E 04 1 0168840E 03 1 63 6820E 04 27 7146850E 01 1 66666 0E 04 a2 6 7339120E 04 1 7461120E 04 1 1405430E 03 1 1020470E 04 2 832 7750E 01 1 66666 0E 04 13 6 70622530E F 1 7817220E 04 1 2348650E 03 5952350E 05 2 9415040E 01 1 66666 0E 04 Ll beeen OE 04 1 7561450E 04 pact FAQE OS fg 0 3 0247090E 01 1 66666 0E 04 naa on p a ee OO a EE 2 AAA REAR Ae AB Mt bx vx c by vy c bz vz c normalized velocity gbx gamma bx gby gamma by gbz gamma bz and Ip the particle current in Amp gamma I sqrt 1 v 2 c 2 FIGURE 232
11. Material in the Material drop down box This will bring up the Material Properties dialog dis cussed in Section 3 12 3 It can also be accessed via the Jools gt Material Properties menu 3 8 3 2 Current Density Attribute Assignment The Current Density Attribute Assignment section on the Magnetostatics tab Figure 43 enables the assignment of current densities to parts in the geometry model that are conductors Current densities can be defined as one of three types e a Uniform Current Density used for straight conductors 40 5 10 BOA Version 4 User Manual v0 5 updates in progress e an Analytic Cylindrical Solenoid uniform cylindrical thickness e a Directional Current used for open conductors or for solenoids with more complex shapes or nonuniform cross section seas Nat re ae et eo Bee oe Laie fom eT a Te P PE ey axes MS ca ee Bahn E BN pie ee fl a ae ra ya pi 5 ee ey PTs wot r i n E Bui ee s 2 B 5 3 7 4 as Zz 2 ee yen E iari 5 ail P lt p Current Density Attribute Assignment Add Part s Modify e REE Dirichlet Bn 0 ry z y ia a ghisa Te a n o ai Ffi Moonta a E o eT 1 a SETS Ta er s ins wag Meere ee am a n m aT FIGURE 43 Current Density Attribute Assignments table on the Magnetostatic tab of the Attribute Assignments Properties dialog Uniform Current Density Uniform Current Density This option should be used for straight
12. The new case will appear in Case may only be added if it is placed i e inthe curent project directory the Proj ect Case Manager iree onno and the model will appear in the graphics dis Ok Cancel play region PAL RECESO OP Casealeite 6 To add comments for Example 1C right click on the new case Case Example 1C in the Project Case Manager tree control Select Display Edit Comments from the sub menu The Display Edit Comments dialog will appear 7 Modify the comments as shown in Figure 157 8 Click OK to close the dialog Display Edit Comments User Manual Example 1C Electrostatic beam analysis for Jlab Klystron Gun No 4 1 3 2 Saving a Case adaptivity As you continue through this example it is a good idea to save your work occasionally To save a case right click on the Case name in the Project Case Manager tree control and select Save Case Alternatively open the File pull down menu and click Save Case Cancel 4 1 3 3 Defining Analysis Type FIGURE 157 Display Edit Comments dialog Example 1C is an Electrostatic Beam analysis type BOA Version 4 User Manual v0 5 updates in progress 5 10 123 1 Open the Analysis pulldown menu and select Electrostatic Beam analysis type 4 1 3 4 Assigning Beam Optics Attributes Because this example is based on Example 1A the geometry file has already been specified and the electrostatic attributes have already been assigned Now you will assign the beam
13. This will bring up the graphics display window containing the electrostatic geometry model BOA Version 4 User Manual v0 5 updates in progress 5 10 127 4 Confirm that the model is oriented so that the Anode 1s in the front as shown in Figure 163 FIGURE 163 The Anode Tunnel Left image is prior to defining the AnodeTunnel model surface Right image is after defining the AnodeTunnel model surface The goal is to define the portion shown in purple in the right hand image that is the inner tun nel of the anode as a Local Mesh Refinement 1 e as a mesh controlled surface Use the Ctrl Left mouse button to select the tunnel The inside of the anode will appear selected it will change color and the status bar on the bottom of the screen will display the selected surface tags 48 and 50 as shown in Figure 164 The internal algorithms used by BOA separate each poe raat Ed or Esc to cancel ObjectTag 4 FaceTagis 45 50 1 gt FIGURE 164 The Surface Tag IDs on the Status part in the geometry model into multiple surface tags In order to specify a desired set of sur faces in BoaGui you usually have to make a separate selection for each surface tag However if the geometry file contains a named surface an optional feature in some CAD programs BoaGui allows you to select all of the surface tags included in the named surface as one single entity In this case the JLAB Gun SAT file contains
14. or normal ized units Norm FIGURE 95 Scalar Field Cut Plane dialog 78 5 10 BOA Version 4 User Manual v0 5 updates in progress Contour Specifica tions This sec tion controls the display of the sca lar field on the cut plane Use the Show Contours checkbox to tog gle the display between contour lines checked and a continuous color contour plot unchecked When viewing contour lines define the contour range by specify ioui Copind Examples baa Project Copied Lumnples B Case hampir IA E Cave krampis HH E cis kiil B Cae Mag Case from Mike J gae MEK Solenced with FE LS Analysis Type Magnetortati er n Specieshen D Sha Donida Lu Plane Numa Sprefnahon Ange hoa 2 am ia TA a Cabuk Scale anga biri 0 en fi ret Angie Prem oc o i Bey SBT 15 i Humber of Contour jio Morrushoerd Dri lio Cai erag Hirra Manama salar 0 trO 100 Micon Scale p 1 j Moet oo o Monte a igp ine Fit resets Cipp State Sei Desi 1 M Shaw Meih Dutina Ew Co Dn Lra aidi 2 Cine Cate MIBE Seileren nth FE k FIGURE 96 Scalar Field Cut Plane ing the Number of Contours to be displayed and the Minimum Voltage and Maximum Voltage that define the range Note that changes do not take effect in the graphics display until you click the Apply button or the Enter key Viewing Parameters The Set Opacity slider
15. 12 In the Optically Transparent Parts section click the Add button next to the table This will bring up the graphics display window containing the geometry model 13 Select the Emitter part by pressing Ctrl Left mouse button anywhere on the part The entire Emitter part will appear selected it will change color Click Enter to complete the selection 14 The part will appear in the Optically Transparent Parts table as shown in Figure 192 This part is considered optically transparent because it is not a physical entity It models an injected beam 15 Click the Electrostatic tab Check the Visible checkbox for all parts except the background to make them visible again 16 Click OK to close the Attribute Assignment Properties dialog 17 To reset the model position open the View menu and select Reset View Note It is a good idea to save your work occasionally Take this opportunity to save changes to the case by right clicking on the case name in the Project Case menu bar and selecting Save Case 4 2 1 9 Generating the Initial Electrostatic Mesh Once you complete the attribute assignments you are ready to generate the initial electrostatic mesh In this example the default mesh parameters are sufficient so you do not need to open the Mesh Parameters dialog 1 Open the Meshing pulldown menu and select Generate Initial Mesh 2 A DOS window will appear indicating progress during the mesh generation process When the process complet
16. 4 2 piel ged e ee i ge ie Se Ta a IT a E ad zi a at aia a Homogeneous Dirichlet BC Bn O A atl Add Modify Delete gt e F a F aes F Fi sit re eta i a z i mh ie wrens p a a k ee i oe i a n SF e a Fi Tl ee wan oF a FIGURE 47 Homogeneous Dirichlet BC BN 0 table on the Magnetostatic tab of the Attribute Assignments Properties dialog table This will bring up main window containing the geometric model Find the desired surface and select it by pressing Ctrl Left mouse button Click enter to select The dialog shown in Figure 48 will appear Enter the desired Name if editable and select a Color Remember the Name field will not be editable for any surface that already has a name in the CAD model Click OK to complete the assignment The surface will appear as an entry in the table To modify any item in the Homogeneous Dirichlet li etic Propaace BC BN 0 table once it is defined select it in the table and click the Modify button The above dialog Property Type Homogeneous Diha EE will reappear and you can edit the values To delete a surface from the table select it and click the Delete Name p button Color default Tagiz 43 Value o Cancel FIGURE 48 Homogeneous Dirichlet BC BN 0 Assignment dialog 44 5 10 BOA Version 4 User Manual v0 5 updates in progress 3 8 4 Optimizer Attributes The Optimizer tab shown Weee a xa in Figure 49 is
17. 4 The informational message shown in e The selected geometry file is not in your case directory C Boa ExamplesiJlab Klystron Gun ProjectiExample 141 Figure 126 will i Do you wank bo copy the selected file to your case directory Esl boaGui inform you that BoaGui will cre ate a copy of the file and place it in FIGURE 126 Geometry File Copy Message the current Case directory Click Yes 5 The name of the geometry file will appear in the Geometry Solid Model File entry box as m Verify the initial model shown 1n Figure 125 J The Ee rot a CCR SIM model with correct topology and geometry al boaGui 6 The Model Units will appear undefined until you load the model Click Load Model and an informational message will inform you that the initial model has been loaded and verified FIGURE 127 Initial Model Verification Message as shown in Figure 127 Click OK 7 A second informational message will inform Eem you that the final model has been loaded and ieee verified as shown in Figure 128 Click OK ay The ode 6 CCA IM ice the OT OPOE ETEEN The initial model is the model you specified as is The final model is the initial model plus modifications necessary to make it usable by BOA 8 The model units used in the SAT file will appear at the bottom of the Geometry Model Parameters dialog In this case the units are set to inches FIGURE 128 Final Model Verification Message 9 Click OK to
18. 91 e Centroid The centroid center of gravity of the beam on the specified plane The Centroid by dropdown box provides three options for specifying the planar beam centroid e All Particles Uses all planar particles of all generations to compute the centroid e Primary Particles Uses only the primary particles This is identical to the first method if there are no secondary emissions e Input Coord Allows for manual entry of the coordinates The Input Centroid fields become active and you must enter two of the thee coordinates x y and z The third coor dinate is fixed per the selected plane e Output File The fine name given to the output file when it is generated The default filename is Papa ppo l This file is stored in the case directory Next select either the Output File or the Output File amp Plot radio button Then click the Generate button The following will occur 1 The output file is automatically generated and saved in the current case directory to the file name specified in the Output File edit box 2 If the Output File Qieci pecpeee a eal amp Plot radio but Fie View hows Moda Ambate Memng Gate Viem Reuss Took Hdp ton is selected a plot like the one shown in Figure 111 appears in the main win dow In addition the Plot Parame ters button in the Plot Statistics sec tion becomes active This button accesses the Plot Control Parame ters dialog which en
19. A directional current vector can be defined as open or closed An open directional current vector should be used when the inlet and outlet faces do not overlap e g a horseshoe or a C Core con ductor A closed directional current vector should be used for conductors with varying cross sec tion Solenoid cylinders of uniform thickness should use the Analytic Cylindrical Solenoid option discussed above rather than the Directional Current option The Analytic Cylindrical Solenoid option is computationally faster and more accurate Note that a closed conductor does not physically have an inlet or outlet however an inlet and out let must be specified so that boundary conditions can be prescribed for solving the current density sub problem For this option to work properly as a closed conductor the geometry model must consist of two connecting parts e g for a nonuniform cross section cylinder the conductor should consist of two 180 degree halves or a 90 degree piece and 270 degree piece of a cylinder etc To define a part as having a directional current vector set the Select Current Vector Type drop down box to Directional Current and click the Add Part s button next to it This will bring up the main window containing the geometric model 42 5 10 BOA Version 4 User Manual v0 5 updates in progress If you are defining an open conductor select the desired part 1 e the single part that represents that open conductor by pressin
20. Assignment dialo To assign a surface charge density to a surface click e the Surface Charge Density Add button beneath the table This will bring up the Main Window containing the geometric model Select the desired surface by pressing Ctrl Left mouse button and pressing Enter The Surface Charge Density Assignment dialog in Figure 22 will appear Enter the desired Name and Charge Density and specify the Color If the surface is already named in the geometry model the Name will not be editable Click OK to complete the assign ment and the item will appear in the table Surface Charge Density Assignment X To modify a surface property once it is defined select the item in the Name OO table and click the Modify button The appropriate dialog will appear Color fred and you can edit the values To delete a surface property select the item in the table and click the Delete button Charge Density Assigned to Selected Face s C finches 2 cones FIGURE 22 Face Surface Charge Density Assignment dialog box 3 8 2 Beam Optics Attributes The Beam Optics tab shown in Figure 23 enables you to make the attribute assignments required for beam analyses The screen includes sections for specifying the following BOA Version 4 User Manual v0 5 updates in progress 5 10 23 e Beam Optics Attribute Assignment Properties P arameters Electrostatics Beam Optics Optimizer Misc Beam Optic Parameters Emission Curent
21. Convergence Criterion 0 005 Electric Field Convergence Criterion 0 005 e Emitter Assign ments Charge Neutralization Factor i Maximum No of Secondary Generations 3 j External Magnetic Emitter Assignments Field E mitter Injected_Emitter red Stage 1 F Secondary Emitter llow Optic ally Trans Stage 2 Face Saco Enia i Stage 3 Face Secondary_Emitter yellow p arent P arts Stage 3 Wall Secondary Emitter yellow Optic al Surface Thermionic Emitter Add Injected Emitter Add Secondary Emitter Add Assignments Peri ae External Magnetic Field Options Optically Transparent Parts odic and Reflective 1D Axial Imported Magnetic Flux Density v surfa ce s Emitter 3 yellow Add Edit and Verify P Delete 3 8 2 1 Beam Optic Paramete rS Optical Surface Assignments Inlet Name The Beam Optic Parame Mody ters section includes the Delete following parameters Periodic Add Reflective Add Emission Current Conver gence Criteria This is one of the two conver gence criteria for the BOA algorithm The solution converges if both EQ 1 and EQ 2 are met FIGURE 23 Attribute Assignment dialog Beam Optics tab Emission Current spent SE In lt Emission Current Convergence Criteria EQ 1 Emission Curr CN ourre nt iteration The default value is 0 005 Potential Convergence Criteria This is the second convergence criterion for the BOA algorithm The solution converges if both EQ and EQ 2 are met
22. Display Vector Field pay Calculated Flux Density Displayed Flux Density C off S Min 1 1e 038 Min 1 2478902772 On Max 1 1e 038 Max 2 402398145 Display Vector Field Comp none Number of Contours 10 C x Component V Show Contours Apply y Component C z Component MV DisplayLegend Horizontal Vertical Magnitude eval Initial Mesh Display Mesh Off Clipping State mm Clipping C On Show Mesh Outline Mesh Info 0 459 0 00242 0 454 gt Magnetic Flux Density 1 ee ee FIGURE 87 Magnetostatic results default settings GET REAL CASE PICTURE correspond to the default settings on the Magnetostatic Display Parameters dialog Magnetostatic Flux Density radio button selected Display Vector Field set to On and Display Vector Field Component set to none This Magnetostatic Display Parameters dialog 1s shown more clearly in Figure 88 It includes the following sections e Iteration Selection confirm this has been removed IT HAS UPDATE ALL PICS e OD ID Display The upper left portion of the dialog provides buttons for accessing the Single Point Magnetostatic Field Extractor dialog via the Data Point button and the Magnetostatic Line Plotter dialog via the Line Plot button 74 5 10 BOA Version 4 User Manual v0 5 updates in progress e 2D 3D Display The majority of the dialog is devoted to the controls for 2D and 3D display of the magnetosta
23. Example of CCR format 2 Papa Output file ppo file One can slice the beam to obtain particle planar attribute on a plane then use its output the ppo file as an injected beam file of type CCR format are these three options mentioned in the Injected Emitters dialog section If the injected emitter requires a transformation as specified in the boa gui then the original injected plane will be transformed to the actual injected plane per the GUI inputs 6 1 2 2 Magic3D Format The Magic3D file format like the BOA format which is for a DC Cartesian beam contains the complete 3D particle attributes at the original injected plane It has the form I A xim yim z m y m s _ yvylm s w m s Similar to the BOA beams if the Magic3D injected emitter is a transformed type its original injected plane will be transformed to the actual injected plane 6 1 2 3 Magic2D Format 180 5 10 BOA Version 4 User Manual v0 5 updates in progress The Magic2D file format is for Polar beams Its spent beam axis is assumed to be always the z axis Thus the original injected plane will always be the rO plane normal to the z axis and the direction of the beam is assumed to always point to the same direction of the positive z axis A Magic2D beam is always a transformed type 1 e it always requires coordinate transformations The format of a Magic2D beam is I A zim rim y m s y m s yelm s 6 1 2 4 Christine Format The Christin
24. Imported Magnetic Flux Density Setting the External Magnetic Field Options dropdown box to the Maxwell 3D Imported Mag netic Flux Density option enables you to import a magnetic Maxwell3D Parameters Maxwell3D File Bi amezn Field Scale 1 Trans Vector CAD Axes To 0 in Ty 0 in Ta i Alignment of CAD Model ta Z Axis E Field Parameters flux density file in the Maxwell ERAEN er art Be 3D format This option brings up First Point the dialog box shown in foe ow fea pss nde aa Figure 33 Second Point Starting Point S EE y z 11 0629 Se pi y i in Fii Z A Mum of Plot Points Use the Browse button to locate the desired Maxwell 3D file Plot Parameters Open gt gt Plot to Verify Field ok Cancel Specify the Field Scale Transla tion Vector CAD Axes Align ment of CAD Model to Z Axis FIGURE 33 Dialog for importing a Magnetic Flux Density File in Maxwell 3D format and Grid Unit if appropriate See BOA Magnetic Flux Den sity fef file section above for definitions of these parameters Maxwell 2D XY Imported Magnetic Flux Density Setting the External Magnetic Maxwell D XY Parameters Field Options drop down box to Marwel E ey File Eas TA Field Scale the Maxwell 2D XY Imported Browse iz Trans Vector CAD Ases Tx oo in Ty ooo in Tz fo in Magnetic Flux Density option Alignment of CAD Model to Z Asis z oF Bz co Tesla Grid Unit allows y
25. Yes default No Vacuum Attribute Assignment Focus lcd ve Vaca Properties dialog Hiii No Vacuum shown in Figure 130 will appear with the i Electrostatics tab active 2 The table in the Prop E PNN erties at the Part Level Materiak Material Selector z section shows all parts containe d in the geom Properties at the Surface Level etry file The table also d contains the Back T ground part if it was not already included in the geometry file The Background part is cre Voltage Surface Charge Density Add ated by BOA based on the settings in the Model Geometry Cancel Parameters dialog The part names are FIGURE 130 Attribute Assignment dialog box Electrostatic tab identical to the names provided in the geometry file and they are not editable Initially BoaGui will assign default attributes to all parts Typically the user will want to change most or all of the assigned attributes Initially the Visible checkbox is checked for all parts except the Background part 3 Highlight the Mod Anode part Set the Color dropdown box to cyan Check the Voltage Assigned to Entire Part checkbox and enter O in the data entry box Set the Material drop down box to Copper in the Relative Permittivity section Note Material assignments are not actually necessary for electrostatic or electrostatic beam analyses Vacuum which is the default material produces a correct result However for a magnetostatic
26. an inlet surface and an outlet surface When particles exit the outlet surface par ticles with identical attributes e g velocity current re enter the inlet surface In effect it is as if the model is infinitely repeating itself To add a pair of periodic surfaces click on the Periodic Add button beneath the Optical Surface Assign ments table shown in Figure 39 This will bring up the Periodic Sur bial eeepc taut x Teg Color default v Jaces Assignment dialog shown in Figure 40 To define the inlet peri m odic surface click the Select button in the Inlet Periodic Face section This will bring up the window con taining the geometric model Find the surface you want to define as the inlet periodic face and select it by pressing Ctrl Left mouse button Click enter to complete the selection The Periodic Surfaces Assignment dialog will reappear Enter the desired Name if editable and select a Color Remember the Name field will not be editable for any surface that already has a name in the CAD model To define the outlet periodic face repeat the same process using the Select button and Color dropdown box in the Outlet Periodic Surface section Click OK to complete the assign ment The periodic surfaces will appear as an entry in the table Periodic Surfaces Assignment Inlet Periodic Face Outlet Periodic Face pS leet bp Slee FIGURE 40 Periodic Surfaces Assignment dialog Reflective Surfaces Refle
27. analysis this field must be set correctly e g if there is a part made of iron the part must be assigned as such In this exam ple each part is assigned a material for illustrative purposes It is good practice to make mate rial assignments for each part in an analysis because then if you convert the case to include a BOA integrated magnetostatic case the materials are already assigned BOA Version 4 User Manual v0 5 updates in progress 5 10 105 4 Highlight the Cathode part and assign the attributes shown in Table 1 below PatName Visible Color Voltage Vol Change Rel Permittrvity Material Name Inf Domain Tag Mod anode Yeg cyan 0 No 1 0 Copper No Cathode Tes red 18000 No Tungsten No 2 Focus Electrode Tes yellow 18000 Mo Molybdenum No 3 anode Yez green 0 No 1 0 Copper No 4 Background Mo cyan No No 1 0 Vacuum Yes A 0 8 lt gt TABLE 1 Attribute Assignments for Jlab Klystron Gun case 5 Highlight the Focus Electrode part and assign the attributes shown in Table 1 above 6 Highlight the Anode part and assign the attributes shown in Table 1 above 7 You have now completed the definition of properties at the part level The Properties at the Surface Level section allows you to define properties for specific surfaces on parts in the elec trostatic geometry model For this example there will be no entries in this table 8 Click OK to close the Attribute Assignment Properties dialog
28. be blank Use the Browse button to locate the desired directory for the new Project If the desired directory does not exist yet type in the desired name and BOAGui will created the directory for you Specify the Project Name in the box provided In this example the Project Name is Jlab Klystron Gun Project Click OK The new Project will appear in the Project Case Manager tree control on the right New Project Location BE oa Examples Browse Project Name lab Elystron Gun Project Default User Maternal Library Location CAD ocuments and Settings alene Application Data cancel FIGURE 121 New Project Dialog Box side of the BOAGui screen Behind the scenes a Project folder will be created in the specified location The project folder will contain the BOA Project file boa and all associated Case folders Right click on Project Jlab Klystron Gun Project in the Project Case Man ager tree control The popup menu shown in Figure 122 will appear Select Add New Case The dialog shown in Figure 123 will appear Initially the data entry fields will be empty Specify the Case Name in the box provided In this example the Case Name is Example 1A Select Electrostatic in the Analysis Type dropdown box If desired add Case Comments to describe the case as shown in Figure 123 Leave the Open Case Now checkbox checked 4dd Mew C
29. be skipped per time step when reading the Magic2D 3D spent beam data to reduce computation costs Enter 1 to use all par ticles Number of Skipped Timesteps is the number of time steps to be skipped when reading the Magic2D 3D spent beam data file to reduce computational costs Enter 1 to use all steps e Christine Format The Christine file format is available only if the specified emitter surface is a flat plane having a regular shape such as a circular disk or a rectangular plate Specify either Polar Coordinates or Cartesian Coordinates The axis of the original spent beam the spent beam defined in the file is assumed to be the z axis Thus the original injected plane will always be the xy or r plane normal to the z axis and the direction of the beam is assumed to point in the direction of the positive z axis The original injected plane will be transformed to the actual injected plane The second section of the Injected Emitter Parameters dialog allows you to verify that the values 28 5 10 BOA Version 4 User Manual v0 5 updates in progress for the Number of Particles the Injecting Current and the Injecting Power are what you expect Click the Verify button to perform the verification In the Meshing Parameters section the Depth of Finer Mesh Region extended from Emitter parameter allows you to define a region of finer mesh around the emitter It is used only when adaptivity is turned on 1 e when Max Number of Adaptivi
30. checking there seems to be a bug where surface select allows you to select anywhere is this true for other surface select places in the GUI i thought not but check The Measure Distance feature allows you to measure the distance between two endpoints in the graphics display window Both points must be on a part Use the Control Left Mouse button to select the two endpoints Boa Gui will display the selected points as small balls After completing selection of the second point a message will appear showing the measured distance between the two points To abort the Measure Distance function prior to completing a measurement hit the Ese key WARNING Before using this feature you must set the following parameters on the View pull down menu 1 Set View Representation to Orthogonal 2 Set Orientation to one of the following Front Back Left Right Top or Bottom BOA Version 4 User Manual v0 5 updates in progress 5 10 97 If the View pulldown menu parameters are not set correctly the measured distance will be incor rect TBD Have we implemented error checking in BoaGui Thuc says he does not know about this but BV explicitly told me this originally 3 12 3 Material Properties The Materials Properties database consists of a set of materials and the associated material prop erties needed for BOA analyses These proprieties include e Atomic Number used with secondary emitters e Atomic Mass used with secondary emitters
31. dialog 3 11 2 2 2 Data Point Extraction BOA Version 4 User Manual v0 5 updates in progress 5 10 81 The Data Point button in the Single Point Magnetostatic Field Extractor pero OD ID section of the Magne Point Location You may enter the coordinates of a point directly into the edit boxes tostatic D LSp lay Parameters or dick on a button to use the cursor to select a point in the model i 7 e dialog shown in Figur 88 a The 30 Select button enables you to select a point anywhere within the bounding box of the model The Surface Select button will only br Ings up the Sing le Point lo allow you to select a point on the surface of the model Magnetostatic Field Extractor dialog shown in Figure 99 This dialog enables you to extract the value of the desired field at a particular point Use the Field to Inspect radio buttons to select the desired field 737 3 3D Select Surface Select Field to Inspect Field Value at Selected Point f Magnetic Flux Density B T Magnetic Field H A m lo o lo 0 x C Current Density J A m 2 y Z mag Magnetic Flux Density B Extract Close Magnetic Field H oo B FIGURE 99 Single Point Magnetostatic Field Extractor Current Density J There are three different ways to specify the desired point 82 Direct entry Allows you to enter the x y and z components of the point directly into the edit fields provided on th
32. enabled eS a T whenever the Analysis Goal Functions sub menu is set to Opti a ae e mizer rather than Single F E Case Use it to make the S f attribute assignments required for optimization MramzeSutace Becisc Fald Select Sutace Cer M m a runs It contains four sec tions The top section Goal Functions 1s used to specify the goals for the ee a optimization The Optimi zation Method defines the keetes pn wore F Fa method used for the opti oo _ mization calculations The a a Sa el al Optimized Parameters sec Tea tion defines the parameters to be optimized and the r bottom section defines the season Execution parameters for See ee eee the optimization run cain ici oe ee Biris GK Canal 3 8 4 1 Goal Functions a FIGURE 49 Attribute Assignment dialog box Optimizer tab This section includes two options for the optimization s Goal Function Optics and Minimize Surface Electric Field For an analysis including beam optics both options are available For an electrostatic analysis only the option the to minimize the surface electric field is available When the Goal Function radio button is set to Optics you can specify the Targets for the Beam Current Beam Diameter and or Beam Ripple Use the checkbox in front of each to indicate which to make active The Beam Ripple can be specified only when there is a magnetic
33. field e when Analysis menu is set to either Electro Magnetostatic Beam or Electro Magneto Self Field Beam For each Target specify a weight The larger the weight the more important that goal is in the goal function All three targets are determined from the beam characteristics at multiple planes and then averaged for the goal function These planes are specified in the Sampling Coor dinates section Choose the beam axis the Along Axis dropdown box the beam direction the Positive and Negative radio buttons Position plane coordinate Number of Positions planes and Position Range These ranges are centered at the specified position Thus if the plane Posi tion is 1 0 and the Position Range is 0 75 then the minimum position would be 0 25 and the maximum position 1 75 The planar particle attributes are used to compute these beam character istics and they need a beam centroid to be transformed to cylindrical coordinates There are three options for specifying this centroid BOA Version 4 User Manual v0 5 updates in progress 5 10 45 e All Particles computes the centroid by a simple averaging of all particle primary and sec ondary coordinates on the plane e Primary Particles uses only primary particles neglecting all secondaries Input Coord lets the user specify the centroid coordinates manually Note that the first and the second option are the same if there are no secondary em
34. give you the option to cancel or continue with the termination The last iteration available for post processing depends on the settings in the Beam Optics Parameters section of the Execute Boa dialog 58 5 10 BOA Version 4 User Manual v0 5 updates in progress The first two menu items initiate the dialog shown in Figure 67 It includes sections for Field Solution Parameters Beam Optics Parameters Logging Options Restart and Execution Prior ity These sections are discussed below When you click Execute a DOS win dow will appear indicating progress during BOA execution Once the pro cess 1s completed hit any key to close D Execute Single Case Electro Magnetostatic Beam Field Solution Parameters Mas Number of Adaptivity Passes p Adaptivity Objective 0 25 E Integration Order Beam Optics Parameters Number of Allowable Iterations i 0 fe Mas Num of Self Field Cale i Output Solution and Source Fields Every i therations Min Mur of Iterations 4 ay E io iterations Self Field Relative Tol 001 the DOS window and return control back to the user interface Output Trajectory Data Every E Iterations Electrostatics without particles Performed after each converged beam calculation Logging Options 3 10 1 1 Field Solution Parameters MW Log to Screen W Lag to File Example 2B _E log Log File H The Field Solution Parameters section TADE of the Execute BOA dial
35. in Figure 166 5 The next surface to define is on the Mod Anode It will be easier to select if you make only the Mod Anode visible Click the Attributes menu item to bring up the Attribute Assignment Prop erties dialog In the Properties at the Part Level table on the Electrostatics tab select the Focus Electrode and uncheck the Visible checkbox then select the Mod Anode and check the Visible checkbox Click OK to close the Attribute Assignment Properties dialog 6 The Electrostatic Mesh Parameters Optional dialog will still be open In the Local Mesh Refinement section click the Add Surface s button beneath the table This will bring up the graphics display window containing the electrostatic geometry model 7 Turn the model so that the Mod Anode is oriented as shown in Figure 169 The goal is to con trol the mesh density on the portion shown in purple in the picture on the right As before select Add Surface s in the Local Mesh Refinement region and use the Ctrl Left mouse button to select one of the surfaces This will select a named surface with two tags surface tags 14 and 17 FIGURE 169 The Mod Anode Left image is prior to defining the ModAnodeSurface model surface Right image is after defining the ModAnodeSurface model surface 8 Click Enter The dialog box in Figure 165 will appear The Name box will not be editable It will be prepopulated with the name ModTunnel This is the name given in the JLAB Gun SAT
36. is shown in Figure 219 BOA Version 4 User Manual v0 5 updates in progress 5 10 165 The next step is to assign attributes by opening the Attributes Assignment Properties dialog see Figure 221 The return was initially assigned as iron with a fixed permeability of 3200 We Attribute Assignment Properties Magnetostatics Properties at the Part Level e E e pa a be oey Relative Pemeability Material Vacuum 1 0 Feme Format Edit directly Value 1 0 Add Pats Mody Delete _ Aa Mody Deke OK ca FIGURE 221 Attribute Assignment Properties dialog shall check the validity of the this assignment later The coil was assigned as copper but it could also be left as vacuum for this problem where only the permeability is of importance The FE is the gun part that is included for reference Its material is set to vacuum The middle part of the dialog contains the means for assigning the coil currents In this case we have a simple solenoidal coil and Analytic Cylindrical Solenoid was selected as the Current Vector Type The coil was selected by pushing Add Parts the selecting the appropriate part on the model graphic by as usual holding the control key down while clicking the left mouse button Hit return to exit the model graphics screen and bring up the Cylindrical Solenoid dialog shown in Figure 222 All of the entries except t
37. of a view representations The left image shows an Orthogonal representation of a cylinder The right image shows a Perspective representation of the same cylinder gave me if it is true can we prohibit this in the GUI if not then remove this comment Experiment with both representations to determine which option you prefer for general viewing and printing However always use the Orthogonal representation when using the Measure Dis tance feature Refresh View Refreshes the display such that the current orientation remains fixed but the entire model is visible and centered within the graphics display window This can be used to quickly view the whole model after zooming in on a specific region Typing the R key will also refresh the display BOA Version 4 User Manual v0 5 updates in progress 5 10 13 Reset View Resets the display to the isometric view This command is identical to the Isometric item on the File gt Orientation menu Model Geometry Display Resolution Controls the Relative Resolution display of curved sur faces Curved surfaces are actually composed of sections of flat surfaces With a higher resolu tion more flat surfaces are used to render the curved surface and the surface appears smoother The Relative Resolution can be set between zero and one with one being the highest resolution and zero being the lowest The higher the resolution the longer it takes for the computer to gener ate the initial displa
38. of the contour plot If the checkbox is unchecked the field appears as a standard continuous contour plot like the one shown in Figure 91 In this figure extent clipping is used to reveal the internal structure Extent clipping is discussed in a subsequent section Alternatively if the Show Contour checkbox is checked you specify Number of Contours and the display will group similar values into the specified number of discrete contour surfaces 1 e iso surfaces as shown in Figure 92 FIGURE 91 Contour plot for Magnitude of Magnetic Flux Density with Show Contours unchecked The Displayed Min and Max values dictate the upper and lower values displayed These values initially default to the Calculated Min and Max values The Calculated Min and Max values appear for reference making it easy to reset the values The Display Leg end checkbox turns the legend display on and off and the radio buttons labeled Hori zontal and Vertical dictate the legend place ment The Initial or Adapted Mesh section con trols the display of the mesh It refers to the last mesh used in the generation of the results either Initial if adap tivity is off ue FIGURE 92 Contour plot for Magnitude of Adapted if adaptivity is on in the graphics Magnetic Flux Density with Show Contours checked window Use the Display Mesh radio button 10 iso surfaces to show or hide the mesh The Show Mesh Outline checkbox to display an outline of th
39. optics attributes 1 Open the Attribute Assignment Properties dia log Click on the Attributes menu item In the next few steps the goal will be to define the surface of the cathode as a thermionic emitter In order to better see the cathode make sure the Anode and the Mod Anode are invisible by unchecking the Visible checkbox for both 2 Rotate the model so that the cathode surface is clearly visible as shown in Figure 158 To cen B FIGURE 158 Geometry rotated so that ter the visible model open the View menu and eathode emitter surface is visible click Refresh View 124 5 10 BOA Version 4 User Manual v0 5 updates in progress 3 Click on the Beam Optics tab The dialog shown in Figure 159 will appear Unlike Figure 159 however the Emitter Assignments table will be blank Attribute Assignment Properties Electrostatics Beam Optics Optimizer Misc Beam Optic Parameters Emission Current Convergence Criterion 0 005 Potential Convergence Criterion 0 006 Charge Neutralization Factor f Masimum Mo of Seconda Generations Emitter Assignments hane O e O Cow Face Tag Enable emitter Thermionic_E mitter orange Thermionic Emitter Add Injected Emitter Add Secondary Emitter Add gt External Magnetic Field Options r Optically Transparent Parts Delete M Optical Surkace Assignments Inlet Name Type O Inlet Color Inlet Tag Outlet Marne Outlet Color Modify Delete Penodic
40. parti cle Use the Enable checkbox to enable or disable the emitter for the simulation Disabling an emitter allows you to temporarily turn off an emitter without deleting it cancel FIGURE 26 REPLACE new Tag filed Secondary In the Surface Emission Properties section use the radio buttons to select the desired secondary model The Yield option uses a simple Secondary Yield Coefficient to compute the yield The Atomic Specification option uses a Monte Carlo simulation to compute the yield based on the val ues entered for Atomic Number Atomic Mass and Material Density in grams per cubic centime ter For either secondary model you can enter the required parameters in one of two ways e Enter the parameter values directly or BOA Version 4 User Manual v0 5 updates in progress 5 10 29 e Select a material from the Select a Surface Material drop down box located above the radio buttons BOAGui will automatically populate the values associated with the selected material in the Material Properties database for each parameter See Section 3 12 3 for a discussion of the Material Properties database The Number of Secondaries 1s used with the Maximum Number of Secondary Generations defined on the Beam Optics tab of the Assign Attributes dialog as shown in the following exam ple Assume Number of Secondaries 3 and Maximum No of Secondary Generations 2 When a primary hits a secondary emitter three electrons are emitt
41. per analysis In the current beta implementation each beam from each injected plane requires a separate file for injected particles By convention the extension for the Injected Beam Parameters filename is ibf However this is not a requirement 6 1 2 1 BOA Format or CCR Format There are three acceptable CCR formats the Injected Emitters e CCR Format 1 the original CCR format used in early beta e CCR Format 2 a newer CCR format e ppo file a k a Papa output file One can slice the beam to obtain particle planar attribute on a plane then use its output the ppo file as an injected beam file Format 1 The BOA file format contains the complete 3D particle attributes at the original injected plane Its form is simply pID x u yla zfuy v fuy s vylur s v uy s TAI where pID is an identifier for the particle It must be an integer number and distinct for each parti cle X y Z represent the initial particle position in global coordinates The position units shown as uy above to indicate user length correspond to the Model Units defined on the Geometry Model Parameters screen e g 1f the Model Units are set to inches the position coordinates are assumed to be in inches 178 5 10 BOA Version 4 User Manual v0 5 updates in progress vx vy vz represent the initial particle velocity The velocity units correspond to the Model Units defined in the Geometry Model Parameters screen e g 1f the Model Units are set t
42. prompting you to enter the necessary parame ters The specifics of the dialog will vary depending on the selected External Magnetic Field Option but in general all of the dialogs are similar and contain the same basic elements e Field Definition The upper portion of the dialogs includes all parameters necessary to define the selected magnetic field type in three dimensions 30 5 10 BOA Version 4 User Manual v0 5 updates in progress e Field Plot The Plot to Verify Field button allows you to create a linear plot of the magnetic flux density in order to verify that the field is defined correctly e The Field Parameters section provides options for plotting the field data To make this section active check the Enable checkbox TBD expand this section to include discus sion of all fields e The Plot Parameters opens a hidden section of the dialog that provides additional controls such as Plot Characteristics 1 e the appearance of the plot including title axis labels etc TBD Refer to the Plot section earlier in the manual once that is complete The sections below describe the dialogs triggered by each External Magnetic Field Option Uniform Magnetic Flux Density Setting the External Magnetic Field Options dropdown box to Uniform Magnetic Flux Density allows direct entry of a uniform magnetic flux density This option brings up the dialog shown in Figure 27 Enter the three components of the uniform magn
43. representing the solenoid On the Directional Current Vector dialog leave the Closed Conductor check box checked Pick one face for the inlet and the opposite end as the outlet to specify the current direction Because the check box is checked BoaGui will automatically find the other half and complete the current assign ment for you Note that alternatively you could achieve the same result by defining each half separately as having an open directional current However if you do this you must make sure the currents flowing in both parts are defined in the same direction To modify any item in the Current Density Attribute Assignment table once it is defined select it in the table and click the Modify button The appropriate dialog will reappear and you can edit the values To delete a current density definition select it and click the Delete button 3 8 3 3 Homogeneous Dirichlet Boundary Condition Assignment The Homogeneous Dirichlet BC BN 0 section on the Magnetostatics tab Figure 47 enables you to specify surfaces for which the normal component of the magnetic flux density Bn will be set to zero TBD ask Thuc or Mike to elaborate on when it makes sense to do this BOA Version 4 User Manual v0 5 updates in progress 5 10 43 To add such a surface click on Add button beneath the Homogeneous Dirichlet BC BN 0 woe a i ts gt speed Lapel Pi gt ig x Pte see 1 SM ps Sat Ba a a tie yee estas of tan aa 2 ea r cc Ss
44. secondaries check the desired Generation No in the Emitters and Trajectories section For example Figure 216 shows the primaries and the first generation of secondaries The Generation No checkboxes are checked for 0 and 1 4 Figure 218 shows the primaries and the first and second generation of sec ondaries The Generation No check boxes are checked to include 0 1 and 2 5 Figure 218 shows the primaries and the first second and third generation of secondaries The Generation No checkboxes are checked to include 0 1 2 and 3 6 You can also turn different emitter surfaces on and off using the check boxes in front of the Emitter names in the Emitter table Play around with these controls to see how the display changes Zoom in and out to get a closer look at the trajectories 7 If desired you can also change the color of the trajectories Open the View menu and select Color gt Trajec tories On the resulting Color Trajec tories dialog select the desired generation and click Change Color The Color palette dialog will pop up Select a color and click OK to change the color and close the Color palette To close the Color Trajectories dia log click the Close button 4 2 2 8 Viewing Electrostatic Results You can also view the Electrostatic results as you did in Examples 1A and 162 5 10 FIGURE 216 Primaries and First Generation of Secondarie
45. the default values Click Execute A DOS window will appear indicating progress during BOA execution Because adaptivity is turned on the runtime will be longer than the first run When BOA com pletes the following text will appear at the bottom of the window Proceed to View Results Press any key to continue Hit any key to close the DOS window and return control back to the user interface 4 1 2 4 Viewing Electrostatic Results with Adaptive Meshing Execute Single Case Electrostatic Field Solution Parameters Integration Order f Max Number of Adaptivity Passes 2 Adaptivity Objective fo 25 E Beam Optics Parameters Number of Allowable Iterations 10 Min Num of Iterations 4 E E C fio Iterations Max Num of Self Field Calc ff Self Field Relative Tol fon Output Solution and Source Fields Every fi Iterations Output Trajectory Data Every fi Iterations Electrostatics without particles Performed after each converged beam calculation Logging Options V Log to Screen V Log to File Log File Name Example 1B_E log Restart 8 Select Iteration To restart a previous execution of Boa first check Enable then choose the particle iteration from the drop Execution Priority ee If you want the computer to spend less time executing boa Priority Level Lowest v and more time on your other programs lower the execution priority level to Lower or Lowest coca
46. the dialog The Electrostatic line Plotter dialog will appear Change the Field to Plot radio but Electrostatic Line Plotter ton to E l CG r C F j e ld E and le ave the You may enter line endpoint coordinates directly into the edit boxes or click on a button to the right to select endpoints 3D Select Surface Select Mag checkbox checked with the cursor The 3D Select button enables you to locate endpoints anywhere i Field to Plot ithin the bounding box of the model The Surface Select butt Set the Starting Point and Ending Fae wl only alow you to locate endpoints on the surface of the model point for both X and y to 0 4 Leave charge Densit Starting Point Ending Point Number of Points to Plot the Starting Point and Ending Point amp tecr riel E a ee x o 0 f y Comp y ol Abscissa Type for zat the default C Electric Flux Density D J zComp 2 Linear Iv Mag 0 77645 Arc Length Click Plot The line plot will appear in the main window as shown in pire ESbeE Cpt Dai Figure 152 FIGURE 153 Electrostatic Line Plotter BOA Version 4 User Manual v0 5 updates in progress 5 10 121 6 Compare this graph with the Line Plot of the E magnitude you created for Example 1A in Figure 143 on page 115 Notice that the peak field with adaptivity Figure 152 1s higher and smoother at both bottoms of the bell curve than the peak field without adaptivity Figure 143 4 1 2 4 3 Viewing additional r
47. the geom etry model 6 Zoom in on the emitter by right clicking the mouse and moving it forward or up Select the emitter sur face by pressing Ctrl Left mouse button The emitter surface will appear selected it will change from yel low to green as shown in Figure 193 Click enter to complete the selection FIGURE 193 Defining the injected emitter 146 5 10 BOA Version 4 User Manual v0 5 updates in progress 7 The Injected Emitter Parameters dialog shown in Figure 194 will appear though the Injected Emitter File Name data entry field will be blank initially In this case the surface you selected corresponds to a part surface named Emitter in the geometry file Therefore the Name box automatically shows the name Emitter and it is not editable If the selected surface did not correspond to a named part surface in the geometry model this field would be editable Leave the Color dropdown box set to red Injected Emitter Parameters Mame Emitter Iv Enable Injected Emitter File Mame MSDC_injectedEm ibf File Format for Planar Emitter BOA Format C No Transformation Required Transformation Required Asis of Original Spent Beam Magic2D Format Magic30 Format TN o O Christine30 Format iF Da o Verify Humber of Particles Injecting Current A Injecting Power a kia Meshing Parameters Depth of Finer Mesh Region extended from 0 in Emitter only in effect wi
48. the model The Surface Select button e will only allow you to locate endpoints on the surface of the model voltage Charge Density Starting Point Ending Point Number of Points to Plot 1000000 Boe Electric Field E p 9 fo 1a l y Comp s y y oO Abscissa Type Electric Flux Density D M 2Comp z 0 77645 sees 800000 Arc Length amp a Plot Parameters H Plot Exit e j o mj 600000 4 C On V Display Legend C Horizonta Display Scalar Field m Scalar Field Parameters v 400000 i C off Calculated Min Max Displayed Min Max l Ex i Min 18008 Min 18008 C Ey 18008 200000 4 i Max 159 Max i590 i z Number of Contours 10 4 i i f Aopy 0 0 0 5 1 0 1 5 2 0 2 5 Scalar Slicing Display Legend Horizontal Vertical Point Distances Initial Mesh r Clipping State fin 1 1 Display Mesh Clipping gi off Con cop Min fair xMxfii Scalar Visibilit on 1 1 1 1 of C Gn y Min jo yMax i1 1 8 0 78 F Show Mesh Outline z Min 1 8 z Max 0 78 Mesh Info Apply Hide this dialog temporarily Hide Close Case Example 14 Iteration Current FIGURE 143 Line plot of E magnitude along beam axis i e Z 1 The Electrostatic Display Parameters dialog should still be open BOA Version 4 User Manual v0 5 updates in progress 5 10 115 2 Click on the Line Plot located in the Flectrostatic Line Plotter OD ID Di
49. the selected Case from the current Project You will be given two options Save Case s a e k r a 3 F an en Te as a 1 m E Remove the Case from Project and Delete the Case Directory and all of its FIGURE 5 Project Case Manager shown with Contents This option deletes the Case Case Menu opened directory completely e Remove the Case from Project The case will remain in the Project directory but it will not be accessible via the Project Case Manager With this option the Case can still be re imported but its name cannot be reused for a new case Clean Up Case Deletes files created by a previous BOA run of the case Deleted files include e SSV e SSS e Dws e ebm e out e cde e tdb e fef Note The clean up feature removes all fef files generated by the case but does not remove those imported into the case such as those generated by another case e IC e trj e msd e MSS e spd e res e sle BOA Version 4 User Manual v0 5 updates in progress 5 10 9 See Section 6 3 Appendix C Internal Files on page 183 for a description of all files created by Boa TBD check appendix i think some files were added so we need to mention here Display Edit Comments Allows you to view and edit the comments for the selected case Close Case Closes the current Case If you have made any changes to the Case you will be given the option to save the Case or
50. to Job Monitoring graph Status bar FIGURE 3 Main BoaGui Screen Prior to opening a Case described in the next section only the Project Case Manager section will contain information It will display a tree control that shows the name of the open Project along with all of the Cases contained within it Right clicking on the Project name or on one of the Case names will bring up menus that allow you to manage your Cases and Project e g open a Case add a new Case to a Project etc Once you open a Case with a defined geometry model the model will appear in the Main Window When you execute a run the Corner Window will display a graph that monitors parameters for the job These job parameters are specified via the Execute gt Job Parameters menu The pulldown menus at the top of the screen control most of the functions in BoaGui The remain der of this chapter describes the basic function of each menu item as well as the menu items asso ciated with the Project Case Manager The subsequent chapter contains several example tutorials The first time user may find it easiest to get familiar with the software by working through the examples first See Section 4 0 Exam ples on page 100 BOA Version 4 User Manual v0 5 updates in progress 5 10 7 3 3 Project Case Manager The Project Case Manager appears in the upper right hand window of the screen whenever a Project is open It consists of a tree control containing al
51. via the View Results Beam Analysis menu On the Plot Planar Particles dialog select a cross section plane that is normal to the beam and between the control grid and the anode Enter the desired values in the remaining fields in the Planar Particles section and then click Generate The Planar Statistics section will display the beam current 3 11 5 Generating Case Summary This Generate Case Summary menu item generates a separate file containing summary informa tion for the case The file is named Case Name_IOS txt where Case Name is the name of the cur rent case and IOS stands for Input Output Summary An information message will appear showing the exact location and filename for this file 3 11 6 Viewing Optimizer Log TBD Waiting for optimizer case from M BOA Version 4 User Manual v0 5 updates in progress 5 10 95 3 12 Tools q g View Results Tools Help The Tools pulldown menu shown in Figure 116 Cibo includes Measure Distance e the Cibo tool a tool for creating an injected OH ae License Installer beam profile e the Measure Distance tool e the Material Properties database e the License Installer FIGURE 116 Tools Pull down Menu 3 12 1 Creating an Injected Beam Profile Cibo Tool Cibo Creating Injected Cibo Configurator aniis Beam Optics is a tool File View Analysis Model Attributes Meshing Execute View Results Tools Help to generate an injected beam profile a Cibo Cibo O
52. w g ig Te m R oe ee ee E ai atte eT n ee en Fj Rora ae T y aii iak o a a E a we FIGURE 214 Local Mesh Refinements table shown with four automatically generated entries corresponding to the four secondary emitters 3 No changes are needed to the meshing parameters so click OK to close the dialog Click 4 Reopen the Meshing menu and select Generate Initial Mesh 5 A DOS window will appear indicating progress during the mesh generation process When the process completes the following text will appear at the bottom of the window Mesh Genera tion Complete mesh file created _E sms Press any key to continue exit Hit any key to close the DOS window and return control back to the user interface If desired you can view the mesh by opening the Meshing pulldown menu and selecting Display Initial Mesh The mesh will appear in the graphics display region This step was illustrated in the previous JLAB example 1A See Example 1A for details 4 2 2 6 Executing BOA Once the initial mesh 1s generated you can execute the BOA engine 1 Open the Execute pulldown menu and select Single Case gt Execute BOA 160 5 10 BOA Version 4 User Manual v0 5 updates in progress 2 Leave all parameters set to the default values Note that Max Number of Adaptivity Passes 1s set to O which means the mesh will not be adapted for this run Click Execute 3 A DOS window will appear indicating progress during BOA execution When BO
53. want to continue lowing BOA execution BoaGui will display g the informational message shown in Do not ask this question again Figure 71 This message indicates that the Yes Electrostatic Field Postprocessor must be run in order to generate the files necessary for FIGURE 71 Postprocessor Informational Message display Click Yes and wait for the postpro cessor to complete BOA Version 4 User Manual v0 5 updates in progress 5 10 63 The default electrostatic results will appear in the main window and the Electrostatic Display Parameters dialog will automatically pop up on top as shown Figure 72 The displayed results oh BoaGui llab Klystron Gun Project boa File View Analysis Model Attributes Meshing Execute View Results Tools Help Project Jab Klystron Gun Project EH Case Example 1A i Analysis Type Electrostatic Electric Field Vim Electrostatic Display Parameters 3 05e 00 0D 1D Display Iteration Selection Data Point Line Plot Current Selection fo z 2D and 3D Display Display for Electric Field Parameters V m Larene R aia Calculated Min Max Displayed Min Max _Select Surfaces Min 3245300 Min 3245300 ae Max 3046 100 Max 3046100 Vector Scale Factor 0 1 Display Vector Field E C off Apply op Veer On MV Display Legend Horizontal Vertical Display Scalar Field Scalar Field Parameters V A s Calculated Min Max Displayed Min
54. you want to copy the selected file to your case directory BOA will display the mes sage shown in Figure 19 informing you that the specified file will be cop FIGURE 19 Geometry File Copy Message ied to the Case directory Press Yes to proceed BoaGui requires that a copy of the geometry file reside in the BOA case directory BoaGui does not use the original version of geometry file Note that subsequent steps in a BOA analysis depend on the geometry model file including attribute assignments and mesh generation If you specify a new geometry file BOA will issue a Warning message with three options e Update updates boundary and source assignments To successfully update the new geometry model must have the same number of parts and the same part names as the old model e New automatically clears attribute assignments and deletes the existing mesh file so that you can start new assignments e Cancel See the Appendix for details on how parts and surfaces should be named within the geometry file The Background section TBD provide explanation waiting for implementation of redesign Model Units These units are taken directly from the geometry model file 3 8 Attributes Menu The Attributes menu item brings up the tabbed Attribute Assignment Properties dialog shown in Figure 20 It contains five possible tabs Electrostatics Beam Optics Magnetostatics Optimizer and Miscellaneous The tabs vary depending on the select
55. 004 1 35e 004 00e 003 4 50e 003 80e 004 1 35e 004 P 00e 003 4 50e 003 Pot ntial Vv Potential V FIGURE 79 Extent clipping for two different result displays Left hand figure shows Voltage On with Show Contours checked and Vector Electric Fields On Right hand Figure shows Voltage On with Show Contours unchecked and Mesh On Extent Clipping is set as shown in Figure 78 68 5 10 BOA Version 4 User Manual v0 5 updates in progress The Scalar Slicing button Scalar Field Cut Plane 23 located beneath the Scalar Field radio buttons accesses the Cut Plane Normal Specification Contour Specification Show Contours Scalar Field Cut Plane dialog pn Hoes sees E i Calculated Scalar A The dialog allows you to define e oe a 2 ee as m Mam lt e a plane anywhere within the Angle from avis 0 to 360 a pr oblem boundary and view the c Number of Contours hog scalar field distribution on that F eo Normalized Dist from Center along Normal Minimum Scalar v plane The scalar field shown 100 100 corresponds to the selected radio Maximum Scalar 0 y button on the Electrostatic Dis play Parameter dialog The Model 0 030953 Nom 3 Apply Scalar Field Cut Plane dialog is 2 l Viewing P _ p Clipping 5 divided into the following sec j a Set Opacity 1 Show Mesh Outline a o tions Seali an i Line Width z Cut Plane Normal Specification Close Use the slider bars to specify the ex
56. 4 9 00e 003 Potential V Mesh Info Case Example 1A Hide this dialog temporarily Hide Exit FIGURE 137 Electrostatic results with Voltage Contours On Vector Field On executed with Max Number of Adaptivity Passes 0 played results correspond to the default settings on the Electrostatic Display Parameters dia log Display Vector Field E set to On and Display Scalar Field set to V 1 e display the voltage contours This Electrostatic Display Parameters dialog is shown more clearly in Figure 138 110 5 10 BOA Version 4 User Manual v0 5 updates in progress 3 Use the Electrostatic Display Parameters dialog to specify different outputs as desired Note that some sections of this dialog box require the Apply button for changes to take effect D Electrostatic Display Parameters mems 0D 1D Display J Iteration Selection j Data Point Line Flot Current Selection lo 2D and 3D Display Display for Electric Field Parameters Vm f Surface nies ee Calculated Min Max Displayed Min Max ul Min 3245300 Min 3745300 Max 3046100 Max 3045100 Vector Scale Factor O 1 Display Vector Field E C off ay On W DispayLegend Horizontal Vertical Display Scalar Field Scalar Field Parameters V off AE re Calculated Min Max Displayed Min Max EX s l Min 18000 Min ARNAN ee i 18000 Ex Max 0 Max 0 Number of Contours wE MW Show Contours Apply Scalar Slicing M D
57. 847 9 Mn isq79 Horizontal Max 4913800 Mex 4913800 Vertical V Show Contours No of Contours C FIGURE 103 Beam Optics Display Control Panel dialog with Power Densities On Selecting Surfaces BOA Version 4 User Manual v0 5 updates in progress 5 10 85 To add a surface on which to display power densities click the Select Surfaces button next to the Display Power Densities On radio button if the dialog is not open already Click the Add Sur face s button beneath the table This will bring up the graphics display window containing the geometry model Rotate the model so that you can see the face of the desired surface Select it by pressing the Ctrl Left mouse button The surface will change color to indicate it is selected Press Enter and the surface will appear in the Selected Surfaces table Add additional surfaces using the same method To modify the Color or Name if editable for a selected surface select the table entry and click the Modify button Make the desired changes in the resulting Selected Surfaces Properties dialog and click OK To deleted a selected surface select the desired table entry and click the Delete but ton To close the Surface Selector dialog click OK Setting Power Density Parameters In the Power Densities section the Show Contour checkbox controls the appearance of the power densities on the selected surfaces If the checkbox 1s unchecked the power densities app
58. A com pletes the following text will appear at the bottom of the window Proceed to View Results Press any key to continue exit Hit any key to close the DOS window and return control back to the user interface Expect this run to take longer than the previous run 4 2 2 7 Viewing Beam Analysis Results For this example you will proceed directly to the Beam Analysis results to view the trajectories for the three different generations of secondaries 1 Open the View Results Beam Optics Display Control Panel pulldown menu and select i E Particle Iteration Emitters and Trajectories Beam Analy sis The Beam 4 Particle Selection Type Ful Genration Optics Display Control Panel dialog shown in Display Power Densities f OFF H Emitter Figure 215 will appear Con Seles Stage CFAE i Stage 2 Face 2 By default the primary Display Traj Planar Particles stage J Face trajectories are shown M off stage 3 wall The Display Traj Planar ete alacar Particles radio button is s set to display Traj ecto Generate Terminal Particles File ries and the Generation Generate Bis 5 File Particles File Mame 4 Enpa out No checkboxes in the EE E Emitters and Trajectories section show only the 0 generation checked om Bea oo a FIGURE 215 Beam Optics Display Control Panel dialog BOA Version 4 User Manual v0 5 updates in progress 5 10 161 3 To show the trajectories for different generations of
59. Add Reflective Add FIGURE 159 Attribute Assignment dialog box Beam Optics tab 4 Leave the Beam Optic Parameters set to the defaults 5 In the Emitter Assignments section click the Thermionic Emitter Add button beneath the table This will bring up the graphics display window containing the electrostatic geometry model BOA Version 4 User Manual v0 5 updates in progress 5 10 125 6 Select the cathode surface by pressing Ctrl Left mouse button The cathode surface will appear selected it will change color as shown in Figure 160 Click enter to complete the selection 7 The dialog box shown in Figure 161 will appear In this case the surface you selected corresponds to a part surface named emitter in the geometry file There fore the Name box automatically shows the name emitter and it is not editable If the selected surface did not correspond to a named part surface in the geometry model this field would be editable 8 Set the Color dropdown box to orange 9 Set Approximate Number of Particle Launch Sites to FIGURE 160 Defining the cathode 100 10 In the Meshing Parameters for Beam Analysis box define the cathode to anode spacing by entering 0 7 in the Cathode to Anode Spacing data entry box Leave the Grid Present check box unchecked 11 Click OK to complete the emitter ae eres definition The newly defined emit ter will appear in the Emitter Assign a A Col W Ena
60. Beam Optics Analyzer v4 User Manual Version 0 5 May 2010 updates in progress Calabazas Creek Research Inc 690 Port Drive San Mateo CA 94404 BOA Version 4 User Manual v0 5 updates in progress 5 10 1 0 2 0 3 0 4 0 Table of Contents troduction bey emer mee etene eee treme Orererter rer nttae E er een rere ere 4 VAS CANT A LO eina saceuaaudanciacs gipuvad ndeanecn she waaauden quate teweadacmeunese 4 24 Minimum System Requirements s 2ssacachccaeccacdawnassaawexeddesacesedaasasvacsestcacwausbadesueecdics 4 22 Software Requirements for Optimization Runs esesssssssssoeseresssssssssssseerssssssssses 4 2 3 MW SiGe dsa OT a A akesasealunmumesaaee 5 2 4 Executi BOX GU os baviwscccst ct ahasueiscavuasdansemedansaeehiaatitent A 5 BIC OPa Oasa a a E eaiae oes deans 6 3 1 Ele SUMICOULC ses shec tit antunisets a a a lee etiieat 6 22 Sree M Oro aza Oea a a ico tastian eben tlacieseh 6 3 3 Pr jec Case Mana Ei oiai e a a a a es 8 Seedy Proe Me Menear Peete is tendo a aceasta Mews 8 PIS ASCII Circe T A EE EE O sea ceceercaaneasaes 9 3 4 Eie Meni soa A E O N 11 3 5 VIEW Me Mienna Nia bast atiaat Mra Aba lta kta ieahasnahta us tabei a nktudwanealsoanhcals 12 3 6 Analysis Moie E een doctmaa neem eowseuseas 18 3 7 Model N Iisa E seo cemaneneetwenecsnetnaceneuenees 19 3 8 AADS MENU es a T ae 20 3S Electrostatic Attributes rae a a T a TTAN 21 Del Beam OMICS AADU S sii easa e Raae o aa betaumsseteowers 23 3 8 3 M
61. Current Selection 0 Y Scalar Field Cut Plane msm Cut Plane Normal Specification Contour Specification F Show Cont Angle from Z axis 0 to 180 90 Festa 4 50e 003 Calculated Scalar Range Min 18000 Max 2 9824e 012 Angle from axis 0 to 360 o Number of Contours 10 Normalized Dist from Center along Normal Minimum Scalar t6000 V 100 100 z Maximum Scalar 2 9824e 012 Yy 9 00e 003 Model 0 010766 Norm f1 Apply Viewing Parameters Clipping State Set Opacity 1 F Show Mesh Outline of COn 3 Line Width 2 Close 1 35e 004 Mienia les Clipping Oe nd lt Off Off On f On Show Mesh Outline 1 80e 004 Mesh Info Hide this dialog temporarily Hide Exit Case Example 1A Iteration Current FIGURE 141 Scalar slice of the voltage field on the zx perform the following steps 1 The Electrostatic Display Parameters dialog should still be open 2 Click on the Scalar Slicing button located beneath the Scalar Field radio buttons The Scalar Field Cut Plane dialog will appear This is the top dialog shown in Figure 141 BOA Version 4 User Manual v0 5 updates in progress 5 10 113 3 To define the cut plane as the zx plane set the Angle from Z axis to 90 and the Angle from X axis to 90 Set the Dist from Center Along Normal slider so that Norm 1 you can do this by moving the slider directly or by typing 1 into the Norm data entry field This allows the model to show throug
62. FIGURE 136 Postprocessor Informational Message BOA Version 4 User Manual v0 5 updates in progress 5 10 109 2 The default electrostatic results will appear in the graphics display region and the Electrostatic Display Parameters dialog will automatically pop up on top as shown Figure 137 The dis a BoaGui llab Klystron Gun Project boa File View Analysis Model Attributes Meshing Execute View Results Tools Help Project Jab Klystron Gun Project ER Case Example 1A H Analysis Type Electrostatic Electrice Feld Vm Electrostatic Display Parameters 3 05e 06 0D 1D Display Iteration Selection Data Point Line Plot Current Selection 0 2D and 3D Display Display for Electric Field Parameters V m jiaresnoe t Surfaces Calculated Min Max Displayed Min Max _Select Surfaces Min 3245300 Min 3245300 Parts ai Max 3046 100 Max 3046 100 Vector Scale Factor 0 1 Display Vector Field E C off Ay aan is CNAS 5 e On M DisplayLegend Horizontal Vertical Display Scalar Field Scalar Field Parameters V C off i re Calculated Min Max Displayed Min Max if x es Min 18000 Min 18000 4 Ey Ez Max 0 Max 9 L rveqils Emag Gy Number of Contours fo V Show Contours Apply Scalar Slicing I Display Legend Horizontal Vertical Initial Mesh Clipping State in d 25e i06 Display Mesh Clipping 1 1 Off L1 Off C On C On Show Mesh Outline 80e 00
63. FIGURE 38 Optically Transparent Parts table on the Beam Optics tab of the Attribute Assignments Properties dialog To delete optical transparency from a part highlight the part in the table and click the Delete button Optical transparency for a part can be enabled or disabled via the checkbox that precedes the part name in the Optically Transparent Parts table see Figure 38 When the checkbox is checked the part is enabled 3 8 2 5 Optical Surface Assignments The Optical Surface Assignments section of the Beam Optics tab Figure 39 is used to define Peri odic Surfaces and Reflective Surfaces in order to reduce the size of the model See Figure 23 for the ict a Been bane iste tab of the Attribute bear alae Properties ate Tact A EA E cole aoe te let goes a ok A ANE je et te eat eg ee VA EEE es eo a a a F i Optical Surface Assignments nlet Name Inlet Color InletTag OutetName Outlet Color Outlet Tag i Modify r E Delete i d ip Periodic Add Reflective ddd 2 s f 2 pr a Spe Bnat alls a e a i all eo Ne ta AR rm ine ta E i aires mih F a re E aoe a pr ah al oe ae ts a ale pen FIGURE 39 Optical Surface Assignments table on the Beam Optics tab of the Attribute Assignments Properties dialog Periodic Surfaces BOA Version 4 User Manual v0 5 updates in progress 5 10 37 Periodic surfaces are used to model very long parts Periodic surface assignment entails specify ing two surfaces
64. Field Cut Plane x Cut Plane Normal Specification gt r Contour Specification Angle from Z axis 0 to 180 Bo Show Contours j Calculated Scalar Range Min 0 Max 25453 _ Angle from X axis 0 to 360 180 on Number of Contours 0 Normalized Dist from Center along Normal Minimum Scalar fo T 100 100 Maximum Scalar 0 03 T Modet 34 403 Norm f J Apply Viewing Farameters r Clipping State Set Opacity 1 I Show Mesh Outline Line Width fas Cot On i Oos FIGURE 228 Scalar cut plane GUI 172 5 10 BOA Version 4 User Manual v0 5 updates in progress The magnetic field along a line can be plotted using Line Plot which brings up the dialog shown in Figure 12 The parameters for a line at the center of the beam line are shown in the dialog The FIGURE 229 Scalar slice of the magnitude of the magnetic field density line plot with these parameters is shown in Figure 231 Note that the vector components of the field density as well as H and the current density J can also be plotted BOA Version 4 User Manual v0 5 updates in progress 5 10 173 Magnetostatic Line Plotter You may enter line endpoint coordinates directly into the Select Surface Select edit boxes or click on a button to the right to select o endpoints with the cursor The 3D Select button enables you to locate endpoints anywhere within the bounding box of the model The Surface Select button will only allow yo
65. GURE 112 Particle Statistics section of the to either Electro Magnetostatic Beam Beam Optics Display Control Panel dialog or Electro Magneto Self Field Beam then two additional sets of statistics will appear as shown in Figure 112 e The lower portion of the Particle Statistics section will contain a table that summarizes particle statistics for the whole plane The table includes the Mean minimum Min maximum Max and standard deviation Sigma for the following e KE eV kinetic energy e Perp KE eV kinetic energy perpendicular to the beam axis e Para KE eV kinetic energy parallel to the beam axis e v_perp c perpendicular velocity normalized by the speed of light e alpha the ratio of perpendicular velocity parallel velocity B T magnetic field e r model units e g in beam radius BOA Version 4 User Manual v0 5 updates in progress 5 10 93 e The bottom portion of the Beam Optics Display Control Panel will change to a section named Additional Particle Statistics This section summarizes particle statistics at the mean radius of the beam r Mean For each polar angle Theta in radians the table provides e y_perp c the perpendicular velocity normalized by the speed of light e alpha the ratio of perpendicular velocity parallel velocity e rg the Lamor radius in model units e g in Also known as gyrotron radius e Bx By Bz the coordinates of the magnetic fie
66. Inthe PRAATTE Adapted Mesh section change the 2 98e 006 Display Mesh radio button to On The mesh will appear as shown in Figure 150 Notice that the adapted mesh is coarser towards the front of the view and finer towards the back 2 To see the inside of the mesh change the Clipping radio button to On in the Clipping State section Set x Max to O and set yMin back to 1 1 3 In order to see inside the gun assem bly hide the anode and the mod anode as follows Open the Attributes EIA A 5 7 ve d m foes c menu The Attributes Assignment 1 800 004 1350 001 RIOISDOS 4500 003 Properties dialog will pop up on top of the Electrostatic Display Parame FIGURE 150 Adapted Mesh On ters dialog Select mod anode and uncheck the Visible checkbox Do the same for the anode 4 Click Ok to close the Attributes Assignment Properties dialog 5 The mesh will appear similar to that shown in Figure 151 Use the mouse to move the picture around and view it from different perspectives Notice how the mesh is coarser in some areas and finer in the areas of inter est Electric Field V m 2 98e 006 1 31e 006 4 1 2 4 2 Line plot of the E magnitude along the beam axis i e Z axis Figure 152 shows a line plot of the E magnitude along the z or beam axis To generate this picture perform the following steps 3 69e 006 1 80e 004 1 39905 E ey 4 50e 003 FIGURE 151 Adapted Mes
67. M Comments Par toe Itereson Ceepiay Pov Oerwies ow on Cespiay Trajan Partces Stage 3 Face on r C Trapectores plaw Pardes Generate Termal Particles Fie Genertatr Panar Par a Choose Pure yr FIGURE 110 3d Planar Particle Display Generating Detailed Planar Particle Information In addition to viewing the planar particles in the main window you can also generate additional information including a separate output file containing detailed planar particle information a 2D particle position plot summary statistics for the planar particles To generate this additional information first complete the necessary input parameters in the Par ticle Statistics section including Axis Dir The Axis Dir dropdown box specifies the direction of the normal positive or neg ative When Choose Plane is set to the xyz plane then Axis Dir Positive indicates the same direction as that specified by n x Normal y Normal z Normal and Axis Dir Nega tive indicates the opposite direction of n Num r s The number of r coordinates Grammar note Thuc Mattie this is incorrect usage of an apostrophe apostrophes are used to indicate possessive not plural Num Theta s The number of polar angles Gammer note Thuc Mattie this is incorrect usage of an apostrophe apostrophes are used to indicate possessive not plural BOA Version 4 User Manual v0 5 updates in progress 5 10
68. Max i x ve Min 18000 Min 18000 t Ey VEZ Max 0 Max 0 1 67e 006 Emag Gy Number of Contours 10 2 V Show Contours Apply Scalar Slicing I DispayLegend Horizontal Vertical Initial Mesh Clipping State in 3 25e i08 Display Mesh Clipping i 1 Li Cy O fF 1 1 0 Off C On C On 1 1 1 1 1 1 1 1 T Show Mesh Outline 7 0 78 1 80e 004 9 00e 003 fae BA Potential V Mesh Info Case Example 1A ey Hide this dialog temporarily Hide Exit FIGURE 72 Electrostatic results default settings correspond to the default settings on the Electrostatic Display Parameters dialog Display Vector Field E set to On and Display Scalar Field set to V 1 e display the voltage contours This Electrostatic Display Parameters dialog is shown more clearly in Figure 73 It includes the following sections e Iteration Selection For beam analyses the dropdown in the upper right corner of the dialog specifies the iteration for which to display the Electrostatic results The contents of the drop down box correspond to the saved iterations of the last run as defined by the parameter Output Solution and Source Fields Every N Iterations on the Execute dialogs The default iteration is the final iteration e QD ID Display The upper left portion of the dialog provides buttons for accessing the Single Point Electrostatic Field Extractor dialog via the Data Point button and the Electrostatic Line Plotter dia
69. Maximum Potential ae EE Potential Convergence Criteria EQ 2 Maximum Potential PEE A E The default value is 0 005 Charge Neutralization Factor This parameter accounts for charge neutralization ionic charges neutralizing electronic charges Each particle charge is reduced by this factor This value must be less than or equal to The default value is 1 e no charge neutralization 24 5 10 BOA Version 4 User Manual v0 5 updates in progress Maximum Number of Secondary Generations This parameter is enabled only when a secondary emitter is defined in the Emitter Assignments section It defines the maximum number of possible secondary generations per one primary electron 3 8 2 2 Emitter Assignments The Emitter Assignments section allows you to add thermionic emitters injected emitters and sec ondary emitters The sections below describe the details for defining each emitter type Note that BOAGui provides the capability to disable particular emitters for a simulation without having to delete them from the case This feature is useful if you want to temporarily turn off some secondary emitters or certain thermionic emitters for a simulation but want to re use them in subsequent runs By definition a beam analysis requires at least one enabled primary thermionic or injected emitter BoaGui will issue a warning if there is not at least one primary emitter speci fied and enabled Thermionic Emitters To add a therm
70. Parameters dialog should still be open If it is not reopen the View Results menu and select the Electrostatic item Turn off the Display Vector Field E radio button In the Clipping State section turn the Clipping radio button to On Set the x Max value back to 1 1 you had changed it earlier in the example and the y Min value to 0 and then click Apply This will slice the voltage field To slice the model itself go to the View menu and select Slice Model The dialog shown in Figure 140 will appear In the Choose Plane section select the zx radio button Click Close The main window should display the result shown in Figure 139 5 10 Predect Lab Kysron Gan Projet 4 ase Deanie 1A Anaya Tipe Derita Date Modified Apr OF 200a 00 09 FM Comments Lipsr Manuel Example D Sample gedron atic anah OD Ce Dilar ts Pork lire Mek Curent Salsha fn 20 and 20 Delay Dasplay for Sarl ae Pati p Canela het Feekd E w off J On f Dinar Setar a ai Feld Paata ES Of g Cikita Hi Fiir Diese M Mar Hn 18008 Ma iama E Er Mas 159 Max 155 Liag nn Auber of Coa pn Apply Seilir Sheng A bepa Legend F Honoa Vertical riia Mesh Cippi e n a l Ll Eagar Miah Cleary ie g Ths Mis Mi 1 1 i Lt ma Y M i Li t Ors Sioa Mish hina aMn zba 10 78 Heh Fi __ Reply pide Ghat dling beriga aniy Hele a S J 4 38
71. Plane dialog Shown in Figure 95 The dialog allows you to define a plane anywhere ee i within the problem boundary and view the scalar field distribution on that gg plane The scalar field shown corresponds to the selected vector field FIGURE 94 Scalar component radio button on the Magnetostatic Display Parameter dialog 4 ae Se yt 7 wee wwe sio a m T Magfitude Scalar Slicing Slicing button The Scalar Field Cut Plane dialog is divided into the following sections Cut Plane Normal Specification amp scalar Field Cut Plane 3g Use the slider bars to specify 2 Cut Plane Normal Specitication r Contour Specification the exact position of the cut O host Angle from axis O0 to 180 T A eoe plane Controls include Angle ee 3 t from the Z axis from 0 to 180 ee Mlin o blax 1 2505 degrees Angle from the X axis Angle fram axis 0 to 360 from 0 to 360 degrees and Number of Contours 0 Normalized Distance from Cen Normalized Dist from Center along Mormal Minimum Scalar e ter Along Normal slides the 100 100 Manumea 01 plane along the normal to the E surface You can also enter spe Modto Nom jo cific values for these parame _ ters in the edit boxes provided venna Pande Clipping State rather than use the slider bars Set Opacity 1 F Show Mesh Outline Cor Go For Normalized Distance from Line Width J Center Along Normal you can enter in the distance in the model units Model
72. Temperature Enter in degrees C e Emitter Work Function Enter in electron Volts Enter the value directly or by selecting a work function from the Find Work Function optional drop down box This drop down box con tains a library of work functions for commonly used materials You can add materials to the library by selecting Add Your Own Material in the drop down box and entering the desired values in the Material Properties dialog You can also access the Material Properties dialog via the Jools gt Material Properties menu See Section 3 12 3 for details e Check the Temperature Correction checkbox to include a temperature correction factor This optional correction is derived from Maxwellian energy distribution for low voltage region in the proximity of the thermionic emitting surfaces The correction factor as a function of Tc V is expressed as a series expansion given by Langmuir and et al e Check the Relativistic Correction checkbox to include a relativistic correction factor This optional correction is for electron guns operating in relativistic regime It is formulated from Child Langmuir law and recasted into a series expansion by Lau and et al as a function of gamma 1 Enter the Meshing Parameters as follows e The Grid Present checkbox determines how the cathode spacing is defined If a grid is present check the box and enter the value for Cathode to Grid Spacing If no grid is present leave the box uncheck
73. The File pulldown menu is shown in Figure 7 It includes the following BoaGui JLab Klystron Gun Project be lae View Analysis Model Attributes Mes New Project Open Project Close Project New Project Opens a new Project BoaGui will prompt you to specify the name of the Project and the ENE directory in which you would like the new Project Import Pre existing Case folder to reside The Project folder will contain the SRE aes Ter DIS eany Project file boa and all associated Case folders Clean Up Case Open Project Opens an existing Project You will be peal Comments prompted to browse the directories on your computer Save Case to locate the desired Project file boa Save Case As Print Setup Close Project Closes the current Project and Case If 1 JLab Klystron Gun Project bos Sheet Beam Gun boa you have made any changes to the Case you will be oe ae given the option to save the Case and Project or close 4 MSDC Project boa without saving Exit Add New Case Identical to menu item with the same name on the Project right click menu See previous FIGURE 7 File Pulldown Menu section for details Import Pre Existing Case Identical to menu item with the same name on the Project right click menu See previous section for details Import All Cases From Directory Identical to menu item with the same name on the Project right click menu See previous section for details Open Ca
74. Type The Particle Selection Type dropdown box allows further refinement of which particle trajectories get included in the display e Full This option results in the display for all particles 88 5 10 BOA Version 4 User Manual v0 5 updates in progress e ID With this option the minimum and maxi W Particle Range Selector mum ID numbers for all particles appear in the table To modify the ID range click on the row for the desired emitter and the dialog shown in will appear Enter the desired range Min and Max and click OK Only trajectories or planar particles and power densities associated with the specified ID range will appear in the main window FIGURE 108 Particle Range Selector dialog e Current With this option the minimum and maximum current for all particles Min and Max appear in the table To modify the current range click on the row for the desired emitter and a dialog similar to will appear however it will ask for a current range rather than an ID range Enter the desired current range and click OK or planar particles and power densities associated with the specified ID range will appear in the main window This dialog is missing units Tell Thuc Specifying Trajectory Color The color of the trajectories is based on the color setting in the Colors gt Trajectory item under the View menu See Figure 15 and Figure 16 on page 17 for details on these controls As explained there yo
75. Updated by its creator or copy the selected File to your case directory so that P the case is more portable Do you still want to copy the File current Case directory Click Yes 6 Back on the JD Axial Mag Yes Mo E netic Flux Density Parameters FIGURE 208 Copy File Message for the External dialog set the Largest Field Magnetic Field File Radius to 1 6 half of the outer diameter of the collector the Cal boaGui Grid Unit to in and the Num r Coord to 51 7 Before clicking OK you can choose to visually inspect a plot of SPANS 2 bound of field is inside problem domain the magnetic field to confirm it is fe yea nee OnE Click the Plot to Verify Thus the importing Field bound may not enclose the beam region Field button The information If this is the case you should regenerate and reimport the magnetic Field message shown in Figure 209 will warn you that the z bound of the T Do not display this message again until app restarts magnetic field is inside of the problem domain In this case this is expected because Thuc please give me a Short explanation of Ul boaGui FIGURE 209 Information Message about the location of the a magnetic field boundary within the problem domain why this is expected behavior UPDATE Did this message change Now includes x and y too 156 5 10 BOA Version 4 User Manual v0 5 updates in progress 8 A plot of the external magnetic field will appear in the ma
76. V 0 000 P 0 000 FIGURE 76 Voltage field contour plots with the Show Contours checkbox unchecked Right hand figure uses extent clipping CHANGE TO MATCH ORIENTATION BELOW outside of the meshed problem space The right hand figure uses extent clipping to reveal the internal structure Extent clipping is discussed in a subsequent section Alternatively if the Show Contour checkbox is checked you specify Number of Contours and the display will group similar values into the specified number of discrete iso surfaces as shown in Figure 77 The Displayed Min and Max values dictate the upper and lower values displayed These values initially default to the Calculated Min and Max values The Calculated Min and Max values appear for reference making it easy to reset the values The Display Legend checkbox turns the legend display on and off and the radio but tons labeled Horizontal and Vertical dictate the legend placement Initial or Adapted Mesh This section con trols the display of the mesh It refers to the last mesh used in generating the results either Ini tial Gf Adaptivity is off or Adapted if adaptiv ity is on The Display Mesh radio button shows hides the mesh The Show Mesh Outline FIGURE 77 Voltage field contour plot checkbox displays an outline of the mesh ee sealer ated oy Ree Figure 79 shows an example of the Adapted BOA Version 4 User Manual v0 5 updates in progress 5 10 67 Mesh turned On the scalar f
77. ab active 2 The table in the Prop erties at the Part Level section shows all parts Properties at the Surface Level contained in the geom Face Tag etry file The part Ba names are identical to Delete the names provided in the geometry file and vonage DIR Sisface Chetpe Demy Ae they are not editable Initially BoaGui will assign default attributes to all parts Typically the user will want to change most or all of the assigned attributes The table also contains the Background part This part is not in the geometry file It is created by BoaGui based on the settings in the Model Geometry Parameters dialog The Visible checkbox is checked for all parts except the Background part gt No sf Opacity al Volts C in 3 Relative Permittivity of Selected Part Find Another Rel Permittivity Optional FIGURE 190 Attribute Assignment dialog box Electrostatic tab 3 Highlight the Stage 1 part Leave the Color dropdown box set to default Check the Voltage Assigned to Entire Part checkbox and enter 25000 in the data entry box Set the Find Another Rel Permittivity Optional dropdown box to Copper 144 5 10 BOA Version 4 User Manual v0 5 updates in progress 4 Highlight the Stage 3 part and assign the attributes shown in Table 2 below Part Name Visible Voltage Vol Change Rel Permittvity Material Mame Tag Opacity Stage 1 es default 25000 No 1 0 Copper Heo St
78. able of Contents Con t 4 1 1 Example 1A Electrostatic Analysis ccccccccccccccccccceceeeseeeeaeeeaeaeeeeeaaaeeaeeees 100 4 1 2 Example 1B Electrostatic Analysis with Adaptive Meshing 000 116 4 1 3 Example 1C Electrostatic Beam Analysis with Thermionic Emitter 123 4 2 Example 2 Multi stage Depressed Collector MSDC cc ceesseeeeeeeeees 140 4 2 1 Example 2A Electrostatic Beam Analysis with Injected Beam 140 ADD Example 2B Electro Magnetostatic Beam Analysis w Secondary Emissions 154 4 3 Example 3 Solenoid for a Multibeam Klystron MBK ce eeeeeeeeeeeees 163 4 3 1 Example 3A Magnetostatic Analysis cccccccccccccececeeceeeceeeeeeeeeeeeeseeaeeaeaeaaas 163 Da FTOUDICSHOOUNG sy ccasesecrdyataeate coer arawaontwcuda ntti cates a otwenda aaa cte stan 175 6 0 PPPCMCICES erisia eee aacsweateedicattdansiceteeeiee aaisiaatead att aaaiateeee nm aacswentenes 176 6 1 Appendix As Input MCS ait cise aise clei ala eatin A 177 6 1 1 OTC OM Glo Caress ascot eects teaea sade stgntatetedquniaat T add scany acess 177 6 1 2 jected Emitter gill Co maneran antennae E ar Mryee Gert sent 178 6 1 3 External Magnetic Field File sinerien an A 181 6 1 4 EX Cel pli ZatlOm FIle scsici63s cacascagaviugahindansuscacnsantuusbvedoulavengoiarganedelainandanessones 182 6 2 Appendix B Output Piles aaa a iho eda ee a 183 6 2 1 Planar Particle Output File Papa Output
79. ables you to FIGURE 111 Particle Position Plot modify the plot as desired This dialog is shown in Figure 13 Plot Control Panel dialog on page 15 and explained in more detail there Froject MSOC Project J Case Gearmple 24 LO Case Example 28 anis Type Electra Mage A i Date Modified Feb 16 2000 Particle Position Lomm Capt Erarmgit JE Herat i Curent 40 3 The Planar Particles section in the middle of the Beam Optics Display Control Panel disap pears and is replaced by the Particle Statistics section as shown in Figure 112 This section provides the following summary statistics 1 The term Papa stands for Planar Particle Attributes 92 5 10 BOA Version 4 User Manual v0 5 updates in progress e the coordinates of the centroid Pla Geom Opes Dap ee ea xX Des nar B eam Ce ntr Particle Iteration Emitters and Trajectories ja Partide Selection Type Full Genration e the number of particles Num Parti _ No Display Power Densities itt cles i H Emitter On Select Surfac Stage 1 Face e the Total Current Stage 2 Face Display Traj Planar Particles Stage 3 Face e the total kinetic energy Total KE C off Stage 3 wal C Trajectories e the Brillouin field Bb the Brillouin Planar Partides field produces a magnetic force that Generate Terminal Partides File balances the space charge and centrif Generate isplay Particles File Partides Fil
80. ace is a named surface in the CAD file consisting of tags 44 and 45 The Stage 2 Face will appear selected it will change from cyan to a dark green Press Enter and the Stage 2 Face will appear in the Selected Surfaces table 12 Repeat the above procedure two more times to add the Stage 3 Face a named CAD surface consisting of tags 20 amp 21 and the Stage 3 Wall a named CAD surface consisting of tags 23 amp 24 13 After you have added all four surfaces the Selected Surfaces table should appear as shown in Figure 199 Click OK to close the Surface Selector dialog 152 5 10 BOA Version 4 User Manual v0 5 updates in progress 14 The power densities will appear on all four surfaces Power Density W as shown in Figure 201 15 Experiment with the set tings in the Power Densi ties W m 2 section of the Beam Optics Display Con trol Panel dialog to see how the picture in the graphics display window changes For example increase the No of Con tours to get a more accu rate look at power densities Or highlight the regions of highest inten sity by increasing the Min value for the range Figure 202 shows the No FIGURE 201 Power densities shown on four defined surfaces 20 contour of Contours set to 400 and the Min value set to 1000000 W m 2 Notice the region of highest intensity on the Stage 1 Face Power Density W FIGURE 202 Power Densities shown on Stage 1 2 and 3 Faces and Stage 3 Wall N
81. ace tags The internal algorithms used by BOA have broken this portion of the Focus Electrode part into eight separate surface tags 36 38 39 BOA Version 4 User Manual v0 5 updates in progress 5 10 129 40 41 42 43 44 Unlike with the selection of the Anode Tunnel in a the previous surface def FIGURE 167 The Focus Electrode Left image is prior to defining the FocusElectrode surface Right image is after defining the FocusElectrode surface inition the JUAB Gun SAT file does not contain a named surface for this area Therefore you must make a selection for each of the eight surface tags separately As you make each selec tion the surface tag numbers will appear on the status bar a To begin Select Add Surface s below the SiGe LEAL MEH REN ETI table in the Local Mesh Refinement sec tion The dialog box will disappear Name Focusclectrades Tagi 36 38 39 40 Add Surface exposing the model window Ctrl left cabri fpurpe z click on any region indicated in purple in M Set Mesh Size i Set Curvature Based Refinement Figure 167 then hit Enter The dialog Type Relative size gt Parameter Factor os shown in Figure 168 will appear Enter Sze out Relative Mesh Size Limit ooo FocusElectrodeSurface without a space Meshes in entities with local mesh in the Name box Check the Set Mesh Size refinement set may be refined but not oneal coarsened under adaptivity checkbox and the Set Curvature Based Refin
82. act position of the cut FIGURE 80 Scalar Field Cut Plane dialog plane Controls include Angle from the Z axis from 0 to 180 degrees Angle from the X axis from 0 to 360 degrees and Nor malized Distance from Center Along Normal slides the plane along the normal to the surface You can also enter specific values for these parameters in the edit boxes provided rather than use the slider bars For Normalized Distance from Center Along Normal you can enter in the distance in the model units Model or normalized units Norm Contour Specifications This section controls the display of KAGUE the scalar field on the cut o plane Use the Show Contours checkbox to toggle the display between contour lines 4 50e 003 checked and a continuous color contour plot unchecked When viewing 9 00e 003 contour lines define the con tour range by specifying the Number of Contours to be dis played and the Minimum Volt age and Maximum Voltage that define the range Note that changes do not take effect in the graphics display until you click the Apply button or the Enter key 1 80e 004 FIGURE 81 Scalar Field Cut Plane BOA Version 4 User Manual v0 5 updates in progress 5 10 69 Viewing Parameters The Set Opacity slider bar sets the opacity of the scalar cut plane To hide the cut plane set the slider bar to zero The Line Width sets the thickness of the contour lines It applies only when the Show Contours checkbox is checked
83. age 3 Tes red agg No 1 0 Copper Ho 2 E mitter es yellow No No 1 0 Vacuum Ho 3 Stage 4 Yes green U No 1 0 Copper Ho 4 Stage 2 es Cian 16000 Ho 1 0 Copper Mo 5 Body es blue 25000 No 1 0 Copper Mo 6 Background Ho magenta No No 1 0 Vacuum es 0 8 u ce TABLE 2 Attribute Assignments for case Highlight the Emitter part and assign the attributes shown in Table 2 above Highlight the Stage 4 part and assign the attributes shown in Table 2 above Highlight the Stage 2 part and assign the attributes shown in Table 2 above Highlight the Body part and assign the attributes shown in Table 2 above So ON WN You have now completed the definition of properties at the part level The Properties at the Surface Level section allows you to define properties for specific surfaces on parts in the elec trostatic geometry model For this example there will be no entries in this table 4 2 1 8 Assigning Beam Optics Attributes Injected Emitter Next you will assign the beam optics attributes For this case this means defining the injected emitter sur face and specifying the emitter part as optically trans parent 1 The Attribute Assignment Properties dialog should still be open with the Electrostatic tab active In the next few steps the goal will be to define the sur face of the part named Emitter as an Injected Emitter In order to better see the emitter make Stage 1 Stage 2 Stage 3 and Stage 4 in
84. agnetostatics Attributes 2c ccrce ainsi acendaew meta aaa 39 SO OPM AUDUS sisan aa oa EOE 45 383 MISC ANTIDE eorne ntre rier T T A T 48 3 9 Meshin Mentsen n e REE ance eE 48 SO Setting MesmMParamelerS eccna te wventu an asin cadsnuuetiiadseuteeaiaddnautiaclarciebaiei ate 48 3 9 2 Generating and Displaying the Initial Mesh cccccccccceccceceeceeeeeeeeeeeeeeeess 55 Sah Execute Menisi a a E a 58 IOT Executing a Sincle Case enrad hve a aa 58 3 10 2 Executing an Optimizer Case pereen oeeie an a a EE aa a E 61 3 10 3 Monitoring a Beam Optics RUN vcnon a a A 62 Sel Vew Reals Meni enia hmateeadtate td tec cteitre Mad ber tehal taste tau taicanie tata 63 JILL Viewing Electrostatic Results 1 nua Oa wae Gea a ais 63 3 11 2 Viewing Magnetostatic Results 5 4scc hath aioe ue 73 3 11 3 Viewing Beam Analysis ReSUM Sissiciosiesues usd tele yaw eiweiaci wad asaemoaaness 83 See Mewe RUIN OS oenina A A A 95 Hibs Generais Ciso SUMMA y isnodi a E 95 SALO Vewmne OpiiniZer LOS enin ea 95 S O a ncentn cena annette cate oes cesaee eto cneutesionateenotedss 96 3 12 1 Creating an Injected Beam Profile Cibo Tool ec ccccccceccceeeeeeeeeeeeeeeeeees 96 Sah Z Wieasumine Dista Neeser ae o te yaiaa a a a a A 97 P Matena l Propere Siarra N eN gN NETO 98 FPA License IMS tale Eee erie a Guebadieedaetbaten 99 Examples ceranae a a a a 100 4 1 Examples ia by SiO GU ies 100 5 10 BOA Version 4 User Manual v0 5 updates in progress T
85. alization of the interior The user specified that mesh elements with X values less than O should be removed Since whole elements are removed the clipped surface can appear 56 5 10 BOA Version 4 User Manual v0 5 updates in progress rather strange as shown in the figure Never the less information on the mesh size and location can be determined BoaGui Project Jlab Klysiron Gun Sample Project Case Sample Case 1 A m 4 Bw Fe ew Aw Mode Aibu Meshing Eoee View Remi Too Help EPERERA 1 pct ab aron Gun Samp Pro LL Case Sample Cane 1 in Type Fe an E E E se FIGURE 64 Extent clipping parallel to Y Z plane at X 0 3 9 2 4 Initial Mesh Information This Initial Mesh Informa tion menu item brings up the information dialog shown in Figure 65 It provides statis tic for the initial mesh including e number of regions FIGURE 65 Initial Mesh Information e number of faces e number of edges and e number or vertices 3 9 2 5 Aborting Mesh Generation To abort meshing while mesh generation is in progress select the Abort Meshing menu item the last item on the menu shown in Figure 61 BOA Version 4 User Manual v0 5 updates in progress 5 10 57 3 10 Execute Menu The Execute pull down menu shown in Figure 66 controls the execution of the BOA program It includes options for executing a Sin gle Case run executing an Optimizer run and moni toring a run Job Monitor Parameters and Monito
86. alog click the exit button and control will be returned to the Electrostatic Display Parameters dialog 3 11 1 2 2 Data Point Extraction The Data Point button in the OD ID section of the Electro static Display Parameters dialog shown in Figure 73 brings up the Single Point Electrostatic Field Extractor dialog shown in Figure 84 This dialog enables you to extract the value of the desired field at a particular point Use the Field to Inspect radio buttons to select the desired field e Voltage e Charge Density applica ble for electrostatic beam analyses only e Electric field E e Electric Flux Density D Single Point Electrostatic Field Extractor _ mtm Faint Location You may enter the coordinates of a point directly into the edit boxes or dick on a button to use the cursor to select a point in the model The 30 Select button enables you to select a point anywhere within the bounding box of the model The Surface Select button will only allow you to select a point on the surface of the model 3D Select Surface Select Field to Inspect Field Value at Selected Point f Voltage V 0 C Charge Density C m 3 Electric Field E V m 0 0 0 0 Electric Flux Density D C m 2 Extract Close FIGURE 84 Single Point Electrostatic Field Extractor There are three different ways to specify the desired point e Direct entry Allows you to enter the x y and z co
87. ame surfaces in the CAD package before exporting the model to a sat or a x_t file Unlike with parts you can name surfaces directly in BoaGui However there are distinct advantages to naming surfaces to which you plan to assign properties These include all emission surfaces as well as surfaces that have anything to do with boundary conditions Often a CAD package breaks a single surface into multiple surfaces If you do not name your sur face BOA will consider each surface of the surface as a single surface For example if you have a single emitting surface in the CAD package upon exporting the CAD package might break it into say three surfaces BOA will then consider it three surfaces and if you want to define emitter properties for it you will have to do it three separate times However if you name the surface BOA Version 4 User Manual v0 5 updates in progress 5 10 177 BOA will be able to reassemble the surfaces back into a single surface as you intended it and you will see the surface name in BOA In effect the fact that it was broken into three pieces will be hidden from you Therefore it is recommended that you name any surface you plan to assign properties to 6 1 2 Injected Emitter File BOA supports the following four file formats for the spent beam data e BOA file format also referred to as CCR format e Magic2D file format e Magic3D file format e Christine file format Boa supports multiple injected beams
88. and 2 secondary emissions FIGURE 205 Display Edit Comments dialog magnetic field So this 1s an Electro Magnetostatic Beam analysis type 1 Open the Analysis pulldown menu and select Electro Magnetostatic Beam analysis type 4 2 2 4 Defining the External Magnetic Field This example is based on Example 2A There fore the geometry file has been specified the electrostatic attributes have been assigned and the injected emitter a beam optics attribute has been defined Next you will add the exter nal magnetic field Electrostatics Beam Optics Beam Optic Parameters Charge Neutralization Factor Emitter Assignments Thermionic Emitter Add 1 Open the Attribute Assignment Proper ties dialog shown in Figure 206 by clicking on the Beam Optics tab Optical Surface Assignments Inlet Name 2 In the External Magnetic Field Options section set the drop down box to ID Axial Imported Magnetic Flux Density Periodic Add Emission Current Convergence Criterion External Magnetic Field Options Edit and Verify Attribute Assignment Properties Optimizer Misc Electric Field Convergence Criterion fo 005 Maximum No of Secondary Generations 28 Injected_Emitter Injected Emitter Add Secondary Emitter Add Optically Transparent Parts Not Selected yellow Add Delete Inlet Color Inlet Tag Outlet Name Outlet Color Modify Delete Reflect
89. andira in RZ coordinates This option brings up the dialog box shown in Figure 36 Use the Browse button to locate the desired Pandira file The remaining parameters in the dia log box are identical to those for Pandira Poisson RA Parameters Pandira Posson AZ uee Field Scale i Grid Unit Align of CAD Model to Axis z Largest Field Radius in Field Parameters mo jade eee Enable Axial Trans Tz o in B_theta a Tesla Nurm r Coord First Point n Tif W z 2 Second Paint Starting Point HE e N ee ae we fon CP Comp e iM Plot Parameters Open gt gt Flot to Verify Field __oK_ Mum of Plot Points Cancel FIGURE 36 Dialog for importing a Magnetic Flux Density File in a Pandira RZ coordinate format the Maxwell 2D RZ Magnetic Flux Density option See the previous section for details 1D Axial Imported Magnetic Flux Density Setting the External Magnetic Field Options dropdown box to the 1D Axial Imported Mag netic Flux Density option allows you to import a 1D axial magnetic flux density file This option brings up the dialog box shown in Figure 37 Use the Browse button to locate the desired file The format for the 1D Axial file is defined in the Appendix The remaining parameters in the dialog box are identical to those 1D Axial Magnetic Flux Density Parameters 10 Axial Magnetic Flux ro Field Scale i Azial Trans Tz o in Align of CAD Model to
90. ase Import Pre Existing Case Import All Cases From Directory 1 i wats Sa mm E alt a ee ie k atie n a a et ahs AT at ee 9 er a al FIGURE 122 The Project Case Tree Control shown with right click menu opened Add New Case New Case Name Example 14 Analysis Type Electrostatic Case Comments User Manual Example 14 Simple electrostatic analysis for the JLab Klystror gun No adaptivity Open Case Now Cancel FIGURE 123 Add New Case dialog 101 7 Click OK The new Case will appear beneath the Project in the Project Case Manager tree con trol as shown in Figure 124 Behind the scenes a new Case folder will be placed in the current Project folder The Case folder will include all files specific to the case Project Jlab Klystron Gun Project tmi Case Example 14 Analysis Type Electrostatic Date Modified May OF 2009 11 16 4M Comments User manual Example 14 Simple electrostatic analysis For the Jlab Klystron Gun Mo adaptivity an ty Dm all Ayer tte A a a ee a i P C a te a een Eme S 3 B E a So age a Ries ee aa man b ia F te T i aai A i ie na FIGURE 124 Project Case Tree Control with Case opened 4 1 1 4 Saving a Case As you continue through this example it is a good idea to save your work occasionally To save a case right click on the Case name in the Project Case menu bar and select Save Case Alterna tively open the File pulldown menu and
91. ated entry use the Modify Material button 3 12 4 License Installer TBD Get existing instructions BOA Version 4 User Manual v0 5 updates in progress 5 10 99 4 0 Examples 4 1 Example 1 JLab Klystron Gun In this example BOA is used to per form electrostatic and electrostatic beam analyses on an electron gun assembly used in a klystron A cross section of the gun assembly is shown in Figure 120 The voltage is 18000 Volts on both the cathode and the focus electrode The voltage is 0 Volts on both the anode and the mod anode The cathode to anode spacing is Q 7 inches This example includes a simple elec trostatic analysis without adaptive meshing Example 1A an electro Static analysis with adaptive meshing Example 1B and an electrostatic beam analysis without adaptive meshing Example 1C FIGURE 120 Cross section of the Electron Gun Assembly modeled in this example 4 1 1 Example 1A Electrostatic Analysis 4 1 1 1 Getting Started 1 Open BoaGu1 exe by clicking on the BoaGui icon on your desktop or the BoaGui icon in the Start menu 4 1 1 2 Creating a New Project 100 5 10 BOA Version 4 User Manual v0 5 updates in progress 4 1 1 3 Creating a New Case i BOA Version 4 User Manual v0 5 updates in progress 5 10 Go to the File pulldown menu and select New Project The dialog in Figure 121 will appear Unlike the screen shown in Figure 121 initially the two data entry boxes will
92. bar sets the opacity of the scalar cut plane To hide the cut plane set the slider bar to zero The Line Width sets the thickness of the contour lines It applies only when the Show Contours checkbox is checked Clipping State This radio button turns the clipping state on and off For an explanation of Clip ping State see discussion of the Clipping State section of the Magnetostatic Display Parameters dialog in the section below The Close button closes the Scalar Field Cut Plane dialog and returns to the Magnetostatic Dis play Parameters dialog shown in Figure 88 Discuss Hide vs Exit buttons 3 11 2 2 01 1D Display Line Plots amp Data Point Extraction 3 11 2 2 1 Line Plots BOA Version 4 User Manual v0 5 updates in progress 5 10 79 The Line Plot button in the OD ID section of the Magne tostatic Display Control Panel Magnetostatic Line Plotter You may enter line endpoint coordinates directly into the 3D Select PEE edit boxes or dick on a button to the right to select endpoints with the cursor di alog shown In Figur e8 8 The 30 Select button enables you to locate endpoints anywhere R within the bounding box of the model The Surface Select button br INgS up the Ma gne tostatic will only allow you to locate endpoints on the surface of the model Line Plotter dialo g shown in Fields to Plot Starting Point Ending Point Number of Points to Plot Figure 97 This dialog enables Magnetic Flux Densit
93. be entered in one of three ways Scalar Mass Density File or Formula Relative Permittivity Mame e Scalar this option requires entry of a constant uniform Relative Permeability i e a single Permeability Source number aan Relative Permeability e File this option requires the filename for a two column file containing the BH curve for the material When this option is chosen the Browse button becomes active so that you can locate the Pork Eupen file In addition the Plot button becomes active All units SI so that you can plot the data This helps ensure that the selected file contains the intended data e Formula This feature is not yet functional FIGURE 119 Add Edit Material dialog Future versions of BOA will allow the user to enter BH curves via equations eg B 0 2 H 0 2 Thermal Conductivity Yield Coefficient Notice that some of the relative permeabilities provided for the built in materials are scalars 1 e constants appear in the Relative Permeability column in Figure 118 while others are non linear with data provided via a separate file 1 e filenames appear in the Relative Permeability column in Figure 118 Only user entered materials can be edited or deleted The material entries built into BOA e entries in yellow highlight cannot be altered To delete a user created entry use the Delete Mate rial button see Figure 118 Similarly to modify a user cre
94. bl ments table as shown in Figure 159 e E E Emizsion Properties 12 Click the Electrostatic tab Check Humber of Particle Launch Mesh Faces jon approsimate the Visible checkbox for the Anode i umber of Launch Sites per Launch Face 1 and the Mod Anode to make them i Humber of Thermal Energy Levels per Launch Site i visible again Number of Thermal Angles per Launch Site fi must be an odd number 13 Click OK to close the Attribute Total Number of Particles Trajectories 100 approximate Assignment dialog foo g 8 Emitter Temperature 1050 C Find work Function optional 14 To reset the model position open Emitter work Function E el Tungsten 1 8 od the View menu and select Reset Include Temperature Correction Include Relativistic Correction View Meshing Parameters 4 1 3 5 Generating the Initial Elec Grid Present trostatic Mesh Cathode to 4node Spacing 10 0 7 in Cathode to Grid Spacing 104 in Once JOu complete the attribute elo Depth of Finer Mesh Region extended from 0 in ments you are ready to generate the Emitter only in effect with adaptrvity initial electrostatic mesh Unlike in Examples 1A and 1B you will define Cancel areas of finer mesh control FIGURE 161 Defining a thermionic emitter 126 5 10 BOA Version 4 User Manual v0 5 updates in progress 1 Open the Meshing pulldown menu and select Parameters The dialog box shown in Figure 162 will appear Electrosta
95. click Save Case 4 1 1 5 Specifying the Geometry File Next specify the geometry file on which to base the analysis The Boa installation Geometry Model Parameters Electrostatic Geometry includes the geometry file you will need CAD Drawing to complete this example as discussed Browse CAD below Geometry Solid Model File LAB Gun SAT l Click the Browse button next to the Click on the Model menu item and the dialog shown in Figure 125 will appear Unlike Figure 125 initially the Geometry Solid Model File data oe Suis entry box will be blank C wye Semelntinite C wy Semi lnfinite C pz Semi lnfinite C 2 Bemi lnfinite C s Semilnfinite Cy Semi lntinite 2 Semi lnfinite Background Model has built in symmetry Cy Finite f y Finite t 3 Finite Geometry Solid Model File data entry box to locate the geometry file This will bring up a Browse window that Model Units See note below allows you to locate the desired geometry file Mote units will be determined once model i loaded Locate the file JLAB Gun SAT If o Cancel Load Model you installed BOA using the default directory settings this file will be located in C Program Files CCR Beam Optics Analyzer Examples CAD Files Select the file and click Open or alternatively double click on the file FIGURE 125 Geometry Model Parameters dialog 102 5 10 BOA Version 4 User Manual v0 5 updates in progress
96. close without saving Save Case Saves the current Case Save Case As Allows you to copy the MEET selected case to either the current Project directory with a different Case name or Copy Selected Case Sample Case 1 n To C Jlab Klystron Gun Sample Project Copy of Sample Case 1 Browse another Project directory with the same or different Case name This can be useful for ole eee Siit A na a Ae E backing up cases and can also be useful for BREN te sending a case to CCR for debugging during ae sas the beta test period Figure 6 shows the Copy dialog FIGURE 6 Copy Case dialo Py 8 If you copy the case to the current Project directory the Add New Case to Current Project checkbox gives you the option to add the case to the Project Adding the case means that in addition to it being copied into the directory it will also appear in the Project Case Manager If you choose not to add the case when you copy you can always add it later using the Import Pre Existing Case feature If you copy the case to another Project directory the case will be copied only not added You will need to use the Import PreExisting Case feature when that Project is open in order for it to appear in the Project Case Manager The Copy Meshes checkbox gives you the option to include or exclude the meshes when the copy is performed 10 5 10 BOA Version 4 User Manual v0 5 updates in progress 3 4 File Menu
97. cluding the mesh if it is On It operates similarly to the Extent Clipping features discussed in the Elec trostatic and Magnetostatic results sections When the Clipping radio button 1s set to On the XYZ ranges x Min x Max y Min y Max z Min z Max are used to determine which portion of the results to display The ranges initially default to the full range of the problem space For refer ence these default values appear above each edit box this makes it easy to reset the values The units for all values are the model units Changes to the ranges do not take effect in the graphics window until you click the Apply button or hit Enter For an example of extent clipping used with the Electrostatic results see Figure 79 on page 68 Extent clipping for the power density display is analogous 3 11 3 4 Trajectories When the Display Traj Planar Particles radio button is set to Trajectories e the trajectories appear in the main window as shown in Figure 106 and BOA Version 4 User Manual v0 5 updates in progress 5 10 87 e the Emissions and Trajectories section of the Beam Optics Display Control Panel dialog becomes active confirm only true if Mattie and Thuc take my suggestion vE a on Std E BoaGui MSDC Project boa File View Analysis Model Attributes Meshing Execute View Results Tools Help a x Project MSDC Project H Case Example 2A EA Case Example 2B Analysi
98. conductors E E only By definition a part with a uniform current anaes a S density can only be a straight conductor because the current density is uniform in both magnitude and direction Current Density Assigned to Fart Component Amps in 2 a Y Component 0 Ampein 2 ee Ampana To define a part with a uniform current density set the Select Current Vector Type drop down box located beneath the Current Density Attribute Assignment table to Uniform Current Density Cancel and click the Add Part s button The main window 3 containing the geometric model will become FIGURE 44 Uniform Current Density dialog active Select the desired part by pressing Ctrl Left mouse button Click Enter to complete the part selection The dialog box shown in Figure 44 will appear Enter the values for the three components of the current density Click OK to complete the definition The part will appear in the Current Density Attribute Assignment table Z Component 0 Analytic Cylindrical Solenoid This option should be used for solenoid cylinders of uniform thickness The geometry model for the solenoid must consist of either e a single cylinder of uniform thickness or BOA Version 4 User Manual v0 5 updates in progress 5 10 41 e two parts that make up a uniformly thick cylinder and intimately in contact each part can be any angular fraction of the cylinder cross section e g two 180 degree halve
99. ctive surfaces are used to model symmetry During the simulation when particles encounter reflective sur faces they reflect back like a ray of light hitting a mirror So for example instead of modeling a complete sphere you could model one octant of the sphere a symmetric ea 1 8 slice and then define the three sliced faces as reflective Similarly for a Pierce gun only 1 2 or 1 4 of i ner the gun would be required Reflective Surface Assignment Eq FIGURE 41 Reflective Surface To add a reflective surface click on the Reflective Add Assignment dialog button beneath the Optical Surface Assignments table shown in Figure 39 This will bring up the containing the geometric model Find the surface you want to define as reflective and select it by pressing Ctrl Left mouse button Click enter to select The dialog shown in Figure 41 will appear Enter the desired Name if editable and select a Color Remember the Name field will not be editable for any surface that already has a name in the CAD model Click OK to complete the assignment The reflective surface will appear as an entry in the table To modify an Optical Surfaces entry once it is defined select it in the table and click the Modify button The appropriate dialog will reappear and you can edit the values To delete an entry select the entry in the table and click the Delete button 38 5 10 BOA Version 4 User Manual v0 5 updates in progress
100. ctories Planar Particles Generate Terminal Particles File Generate splay Particle Particles File Name 4 Enpa out e Hide this dialog temporarily Hide FIGURE 197 Beam Optics Display Control Panel dialog By default the Display Traj Planar Particles radio button is set to display Trajectories In order to view the trajectories inside the collector you will need to slice the model Go to the View menu and select Slice Model On the resulting Slice Electrostatic Model dialog select the zx plane in the Choose Plane section The trajectories will be exposed as shown in Figure 198 Click Close to close the Slice Electrostatic Model dialog 150 5 10 BOA Version 4 User Manual v0 5 updates in progress 4 Use the mouse to zoom in on the trajectories as desired When you are done use the Reset View on the View menu to reset the view y BE i Project MSDC Project KA Case Example 24 Analysis Type Electrostatic Beam Date Modified Jul 04 2009 03 21 PM Comments Iteration 4 Current 4 3416 Case Example 24 FIGURE 198 Trajectories 5 Next take a look at the power densities on various surfaces inside the collector For better viewing first turn off the trajectories by setting the Display Traj Planar Particles radio button to Off on the Beam Optics Display Control Panel 6 Set the Display Surface Selector Power Densities Selected Surf radi
101. ctrodeSurace 36 38 39 40 41 42 43 44 2 0 1 0 3 0 00 purple ModT unnel 4 17 zt 0 1 0 3 0 00 purple i i Add Surace s Add Part HModity Delete FIGURE 166 Local Mesh Refinements 7 The next surface to define is part of the focus electrode It will be easier to select if only the focus electrode is visible Click the Attributes menu item to bring up the Attribute Assignment Properties dialog Notice that you can open this dialog without closing the Electrostatic Mesh Parameters Optional dialog The Attribute Assignment Properties dialog simply pops up on top In the Properties at the Part Level table on the Electrostatics tab make all parts invisible except the Focus Electrode That is select the Mod Anode and uncheck the Visible checkbox Do the same for the Cathode and the Anode Click OK to close the Attribute Assignment Prop erties dialog 8 The Electrostatic Mesh Parameters Optional dialog will still be open In the Local Mesh Refinement section click the Add Surface s button beneath the table This will bring up the graphics display window containing the electrostatic geometry model 9 Orient the model as shown in Figure 167 The goal is to define the portion shown in purple in the right hand image as a Local Mesh Refinement 1 e as a mesh controlled surface Use the Ctrl Left mouse button to make the necessary selections You will need to move the model around in order to select all associated surf
102. d Surface Center 3D Select x 0 re y 202 5 mm Second End Surface Center The 3D Select button enables you to locate endpoints anywhere within the bounding box of the model The Surface Select button will only allow you to locate endpoints on the surface of the model Bee eS FIGURE 225 Free cylinder definition GUI The generation of the results view may take a few minutes BOA Version 4 User Manual v0 5 updates in progress 5 10 169 The final step is to view the results through the menu item View Results Magne tostatics The dialog in Figure 226 controls the display Set the con trols as shown in the figure Note that because the magnitude of the field in the iron is much higher than the field of interest it is necessary to reduce the maximum displayed flux density The field of interest 1s expected to be about 0 02 Tesla and the maximum is set to 0 1 Tesla Note also that clipping is turned on to allow viewing of the yz plane at x 0 The field at x 0 is shown in Figure 227 The utility of the high density mesh along the beamline by the free cylinder is apparent The irregularity of the surface outside of the free cylinder is due to the lower mesh density and the fact that no smoothing is done in this view The field that would be used in beam simulation is smoothed The field is Magnetostatic Display Control Panel 0D 1D Display Data Point Line Plot 20 and 30 Display Display fo
103. d is considered a shell a part having a small thickness 50 5 10 BOA Version 4 User Manual v0 5 updates in progress To add a surface or set of surfaces to the Local Mesh Refinements table click on the Add Surface s button This will bring up the main window containing the geometric model Find the desired surface and select it by pressing Ctrl Left mouse button Click enter to select The dialog shown in Figure 54 will appear Enter the desired Name if editable and select a Color The Name field will not be editable for any surface that already D Surface Local Mesh Refinement Name o Tag Color default Set Mesh Size Relative Size Meshes set in entities with local mesh refinement may be refined but not coarsened under adaptivity FIGURE 54 Surface Local Mesh Refinement s Add Surface Set Curvature Based Refinement Parameter Factor Relative Mesh Size Limit coe SSS OO has a name in the CAD model Set the Mesh Size parameters Type and Size and the Curvature based Refinement parameters Parameter Factor and Relative Mesh Size Limit for the surface These parameters are defined in the Global Mesh Refinement section above Here they have a similar meaning however they apply only to the surface s specified To add more surfaces to the entry use the Add Surface button This option is only available for surfaces that are not named in the model Click OK to complete the assign
104. dates in progress 5 10 107 6 To hide the initial mesh open the Meshing pulldown menu The Display Initial Mesh gt Com plete item is preceded by a check mark indicating that the initial mesh is displayed Click it to uncheck it and the mesh display will turn off Boats Jlab Kistner Gun Projeti boa TE Pie Yew Anay Ma aiie Meche frets Yew A Loh Cite Fraps ji reais Type Elecro stir Pe eed lar i cee Har 04 SOY C2115 PM Comment Liner Maral Exes 1A Jab chectran Gun Elect oshabe y FIGURE 134 Initial Electrostatic Mesh with Extent Clipping 4 1 1 10 Executing BOA without Adaptive Meshing Once the initial mesh is generated you can execute the BOA engine 1 Open the Execute pulldown menu and select Single Case gt Execute 2 The dialog box shown in Figure 135 will appear 108 5 10 BOA Version 4 User Manual v0 5 updates in progress 3 Leave all parameters set to the default values Note that Max Number of Adaptivity Passes 1s set to O which means the mesh will not be adapted for this run Click Execute a Field Solution Parameters Integration Order i Max Number of Adaptivity Passes 0 Adaptivity Objective 0 25 M Use Last Beam Optics Parameters Number of Allowable Iterations ha Min Mum of Iterations a oe ly First First Three Even C fia Iterations Max Num of Self Field Calc ff Self Field Relative Tok p 95 Output Solution and Source Field
105. de Selection Type G tion 4 ar elec ype Ful a Display Power Densities Emitter Min Max wo m Off V Emitter ca On Stage 1 Face 12 Stage 2 Face J3 Display Traj Planar Partides Stage 3 Face off M Stage 3 Wall Trajectories Planar Particles Generate Terminal Particles File Generate Partides File Name 4 Enpa out M er 1000 c e 44444 l v 400 l l 2 5 2 5 7 5 ORS g 2 5 2 5 2 Hide this dialog temporarily Hide Exit l Iteration 4 Case Example 2B FIGURE 101 Beam optics results default settings BOA Version 4 User Manual v0 5 updates in progress 5 10 Current 4 3416 83 displayed results correspond to the default settings on the dialog Particle Iteration set to the last saved iteration Display Power Densities radio button set to Off and Display Traj Planar Parti cles set to Trajectories and Emitters and Trajectories set to the first generation of all enabled emitters 3 11 3 1 Overview This Beam Optics Display Control Panel dialog is shown more clearly in Figure 102 The purpose of this dialog is to enable examination of the following e Power densities This feature displays the power densities in 3D on user selected surfaces e Trajectories This feature displays user selected trajectories in 3D e Planar Particles This feature gen Beam Optics Display Control Pane erates particle projections of user Emitters and Trajec
106. depressed col lector MSDC A cross sec tion of the is shown in Figure 180 An injected beam enters through a open ing in the body of the shown on the right side of the dia gram The voltage on both the body and stage 1 is 25000 Volts The voltage is 16000 volts on stage 2 8000 Volts on stage 3 and 0 FIGURE 180 Cross section of Multi stage Depressed Collector Volts Stage 4 Injected Beam This example consists of two different cases Example 2A illustrates a basic electrostatic beam analysis with an injected beam Example 2B builds on 2A but adds an external magnetic field and secondary emitter surfaces 4 2 1 Example 2A Electrostatic Beam Analysis with Injected Beam 4 2 1 1 Getting Started 1 Open BoaGu1 exe by clicking on the BoaGui icon on your desktop or the BoaGui icon in the Start menu 4 2 1 2 Creating a New Project New Project 1 Go to the File pulldown menu and select New Location Project The dialog in Figure 181 will appear CSBoa Examples Browse Unlike the screen shown in Figure 181 initially Praec Name the first two data entry boxes will be blank MSDC Project 2 Use the Browse button to locate the Boa Default User Material Library Location Examples directory that you created in Exam C Documents and Settings W aleriesApplication Data Browse ple 1 OF Cancel In this example the Project Name 1S lt Project FIGURE 181 New Project Dialog Box 3 Specify the Pr
107. dinate axis of the CAD model x y or z to match to the z axis of the imported magnetic model e Grid Unit is the length unit of the imported field which can be different from the model CCR Imported Magnetic Flux Density bf file Setting the External Magnetic Field Options dropdown box to the CCR Imported Magnetic Flux Density bf file option enables you to import a magnetic flux density file in the CCR for mat This option brings up the dialog box shown in Figure 32 Use the Browse button to locate the desired CCR format Mag netic Flux Density file bf file CCR Magnetic Flux Density Parameters CCR Magnetic Flux Fiama Field Scale i Trans Vector CAD Ases Ta o in Ty 0 in Tz 0 in Alignment of CAD Model to Z Axis 2 ra Grid Unit Field Parameters e 7 a l Enable First Point K y z E Gear Aig Second Faint x y j 1 0625 24 o o m Starting Point Mum of Plot Points fa Plot Parameters Open gt gt Plot to Verify Field ok Cancel FIGURE 32 Dialog for importing a Magnetic Flux Density File in CCR format BOA Version 4 User Manual v0 5 updates in progress 5 10 33 The bf format is a CCR proprietary format and is defined in the Appendix Specify the Field Scale Translation Vector CAD Axes Alignment of CAD Model to Z Axis and Grid Unit if appropriate See BOA Magnetic Flux Density fef file section above for definitions of these parameters Maxwell 3D
108. e Side radio button os eae 5 Click Close The model will be sliced in half Sisal eee exposing the trajectories as shown in Slicing Style F Show Aves of Model Figure 177 C Hollow Set Opacity of Slicing Plane 035 Solid 6 Use the right mouse button to zoom in on the State trajectories as desired 7 To view the intersection of the trajectory parti cles on a desired plane change the Display FIGURE 176 Slice Electrostatic Model dialog Traj Planar Particles radio button to Planar Particles Project Jlab Klystron Gun Project U Case Example 14 gt Beam Optics Display Control Panel Particle Iteration Emitters and Trajectories 9 Emitters Particle Generation Display Power Densities vlemitter jo Off On Display Traj Planar Particles f Off Trajectories C Planar Particles Generate Terminal Particles File Generate Particles File Name 9 Enpa out Hide this dialog temporarily Hide Ready Iteration 9 Current 1 46736 FIGURE 177 Trajectories On shown with the model sliced BOA Version 4 User Manual v0 5 updates in progress 5 10 137 8 In the Planar Particles section leave the Choose Plane radio button set to xy and use the Normal Distance edit box or slider to define a desired distance In Figure 178 the Normal Dis tance is set to 0 75 138 Display Planar Particles of Iteration No 9 Generations 0 e x Pr
109. e 003 159 er sth TLs Slice Electrostatic Model Choose Plane C yz plane x Center 2x plane y Center z Center C wy plane xyz plane Normal Distance x Normal y Normal 2 Normal Slicing Side wrt slicing plane normal Negative Side C Positive Side Viewing Parameters V Show Axes of Model Set Opacity of Slicing Plane 0 35 Slicing Style Hollow Solid State FIGURE 140 Slice Electrostatic Model dialog BOA Version 4 User Manual v0 5 updates in progress 6 If desired experiment with different parameter settings For example increase the Number of Contours to 20 in the Scalar Field Parameters section to see how the picture changes 7 To return the Clipping State to Off set the Clipping radio button to Off in the Clipping State section of the Electrostatic Display Parameters dialog 4 1 1 11 2 Scalar slice of the voltage field on the zx plane Figure 141 shows a scalar slice of the voltage field on the zx plane To generate this picture BoaGui lab Klystron Gun Project boa GCR B File View Analysis Model Attributes Meshing Execute View Results Tools Help Project Jlab Klystron Gun Project Case Example 1A Analysis Type Electrostatic Potential V Date Modified Nov 18 2009 11 48 AM mp a m ae z 3 64e 012 0D 1D Display Iteration Selection Data Point Line Plot
110. e Global Mesh Refine tiectrostatic Mesh Parameters Optional ment section allows you to Z Ceao Logi specify the global parame Global Mesh Refinement ters used for the initial ORE is mesh generation e The Lo ca I Me S h R efin e Finer grain control of meshing on selected model entities ment section lets you spec ify mesh parameters to be used for specific entities in Size 025 Set Curvature Based Refinement Parameter Factor 04 Relative Mesh Size Limit fo 005 Local Mesh Refinement LocalMesh Tag Dim SizeType MeshSize SizeOn Curv Par Curv Min Size 4 ur j the geometr 1C model Add Surfacefs Add Part Add Shell Modify Delete The Boundary Layer sec Boundary Layer To specify Boundary Layer meshes extruded from selected surfaces tion lets you specify mesh parameters for regions that extrude from specified sur face in the model Boundary Layer Number Layers Thickness Enable Add Modify Delete e The Free Region section Free Regions lets you specify mesh To specify free region meshes parameters for user defined cylindrical regions any where within the bounding box of the model Free Cylinder Surface Constrained Cylinder Add Modify Delete 0 o Note that if adaptivity 1s Cancel turned on i e when Max m Number of Adaptivity Passes FIGURE 52 Meshing Parameters dialog box is set to gt O on the Execute BOA dialog subsequent adaptive mes
111. e Launch Mesh FIGURE 24 REPLACE new Tag filed Thermionic Emitter Parameters dialo Faces This value is an estimate 8 only The exact number will be calculated when the initial mesh is generated e Number of Particles per Launch Face BOA Version 4 User Manual v0 5 updates in progress 5 10 25 e Number of Thermal Energy Levels per Launch Site e Number of Thermal Angles per Launch Site This must be an odd number BOA defines the angles such that one angle is always normal to the surface and the remaining angles form sym metrical pairs with respect to the normal Total Number of Particles Trajectories For convenience the user interface displays the approximate Total Number of Particles Trajectories This is calculated as the product of the Number of Particle Launch Mesh Faces Number of Particle per Launch Face Number of Thermal Angles per Launch Site and Number of Thermal Energy Levels per Launch Site E g if the Number of Particle Launch Mesh Faces 50 Number of Particle per Launch Face 3 Number of Thermal Energy Levels per Launch Site 2 and Number of Thermal Angles per Launch Site 3 then the user interface will show Approximate Total Number of Emitted Parti cles 900 Keep in mind that since the number of launch mesh faces you enter is an approxi mation this calculation is also an approximation The exact number of emitted particles will be calculated when the initial mesh is generated Emitter
112. e Mass Density used with secondary emitters e Relative Permittivity used in electrostatic analyses e Relative Permeability used in magnetostatic analyses e Thermal Conductivity used in heat transfer analyses not yet implemented e Yield Coefficient used with secondary emitters e Work Function used for thermionic emitters BOA provides an initial set of commonly used materials shown in Figure 118 These initial Material Properties m Rel Permeability Thermal Conductivity All units SI Location of User Material Library C Users Walerie AppData Roaming CCR Beam Optics Analyzer onfi Add Material Delete Material Modify Flot cancel FIGURE 118 Material Properties dialog built in materials cannot be edited or deleted Users can supplement this library with their own materials The Location of User Material Library shows the location where the data for all user entered materials reside This directory is specified once when you initially create a project via the New Project dialog and it cannot be changed thereafter 98 5 10 BOA Version 4 User Manual v0 5 updates in progress To add a new material to the Material Properties library Materialdsroparty Wiza click the Add Material button The dialog shown in Figure 119 will appear Enter the Name for the material and enter all values in SI units Note that the Perme SUD li ability Source dropdown box enables the Relative Per ee HES meability to
113. e Name 4 Enpa out ugal forces of the particle beam P PE Planar Beam Centr 6 746 0 6 746 Num Partides 478 Flot Params e In addition a larger non editable box Total Current grg A TotalKE gm eV BT ap p Cars containing the Total Current The planar partide output file Papa ppo is saved in the case directory Total Kinetic Power B eam D ameter For plane 0 with coordinate 6 7459 Total Current 5 14684 Total Kinetic Power the first derivative of the radius with EE a al respect to the beam axis dr dz and jariabl a fax KE eV 7953 6 10 2018 297618 the second derivative of the aa Bars Ea ais uae ae aes snes Para KE eV 7230 36 6 24968 294717 a respect to the beam AXIS d r v_perp ic 0 0261545 0 000346618 D OSE dz Note that once calculated the ia information in this larger non edit REAR RM Se 1 1 Atrmean 5 65 able box remains available after you 6 6768 use the Return button at the bottom of x Qa r D 417078 L 45577e4006 1 575e 008 6 6 the screen to switch the Particle Sta 0 0801092 0 473593 1 88459e 006 6 84e 010 1 17 a l 0 00113794 0 0127354 27737 4 0 0 tistics section back to the Planar Par TE 0 00154496 0 0175637 36870 5 0 0 i ticles section This 1s also true for the Brillouin field Bb Save Stat File Save Return to Planar Partides Return If the analysis includes an external mag netic field 1 e 1f the Analysis type is set FI
114. e Self Field Relative Tolerance If the nor malized relative energy norm is less the self field solution converges Also if the number of self field iterations exceeds the Max Number of Self Field Calc the self field solution also stops In summary the self field calculation algorithm is a The beam without the self field is run until it converges b The converged beam current in a is used to compute the self field c With the just computed self field kept frozen the beam is run again until convergence d Steps a c are repeated until the number of self field iterations exceeds the Max Number of Self Field Calc or the relative energy norm of the present to the previous iterated self field is less than the Self Field Relative Tolerance 60 5 10 BOA Version 4 User Manual v0 5 updates in progress Output Solution and Source Fields Every N Iterations This parameter controls how often the solution and source fields are output to results files A value of 1 the default value means the solution and source fields are written to files for the first two iterations the Oth and 1st iterations and for the last iteration This is the case regardless of whether or not the solution converges Example If you set this value to 3 and the simulation stops at the 14th iteration then the solution is written to files at Oth Ist 4th 7th 10th 13th and lastly 14th iterations If you abort the job at the 9th iteration you can still obtain the r
115. e Single Point Magnetostatic Field Extractor dialog Point Location x y amp z Surface Selection Allows you to select the point anywhere on the surface of the model Click the Surface Select button and the main window containing the geometry model will become active Use the Ctrl Left mouse button to select the point Only points on surfaces can be selected A small dot will appear for the selected point and the xyz coordinates will automati cally appear in the fields provided on the Single Point Magnetostatic Field Extractor dialog Point Location x y amp 2 3D Selection Allows you to select the point anywhere within the bounding box of the prob lem space Click the 3D Select button and the main window containing the geometry model will become active A 3 plane widget will appear Use the Ctrl Left mouse button to move the planes to their desired positions To complete the selection click 3D Select on the Single Point Magnetostatic Field Extractor dialog The xyz coordinates of the point represented by the intersection of the three planes will automatically appear in the fields provided on the Single Point Magnetostatic Field Extractor dialog Point Location x y amp 2 5 10 BOA Version 4 User Manual v0 5 updates in progress Once you specify the desired field and the desired point click the Extract button The resulting value s will appear in the appropriate Field Value at Selected Point boxes as shown in Figure 100 T
116. e View Analysis Model Attributes Meshing Execute View Results Tools Help open the M e 5 hi ng pull ta Ea Jlab Klystron Gun Project Case Example 14 down menu Select Dis wailed ae Gee Comments User Manual Example 14 Jlab Klystror play Initial Mesh gt Complete The mesh will appear in the Main Window 2 To get the exact orienta tion shown in Figure 132 click on the View pulldown menu and select Reset View You may need to use the zoom out feature to view the entire mesh Right click on the mouse and drag it back ward or down until the complete mesh is in view FIGURE 132 Initial Electrostatic Mesh 3 To display only a part of the mesh use the Extent Clip ping feature Open the Meshing pulldown menu and select Extent Clipping Initial Mesh The Mesh Extent Clipping dialog will appear Mesh Extent Clipping Specity Bounding Box Parameters to Clip 1 1 1 1 a Mire 1 1 2 Mar g 1 1 1 1 Y Mini EE Y Max E 4 Change the X Max value to 0 as shown in Figure 133 and click OK The partial mesh will appear in the graphics display region as shown in Figure 134 1 5 O78 5 To turn off the Extent Clipping feature reopen the ZMin te zmajaz Mesh Extent Clipping dialog 1 e open the Meshing P pulldown menu and select Extent Clipping Initial a Mesh and turn the Clipping State radio button to Off C oii Cancel FIGURE 133 Mesh Extent Clipping BOA Version 4 User Manual v0 5 up
117. e mesh BOA Version 4 User Manual v0 5 updates in progress 5 10 77 a 4 The Clipping State section allows you to remove sec pe TIEPE ia oninurere tions of the displayed results in order to view the inter lt Clipping State mm nal structure When the Clipping radio button is set to i ee ee P el La i z lipping x Min 50 x Max 35 3 On the XYZ ranges x Min x Max y Min y Max z 5 O of om bas Min z Max are used to determine which portion of oe f On yin y Max 3500 a the results to display The ranges initially default to the lt lt p s full range of the problem space For reference these Bhs ia r S z Min LAr z Max E an default values appear above each edit box this makes 3 mA lt it easy to reset the values The units for all values i Apply shown in parentheses after the words Clipping wa a aaa State are the model units Changes to the ranges do i not take effect in the graphics window until you click FIGURE 93 Clipping State section of the the Apply button or hit Enter Magnetostatic Display Parameters dialog The Clipping feature operates identically for both the Magnetostatic and Electrostatic results Refer to Figure 78 and Figure 79 on page 68 in the Electrostatic results section to see additional examples of extent clipping _ The Scalar Slicing button located beneath the Display Vector Field Comp radio buttons see Figure 94 accesses the Scalar Field Cut
118. e of the selected vector field This section is inactive if the Display Vector Field radio button 1s set to Off The parameter settings include the size of the vector arrows Vector Scale Factor and the Displayed Min and Max values for the field The Displayed Min and Max values initially default to the Calculated Min and Max values The Calculated Min and Max values appear for reference this makes it easy to reset the values The Display Leg end checkbox turns the legend on and off and the radio buttons labeled Horizontal and Vertical dic tate the legend location 3 16e 005 1 66e 005 1 48e 004 1 37e 005 2 68e 005 Current Density A m 2 The Display Vector Field Comp radio buttons turn the display of the various vector field components FIGURE 90 Display of Current Density on and off Options include 76 5 10 BOA Version 4 User Manual v0 5 updates in progress Off does not display any components x Component displays magnitude of the x component of the selected vector field y Component displays magnitude of the y component of the selected vector field z Component displays magnitude of the z component of the selected vector field Magnitude displays total magnitude of the selected vector field The Component Parameters section 1s active when the Display Vector Field Comp radio buttons are set to something other than Off The Show Contour checkbox controls the appearance
119. e spent beam can be either Cartesian or Polar beam Like Magic2D beams its spent beam axis 1s also assumed to be always the z axis Thus the original injected plane will always be the xy or r plane normal to the z axis and the direction of the beam is assumed to always point to the same direction of the positive z axis Also like Magic2D beam a Christine beam is always a transformed type and always requires coordinate transformations The format of a Polar Christine beam is pID KE keV Phase deg r cm O deg p mc pg mc I A where pID is the particle number KE is the particle kinetic energy p and pg are the particle nor malized momenta The format of the Cartesian Christine beam is assumed to be pID KE keV Phase deg x xm y cm p mc py mc I A Note This format still needs to be confirmed This format is not based on an example it is just extended from a provided example of Polar format Thus the Cartesian Christine file format is subject to change when the time comes to model sheet beams in Christine 6 1 3 External Magnetic Field File Currently BOA supports the following file types for external magnetic fields e Boa Magnetic Flux Density fef file e CCR Imported Magnetic Flux Density bf file e Maxwell 3D Imported Magnetic Flux Density e Maxwell 2D XY Imported Magnetic Flux Density e Maxwell 2D RZ Imported Magnetic Flux Density e Pandira Poisson RZ Imported Magnetic Flux Density e 1D Axial Imported Magnetic Flux Dens
120. e the Slice Electrostatic Model dialog 4 1 3 7 Executing BOA without Adaptive Meshing Once the initial mesh 1s generated you can execute the BOA engine 1 Open the Execute pulldown menu and select Single Case gt Execute BOA 2 The Execute Single Case Electrostatic Analysis dialog will appear This dialog was shown in Example 1A Figure 135 BOA Version 4 User Manual v0 5 updates in progress 5 10 135 3 Leave all parameters set to the default values As in Example 1A note that Max Number of Adaptivity Passes is set to 0 This means the mesh will not be adapted for this run Click Execute 4 A DOS window will appear indicating progress during BOA execution Note that this run will usually take longer than Examples 1A and 1B When BOA completes the following text will appear at the bottom of the window Proceed to View Results but first Press any key to con tinue exit Hit any key to close the DOS window and return control back to the user interface Notice that the lower right corner is used to monitor the progress of the simulation The conver gence plot displays the beam current the relative errors of the electric field and emission current versus particle iterations For a clearer and larger display you can show the plot in the main win dow or a new window by going to View menu and selecting Plot Parameters On the resulting Plot Control Parameters dialog set the Plot Type dropdown box to Convergence
121. ears as a standard continuous contour plot like the one shown in Figure 104 Alternatively if the Show Contour checkbox is checked you specify Num ber of Contours and the dis play will group like values into the specified number of discrete contour lines as shown in Figure 105 The Displayed Min and Max values dictate the upper and lower values displayed These values initially default to the Calculated Min and Max val ues The Calculated Min and Max values appear for reference making it easy to reset the values The Display Legend checkbox turns the legend display on and off and the radio buttons labeled Horizontal and Vertical dictate the legend placement FIGURE 104 Power Density contour plot with Show Contours uncheck 86 5 10 BOA Version 4 User Manual v0 5 updates in progress Changes take effect when you click the Apply button or hit Enter Showing the Mesh The Initial Mesh or Adapted Mesh section controls the dis play of the mesh The section label refers to the mesh used in the generation of the results If the mesh was adapted it 1s labeled Adapted Mesh if not it is labeled Initial Mesh The Display Mesh radio but tons show and hide the mesh The Show Mesh Outline checkbox displays an outline of the mesh FIGURE 105 Power Density contour plot with Show Contours checked Using Extent Clipping The Clipping State section allows you to remove sections of the Power Density display in
122. ect Com plete The mesh will appear in the graphics display region 2 To get the exact orientation shown in Figure 170 click on the View pulldown menu and select Orientation gt Iso metric You may need to use the zoom out feature to view the entire mesh Right click on the mouse and drag it backward or down until the FIGURE 170 Initial Electrostatic Mesh complete mesh is in view Pesin Curren 132 5 10 BOA Version 4 User Manual v0 5 updates in progress 3 To display only a part of the mesh use the Extent Clipping feature Open the Meshing pull down menu and select Extent Clipping Initial Mesh The Mesh Extent Clipping dialog shown in Figure 171 will appear Mesh Extent Clipping 1 1 os Mar ooo 1 1 Max a T 0 78 Min 18 Z Max 0 78 Clipping State f On C Off Cancel FIGURE 171 Mesh Extent Clipping dialog 4 Change the X Max value to 0 and click OK The partial mesh will appear in the graphics dis play region as shown in Figure 172 FIGURE 172 Initial Electrostatic Mesh with Extent Clipping BOA Version 4 User Manual v0 5 updates in progress 5 10 133 5 To get an even better look at the mesh slice the model Click on the View menu item and select Slice Model The Slice Electrostatic Model dialog shown in Figure 173 will appear On the Slice Electrostatic Model Choose Plane f pz plane Center C ax plane y Center C xy plane 2 Center aye plane Normal Dista
123. ed When these three sec ondaries of the Ist generation hit another secondary emitter another three electrons of the 2nd generation are emitted When these 2nd generation secondaries hit another secondary emitter they do not propagate any further since there is a maximum of two generations Click OK to complete the emitter definition The emitter will appear in the table To modify an emitter once it is defined select the emitter in the emitter table and click the Modify button The appropriate dialog will reappear and you can edit the values To delete an emitter select the emitter in the emitter table and click the Delete button 3 8 2 3 External Magnetic Field Options The External Magnetic Field Options section on the Beam Optics tab refer to Figure 23 enables you to define an external magnetic field It is active when the Analysis menu is set to either Elec tro Magnetostatic Beam or Electro Magneto Self Field Beam The drop down box contains the following options Uniform Magnetic Flux Density Boa Integrated Magnetic Case Boa Magnetic Flux Density fef file CCR Imported Magnetic Flux Density bf file Maxwell 3D Imported Magnetic Flux Density Maxwell 2D XY Imported Magnetic Flux Density Maxwell 2D RZ Imported Magnetic Flux Density Pandira Poisson RZ Imported Magnetic Flux Density O ON WB an A WW N e 1D Axial Imported Magnetic Flux Density Choose the desired option and a dialog will appear
124. ed analysis type For example in Figure 20 the Magnetostatic tab is absent because the Analysis menu is set to Electrostatic Beam Note that the Miscellaneous tab is for internal CCR use during the Beta testing period only Users should not use this tab unless troubleshooting with CCR personnel 20 5 10 BOA Version 4 User Manual v0 5 updates in progress 3 8 1 Electrostatic Attributes The Electrostatics tab Attribute Assignment Properties k a shown in Figure 20 is Electrostatcs Beam Optics Optimizer Misc used to assign properties Properties at the Part Level required for an electro static analysis It is enabled when the Analy Sis menu is set to one of the Electrostatic analysis types The tab includes sections for defining prop erties at both the part level and the surface level 3 8 1 1 Properties at the Part Level The Properties at the Part Level section allows you to assign properties to the parts that make up the geometric model The table at the top of the sec tion contains all of the parts defined in the elec trostatic geometry file It is automatically popu lated based on the file specified on the Geometry Model Parameters dialog Additional entries cannot be added To mod ify a part s properties first select the part to make it active The properties beneath the table will then become available Properties include FIGURE 20 Attribute Assignment dialog box Electrostatic
125. ed and enter the value for the Cathode to Anode Spacing The units for the spac ing are the length units defined for the model as defined in the geometry file Note that the spacing value is approximate It can vary 10 The Depth of Finer Mesh Region extended from Emitter parameter allows you to define a region of finer mesh around the emitter It is used only when adaptivity is turned on 1 e when Max Number of Adaptivity Passes is set to gt 0 on the Execute BOA dialog The region is defined as a virtual column of user specified depth extending from the emitter surface The mesh within the column will be adaptively refined to approximately the same mesh size as on the emitter surface 26 5 10 BOA Version 4 User Manual v0 5 updates in progress Click OK to complete the emitter definition The emitter will appear in the table Injected Emitters To add an injected emitter click on the Injected Emitter Add button beneath the emitter table on the Beam Optics tab see Figure 23 This will bring up the graphics display window contain ing the geometric model Find the sur face you want to define as the emitter and select it by pressing Ctrl Left mouse button Click enter to complete the selection The dialog box shown in Figure 25 will appear Enter the desired Name for the injected emitter and select a Color If the surface is already named in the geometry model the Name will not be editable Use the Browse button to l
126. ement checkbox and leave the asso FIGURE 168 Defining a Local Mesh Refinement ciated entries at their default values for the Surface FocusElectrodeSurface b Click on Add Surface in the top right of the box This will close the dialog box and return to the model window Select another surface from the purple region shown in Figure 167 You may need to move the Electrostatic Mesh parameters dialog to access the region Hit the Enter key to return to the Surface Local Mesh Refinement dialog and note that another surface tag was added to the Tag box c Repeat this procedure Add Surface gt select surface gt Enter gt Add Surface until all purple regions shown in Figure 167 are selected If you lose track of which surfaces have been selected close the Surface Local Mesh Refinement dialog box and select FocusElectrodeS urface in the Local Mesh Refinement table This will indicate by color which surfaces have been chosen Select the Modify button to add any missed surfaces As you can see select 130 5 10 BOA Version 4 User Manual v0 5 updates in progress ing surfaces that have not been named in the CAD file can be tedious For this reason among others it is highly recommended that you name all important surfaces in your CAD file prior to importing it into BOAGui d Once you have completed the FocusElectrodeSurface definition it will appear in the Local Mesh Refinement section as shown in the second entry of the table
127. er will be generated away from the solid part to which the surface is adjacent Specifying a negative length means the cylinder will be generated into the part You can also specify a nonzero Distance from Surface and the meshes will be created the specified dis tance away from the constrained surface W Enable Complete Surface Name Tag 49 Color detai me Mesh Size 0 in Radius g in Length 0 in Dist from Surface 0 in FIGURE 60 Free Cylinder Meshing The Complete Surface button is provided for cases where the surface is broken into multiple pieces and does not have a CAD name A CAD named surface even if split into multiple seg ments could be selected as one entity obviating the need for using this button For such a case use the Complete Surface button to add the other pieces to complete the selection Click OK to complete the assignment The surface constrained cylinder will appear as an entry in the table To modify a free region once it is defined select it in the table and click the Modify button The appropriate dialog will reappear and you can edit the values To delete an entry from the table select it and click the Delete button 3 9 2 Generating and Displaying the Initial Mesh The next set of items on the Poe z n Meshing pulldown menu see _ Attributes Meshing Execute View Results Tools Help Figure 61 control the genera Parameters tion and display of the initial a aes mes
128. es SJolution and S ource V olume files keep the list of the VTK readable msd files of regional 3D electrostatic or magnetostatic fields generated from post processing the fef files via either Electrostatic Display Control Panel or Magnetostatic Display Control Panel e sss files S olution and S ource S urface files keep the list of the VTK readable mss files of surface 2D electrostatic or magnetostatic fields generated from post processing the fef files via either Electrostatic Display Control Panel or Magnetostatic Display Control Panel e pws files PoW er S urface files keep the list of the VTK readable spd files of surface 2D power density fields generated from post processing the fef files only in Beam Optics Display Control Panel e ebm files E nd B ea M files keep all terminal particle attributes automatically created after each Beam Optics Analysis e out files Output files from various tools such as PAPA and Enpa e cde files keep the current and potential convergences during a beam analysis This file is used to update the Convergence plot BOA Version 4 User Manual v0 5 updates in progress 5 10 183 e tdb files T empo D ata B ase files to keep track of the fef and jc files available after each iteration during the analysis These fef and jc files are listed only for those iterations that users select to store outputable iteration The Oth Ist and last iteration files are always stored Noted
129. es the following text will appear at the bottom of the window Mesh Genera tion Complete mesh file created _E sms Press any key to continue exit Hit any key to close the DOS window and return control back to the user interface 148 5 10 BOA Version 4 User Manual v0 5 updates in progress If desired you can view the mesh by opening the Meshing pulldown menu and selecting Display Initial Mesh The mesh will appear in the graphics display region This step was illustrated in the previous JLAB example See Example 1A for details 4 2 1 10 Executing BOA Once the initial mesh is generated you can execute the BOA engine 1 4 2 1 11 Viewing Beam Analysis Results Open the Execute pulldown menu and select Single Case gt Execute BOA The dialog box shown in Figure 196 will appear Leave all parameters set to the default values Note that Max Number of Adaptivity Passes 1s set to O which means the mesh will not be adapted for this run Click Execute A DOS window will appear indi cating progress during BOA exe cution When BOA completes the following text will appear at the bottom of the window Proceed to View Results Press any key to continue exit Hit any key to close the DOS window and return control back to the user interface Execute Single Case Electrostatic Beam Analysis Field Solution Parameters Integration Order Max Number of Adaptivity Passes 0 Ada
130. es 3 Surface Emision Properties Select a Surface Material Copper Optional Select Yield or Atomic Specification field f Atomic Specification E Atomic Number 62546 Atomic Mass Secondary eld Coefficient 8960 0 Material Density kgm 3 Meshing Parameters Depth of Finer Mesh Region extended from Emitter only in effect with adaptivity FIGURE 212 Assign Secondary Electron Emission Parameters dialog 5 10 BOA Version 4 User Manual v0 5 updates in progress ary emitters This is how the table will appear after you have completed all secondary emitter definitions as described in the next few steps Emitter Assignments Hame Type Color Face Tag Enable Emitter Injected_E rmitter red eu Yez Modify Stage 1 Face Secondary Ernitter pello 5 9 Yez Stage Face Secondary Erntter pello 44 45 es Stage 3 Face Secondary Emitter yellow 20 21 es Delete Stage 3 Wall Secondary Erntter pello 23 24 Yez Thermionic Emitter dd Injected Emitter dd Secondary Emitter ddd FIGURE 213 Emitter Assignments table shown with four Secondary Emitters defined 9 Next define the Stage 2 Face as a secondary emitter Again click the Secondary Emitter Add button beneath the Emitter Assignments table This will bring up the graphics display window containing the geometry model 10 Select the Stage 2 Face by pressing the Ctrl Left mouse button The Stage 2 Face surface is a named surface in the CAD file consi
131. esh surfaces to the entry use the Add Surface button This option is available only for surfaces that are not named in the model Click OK to complete the assignment The surface s will appear as an entry in the table To modify a boundary layer definition once it is entered select it in the table and click the Modify button The appropriate dialog will reappear and you can edit the values To delete an entry from the table select it and click the Delete button 3 9 1 4 Free Regions Free Regions are user defined cylindrical regions for which the user can define a mesh size One reason for adding a free region is to get better resolution around the beam area in a beam analysis This cylindrical region can be defined in one of two ways e A Free Cylinder is defined by specifying two end face center points and a radius The cylinder axis is the line connecting the two centers e A Surface constrained Cylinder is defined by first selecting a surface and then defining a radius and a length The surface center is internally computed the cylinder axis originates from this center and is perpendicular to the constrained surface To add a Free Cylinder mesh select the Free Cylinder radio button and click on the Add button beneath the table This will bring up the dialog shown in Figure 59 BOA Version 4 User Manual v0 5 updates in progress 5 10 53 Enter the desired Name and select a Color Make sure the Enable check box is checked T
132. esults As in example 1A you may want to experiment with different parameters to see different results For example to get the result shown in Figure 154 follow the steps below Project JLab Klystron Gun Project Case Example 14 03 Case Example 1B Electric Field V m gt Electrostatic Display Parameters OD 1D Display Iteration Selection 2 98e 0 06 Data Point Line Plot Current Selection f0 X 2D and 3D Display Display for Electric Field Parameters Yim f Surfaces Calculated Min Max Displayed Min Max Min 5030100 Min 3686700 i ok Parts Max 5010700 Max 2980200 1 31e 006 p gt Ae a vector Scale Factor 0 1 Display vector Field E C off ay On V Display Legend Horizontal vertical Display Scalar Field Off 3 53e 005 X ce m es Ey C Ez m r Adapted Mesh Clipping State fin 2 02e D061 Vs Display Mesh Clipping Off C On fe Off C On _ 5 i itt 3 69e 006 T Show Mesh Outline loa Mesh Info Hide this dialog temporarily Hide Close Case Example 18 iain Caer FIGURE 154 E field On with anode and mod anode hidden Set the Clipping State radio button to Off Set the Adapted Mesh radio button to Off Set the Display Scalar Field radio button to Off Leave the Display Vector Field E radio button set to On nA A WO N e When you are done viewing the results continue on to Example 1C Make su
133. esults of the last written iteration which in this case would be the 7th iteration Alternatively if you set this value to 5 and abort at the 9th iteration you have only the 6th iteration available If you use the default value of 1 and abort at the 9th iteration you have only the Ist iteration to postprocess Output Trajectory Data Every N Iterations This parameter controls how often the trajectory data is output to results files A value of 1 the default value means the trajectory data 1s written to a file for the first two iterations the Oth and 1st iterations and for the last iteration This is the case regardless of whether or not the solution converges 3 10 1 3 Logging Options The Logging Options section provides options for showing the run log real time Log to Screen checkbox and creating a log file Log to File checkbox The log filename defaults to Case Name _ log Use the Log File Name edit box to change the filename if desired The log file is placed in the case directory The log file can be accessed within BoaGui from the View Results pulldown menu 3 10 1 4 Restart The Restart section will be active if iterations from a previous BOA run exist To restart a previ ous execution of Boa check the Enable box then choose the particle iteration from the Select Iter ation drop down box The iterations available for selection are based on you selections for both Output Solution and Source Fields Every N Iterations and O
134. etic flux density Bx By Bz in Tesla Boa Integrated Magnetic Case Uniform Magnetic Flux Density Bx oO Tesla By oO Tesla tA aan Ee a Enable ic Bz oO Tesla Field Parameters First Point Second Paint Axis Starting Foint z 259675 z 117 0629 sho j i e paes x A J gt x yi i Mum of Plot Points fio m E z me wj Plot Parameters Open gt gt Plat to Verify Field Lox Cancel FIGURE 27 Dialog for defining a Uniform Magnetic Flux Density Setting the External Magnetic Field Options dropdown box to Boa Integrated Magnetic Case implies that you want to use the magnetic fields which have been generated by BOA from the same geometry of the currently open case To use this option the following should be true e the currently open case was initiated as a Magnetostatic case Analysis menu item set to Mag netostatic e you have run the mesh for and executed that Magnetostatic case so that the magnetic field exists and e you have now changed the Analysis type of the current case to either Electro Magnetostatic Beam or to Electro Magneto Self Field Beam BOA Version 4 User Manual v0 5 updates in progress 5 10 31 If you create such a case in this way then setting the External Magnetic Field Options dropdown box to Boa Integrated Magnetic Case will bring up the message in Figure 28 Click Yes to boaGui 28 A magnetostatic analysis is already i
135. etting the External Magnetic Field Options dropdown box to Boa Integrated Magnetic Case will bring up the informational message shown in Figure 30 This message explains how to create an integrated magnetostatic case 2 boaGui 2 You have selected to use magnetic fields to be generated by an integrated magnetic case A This integrated case would use the same geometry model of the currently open case To be able to select this option you will need to create this integrated case first To create an integrated magnetic case change current analysis type to Magnetostatics and proceed to populate analysis attributes mesh and then excute Once the magnetostatic case has executed switch the analysis type back to the currently active type Electro Magnetostatic Beam verify that the attribute settings are as your desire and then mesh and execute the case as normal For more details see External Magnetic Fields Options in the BOA user manual OK FIGURE 30 A Magnetostatic analysis does not exist in the current case 32 5 10 BOA Version 4 User Manual v0 5 updates in progress Boa Magnetic Flux Density fef file Setting the External Magnetic Field Options dropdown box to Boa Magnetic Flux Density fef file enables you to use the magnetic flux density file gener ated by a previous BOA run This option brings up the dialog box shown in Figure 31 Use the Browse button to locate the desired fef file The
136. ew You can also toggle between the two modes by typing the W key or the S key on the key board w Status Bar FIGURE 8 View pulldown menu This setting applies to all items shown in the graph ics display region This can include the geometric model the mesh initial and adapted and the resulting electrostatic and magnetic fields View Representation Provides two options for view representation Orthogonal and Perspec tive Examples of each type are shown in Figure 10 Orthogonal is the default representation It displays the true view view rays are parallel and objects are rendered without distance effect It provides accurate distance measurements when using the Measure Distance feature under the View Results menu 12 5 10 BOA Version 4 User Manual v0 5 updates in progress FIGURE 9 Examples of surface representations A Wireframe representation is shown on the left and a Surface representation is shown on the right The Perspective representation provides a more pleasing view in three dimensions however it distorts the position of objects relative to each other View rays are NOT parallel and objects are rendered more natural looking but distortion is introduced WARNING The Perspective repre sentation should never be used with the Measure Distance feature It will result in incorrect dis tance measurements TBD Check if this is still true this is a very early constraint Bill Vogler FIGURE 10 Examples
137. exit the Geometry Model Parameters dialog BOA Version 4 User Manual v0 5 updates in progress 5 10 103 10 The geometry model will appear in the graphics display region as shown in Figure 129 e Gul Preject Jab Klystron Gun Project Case Example TAJ Ek Ci ta miera aS Se eee Sete SES ESS a eee her alien Curai FIGURE 129 Electrostatic Geometry Model before attribute assignment 4 1 1 6 Viewing the Geometry Model 1 Experiment with moving the model around in the graphic display region To spin the model around hold down the left mouse button and move the mouse around To zoom in hold down the right mouse button and move the mouse forward or up To zoom out hold down the right mouse button and move the mouse backward or down You also may want to experi ment with different settings on the View menu such as predefined Orientations and different options for Surface Representation Wireframe vs Surface and View Representation Orthog onal vs Perspective 2 To return to the orientation shown in Figure 129 click View gt Reset View 4 1 1 7 Assigning Electrostatic Attributes 104 5 10 BOA Version 4 User Manual v0 5 updates in progress Now you are ready to gt Attribute Assignment Properties begin assigning attributes Electostatics _ Properties at the Part Level 1 Click on the Attributes C t a Vol Charge Rel Permittivit Material Name Inf Domain menu 1tem The Mod anode
138. fef format is a CCR proprietary for mat and it is defined in the Appendix The remaining fields are defined as follows e The Field Scale is the scale Boa Magnetic Flux Density Parameters Boa Magnetic Flux ances Field Scale i Trans Vector CAD Ases Ta 0 in Ty 0 in Tz 0 in Alignment of CAD Model ta Z Axis z Grid Unit Field Parameters Poe rae l Enable First Point K z E JEFE Aig Second Port w y z HE2 Nurm of Flot Points Plot Parameters Open gt gt Plat to Verity Field Lok Cancel Starting Point x y z 2 598 a J M 2Com W FIGURE 31 Dialog for importing a Magnetic Flux Density File in Boa format factor for the imported magnetic field magnitude Set it to 1 to use the imported field as is e The three components of the Translation Vector CAD Axes are required if the origin of the imported magnetic model is different from that of the geometry CAD model The translation vector is used to match the two origins For example if the origin of the imported magnetic model is 2 1 5 and the geometry model is 3 0 0 then the translation vector is 3 2 0 1 0 5 1 1 5 where the elements of each tuple are the x y and z coordinates respectively e If the z axis of the geometry model is different from the z axis of the imported magnetic model a coordinate rotation is also required Use the Alignment of CAD Model to Z Axis drop down box to specify which coor
139. file for the named CAD surface consisting of tags 14 and 17 Set the Color to pur ple Check the Set Mesh Size checkbox and the Set Curvature Based Refinement checkbox and leave the associated entries at their default values 9 Click OK to complete the surface definition BOA Version 4 User Manual v0 5 updates in progress 5 10 131 10 The newly defined surface will appear in the table in the Local Mesh Refinement section as shown in the third entry of the table in Figure 166 11 Click OK to close the Electrostatic Mesh Parameters Optional dialog 12 Click the Electrostatic tab Check the Visible checkbox for the Cathode Focus Electrode and Anode to make them visible again Uncheck the Visible checkbox for the Mod Anode to make it invisible for the remainder of the example It s not necessary to see it and it hides the interior of the gun 13 Open the Meshing pulldown menu and select Generate Initial Electrostatic Mesh 14 A DOS window will appear indicating progress during the mesh generation process When the process completes the following text will appear at the bottom of the window Mesh Genera tion Complete mesh file created JUAB Gun sms Press any key to close the DOS window and return control back to the user interface 4 1 3 6 Viewing the Initial Baai Lab Rito Gua Projecto a Electrostatic Mesh pu wes 1 To view the initial mesh open the Meshing pulldown menu Select Display Initial Mesh and then sel
140. for reference 164 5 10 BOA Version 4 User Manual v0 5 updates in progress The problem was started by select ing Magnetostatic from the drop down menu under Analysis Next an ACIS sat file from a solid model ing program was imported using the dialog activated by selecting Model in menu and shown in Figure 220 In this case the program was Solid Works For this simple model there were no small features that were likely to cause problems with mesh ing so the Small Feature Entities value was left at the default of 0 While the problem has symmetry around the y z plane it is simple enough to allow the whole geometry to be modeled within a reasonable time Thus the Infinite radio button on the Background selection portion of the dialog has been selected The model units were identified by BOA as mm Hitting OK or Load Model loads the model _ Geometry Model Parameters Magnetostatic Geometry CAD Dravang a Browse CAD beomety Solid Model File Solenoid FESAT Browse Small Feature Entities Suppress Background C None Infinite Model haz built in syrmeby C sy 2Semelninte C xy Semidnfinitte yz Sementinite 2x Semelnfinite C x Semelntinite C p Semiininte C 2 SemiAntinite C x Finke C yFinte C 2 Finite Model Units rein OK Cancel Load Model FIGURE 220 Model GUI used to import the model The resulting graphic after slicing View slice model the model on the yz plane
141. for either electrostatic or magnetostatic no beam analysis there is only Oth iteration e trj tdb files keep track of trajectory and power density fef files available after each ouputable iteration during a beam analysis e fef files Finite E lement F ield files keep the solution fields produced by either magneto static or electrostatic field solver Note The clean up feature removes all fef files generated by the case but does not remove those imported into the case such as those generated by another case e yc files Cathode current density files only exists in a beam analysis It stores the current den sity on emitter surfaces e trj files Particle trajectories produced by a beam analysis e msd files 3D volumetric VTK files keeping the 3D fields created from fef files for display e mss files 2D surface VTK files keeping the 2D fields created from fef files for display e spd files 2D surface VTK files keeping the 2D power density field calculated from the power density fef file which actually derived from the trj file e res file from the conjugate gradient solver e sle stores user s selected entities during post processing 184 5 10 BOA Version 4 User Manual v0 5 updates in progress
142. g Ctrl Left mouse button Click Enter to complete the part selec tion and the dialog box shown in Figure 46 will appear Enter the Current at Inlet Surface in Amps and Selected Part SqBox uncheck the Closed Con 2 Directional Current Vector Current at Inlet Surface E Amps ductor checkbox To define the inlet surface click on the Select button Current Inlet Surface Current Outlet Surface in the Current Inlet Sur face section This will Color lied Select Color yellow Select bring up the main window containing the geometry Ponce model Select the desired surface by pressing Ctrl Left mouse button Click enter to complete the selection The Directonal Current Vector dialog box will reappear Set the color for the inlet sur face using the Color dropdown box Repeat the same process for the outlet surface using the Select button and Color dropdown box in the Current Outlet Surface section Click OK to com plete the directional current vector definition The part and surfaces will appear as an entry in the Current Density Attribute Assignment table if Closed Conductor check if want mating part to complete conductor to be found for you Surface not yet selected Tag Surface not yet selected Tag FIGURE 46 Directional Current Vector dialog If you are defining a closed conductor solenoid the process is similar However when you ini tially select the desired part you select just one of the two parts
143. gy and geometry FIGURE 187 Initial Model Verification Message 142 5 10 BOA Version 4 User Manual v0 5 updates in progress 6 The Model Units will appear undefined until you load the model Click Load Model and an informational message will inform you that the initial model has been loaded and verified as shown in Figure 187 Click OK 7 A second informational message will inform La boaGui you that the final model has been loaded and are PE verity the Final model verified as shown in Figure 188 Click OK iy The ne is a CCR SIM model with correct topology and geometry The initial model is the model you specified as is The final model is the initial model plus modifications necessary to make it usable by BOA 8 The model units used in the SAT file will appear at the bottom of the Geometry Model Parameters dialog In this case the units are set to inches FIGURE 188 Final Model Verification Message 9 Click OK to exit the Geometry Model Parameters dialog 10 The geometry model will appear in the graphics display region as shown in Figure 189 BoaGui MSDC Project boa File view Analysis Model Attributes Meshing Execute View Results Tools Help Project MSDC Project gt Analysis Type Electrostatic Beam Date Modified Jul 04 2009 02 10 PM Comments Case Example 24 Iteration Current FIGURE 189 Geometry Model for MSDC 4 2 1 6 Viewing the Geometry Model 1 Experiment with mov
144. h Display Initial Mesh Complete Extent Clipping Initial Mesh On Entities 3 9 2 1 Generation of Initial ital Wiech inicanaiion Add Entities Mesh Abort Meshing The Generate Initial Mesh menu item initiates generation of the initial mesh A DOS window will appear indicating progress during the mesh generation process Once the process is completed hit any key to close the DOS window and return control back to the user interface You must generate the initial mesh before you execute BOA FIGURE 61 Meshing pulldown menu BOA Version 4 User Manual v0 5 updates in progress 5 10 55 3 9 2 2 Display of Initial Mesh The Display Initial Mesh Entity Selector refuel menu item turns the display a of the initial mesh on and off in the main window As Body DisplayiocalMeshRegion SimFace_52 DisplayLocalMeshFace shown in Figure 61 this item contain three sub menus The Complete item toggles the complete mesh on and off The On Entities item toggles the mesh on and on for user Add Surface s Add Region s Modify Delete Cancel selected entities The Add Remove Entities menu item FIGURE 62 Entity Selector Dialog brings up the Entity Selector dialog shown in Figure 62 Use the Add Surface s and Add Region s buttons to add the desired surfaces and regions TBD get definition of Region in some cases it allows you to select whole parts and other times just a subsection of Part Get explanation When the
145. h On Clipping State On 120 5 10 BOA Version 4 User Manual v0 5 updates in progress _ BoaGui JLab Klystron Gun Project boa Project JLab Klystron Gun Project Electrostatic Line Plotter Electric Field You may enter line endpoint coordinates directly into the edit boxes or click on a button to the right to select endpoints 3D Select Surface Select with the cursor The 3D Select button enables you to locate endpoints anywhere Field to Plot within the bounding box of the model The Surface Select button 1400000 f Voltage will only allow you to locate endpoints on the surface of the model Charge Densi Starting Point Ending Point Number of Points to Pl J xe x x 1200000 i Electric Field E r a oe H ae y Comp Y Y Abscissa Type Electric Flux Density D l zComp e z Mu inear 1000000 M Mag z 1 7822 z 0 77645 z Arc Length Plot Parameters Open gt gt Cro Exit amp 8200000 T bi uf 600000 BOA Conwigence 400000 oo 4 06 200000 3 0 ao 0 0 0 5 1 0 1 5 2 0 25 sais Point Distances 6 00 t 00 kannas Case Example 1B Iteration Current FIGURE 152 Line plot of E magnitude along beam axis i e z axis for example 1B The Electrostatic Display Parameters dialog should still be open Click on the Line Plot located in the OD ID section at the top of
146. h the cut plane slightly The cut plane will appear as shown in Figure 141 4 To change the cut plane to contour lines select the Show Contours checkbox in the Contour Specification section The plane will change to a series of contour lines 5 Set Number of Contours to 30 and click Apply or Enter on the keyboard Notice the number of contour lines increase 6 Change the Dist from Center Along Normal back to O and hit Enter to apply the change Notice the plane move slightly back to center see Figure 142 BoaGui lab Klystron Gun Project boa Sich B File View Analysis Model Attributes Meshing Execute View Results Tools Help Project Jlab Klystron Gun Project ER Case Example 1A Analysis Type Electrostatic Potential V Date Modified Nov 18 2009 11 48 AM 3 64e 012 OD 1D Display Iteration Selection Data Point Line Plot Current Selection 0 X Scalar Field Cut Plane x Cut Plane Normal Specification Contour Specification lv Sh t Angle from Z axis 0 to 180 g0 Sirsi ski 4 50e 003 Calculated Scalar Range Min 18000 Max 2 9824e 012 Angle from axis 0 to 360 o Number of Contours 30 Normalized Dist from Center along Normal Minimum Scalar t8000 V 100 100 i Maximum Scalar 2 9824e 012 Yy 9 00e 003 Model 0 010766 Norm lz Viewing Parameters Clipping State Set Opacity 1 F Show Mesh Outline of Con Line Width 2 Clo
147. he vector normal to the plane x Normal y Nor mal and z Normal For example the positive x Normal y Normal z Normal normal vector to the xy plane is lt 0 0 1 gt and Slicing Side wrt slicing plane normal the negative normal vector is lt 0 0 1 gt Use J cii the slider bars to define the distance of the Bice PENN plane along the normal vector Slicing Syle FF Show Axes of Modal Hollow Set Opacity of Slicing Plane 0 The Slicing Side radio buttons control which Solid ii side of the plane is removed The Positive Side zy refers to the side normal to the plane and the C o Negative Side refers to the opposite side The Slicing Style radio buttons provide options for the appearance of the sliced edge of the model Hollow or Solid The Viewing Parameters FIGURE 11 Slicing Input Parameters dialog box 14 5 10 BOA Version 4 User Manual v0 5 updates in progress section contains a checkbox that shows hides the axes and a slider bar that controls the opacity of the slicing plane The Slicing State radio button lets you turn the feature on and off 1 e show or hide the sliced portion of the model When the radio button is set to On a check mark appears in front of the Slice Model menu item on the File menu An example of a sliced model is shown in Figure 12 FIGURE 12 Example of Slicing the Model Screen Snapshot This feature saves a snapshot of the Main Window which typically displays the geometr
148. he Project Case Tree Control and select Save Case 11 Close the Case Right click on the case name in the Project Case Tree Control and select Close Case 4 1 2 Example 1B Electrostatic Analysis with Adaptive Meshing Next you will rerun BOA with adaptive meshing turned on to generate a more accurate solution Project Jlab Klystron Gun Project e Case Sic 4 1 2 1 Creating a New Case T Rietavecase bs d Clean Up Case 114 Si Be Display Edit Comments To begin you will copy the existing case Example 1A to a new case as follows PSNecer an 1 Right click on the Case Example 1A case in the Project Case Manager tree control The sub ii ae menu shown in Figure 145 will appear FIGURE 145 Save Case As on the Case sub 2 Select Save Case As from the sub menu The Copy Case Configurator dialog will appear 3 Change the name of the case from Copy of Example 1A to Example 1B as shown in Figure 146 116 5 10 BOA Version 4 User Manual v0 5 updates in progress Copy Case Configurator Copy Selected Case Example 1B To EE oa Examples Lab Klystron Gun ProjectE xample 1B Browse if Copy Meshes Iw Add New Case to Curent Project Case may only be added if it i placed in the curent project directory Cancel FIGURE 146 Copy Case dialog appear 7 Modify the comments as shown in Figure 147 Click OK to close the dialog 4 1 2 2 Saving a Case As you continue thr
149. he coil current highlighted are filled in by BOA The cur 166 5 10 BOA Version 4 User Manual v0 5 updates in progress rent must be specified Our solenoid consists of a single part and thus the dialog should be exited at this point by selecting OK The final section of Cylindrical Solenoid x the dialog is used to e select surfaces to ee Add More Parts serve as Dirichlet Coil Current EGER Amps to make the solenoid complete if it consists Coil IR 62 mm Coil OR em mm of multiple pieces Coil Length 2000 mm Coil COG ooo mm y 3 95014 mm z 737 0 mm ox 0 y za Cancel boundaries How ever when import ing the model we selected quasi infi nite boundary con ditions and thus no entries are required in this part of the dialog FIGURE 222 GUI for specifying the solenoid parameters Hit OK exit the dialog BOA Version 4 User Manual v0 5 updates in progress 5 10 167 The next step is to mesh the model Select Meshing Parameters from the menu and the dialog shown in Figure 223 will appear For this problem only the Local Mesh Refine ment and the Free Regions portions of the dialog will be used In Local Mesh Refinement BOA will have supplied the first entry Coil This provides enhanced meshing of the coil The return since it is rel atively thin should also be meshed in more detail than the default To do this push Add Part then select the return on the graphics
150. hes can be finer but never coarser than the initial mesh as specified on this dialog In addition to the meshing parameters this dialog provides the option to generate a log file when the mesh routine executes The Create Log File checkbox defaults to checked 1 e create log file The log file contains statistics associated with the meshing routine such as number of nodes number of meshes number of surfaces etc Typically there is no need to view the log file It is available primarily for diagnostic purposes To view the log file click the Display Log File but ton 3 9 1 1 Global Mesh Refinement The Global Mesh Refinement section allows you to control the global parameters used for the ini tial mesh generation It includes two types of refinements Mesh Size and Curvature based Refine ment Mesh Size When the Set Mesh Size checkbox is checked the Type and the Size controls next to it become enabled The Type dropdown box can be set to Relative Size or Abso lute Size With Absolute Size enter the actual physical mesh size in the units designated for the analysis E g if the geometry model has the unit of inches enter the absolute mesh BOA Version 4 User Manual v0 5 updates in progress 5 10 49 size in inches Relative Size is the mesh size relative to the largest edge of the box con taining the entity to be meshed The value must be greater than 0 and less than or equal to 1 O is not a valid s
151. his checkbox allows you to disable free regions for arun without having to delete them from the case Set the desired Mesh Size Define the cylindrical region by specifying Radius and the two endpoints First End Surface Center and Sec ond End Surface Center These endpoints can be entered in one of three ways e Direct entry allows you to enter the x y and z components of each point directly in the edit fields provided 2 Free Cylinder Meshing M Enable Name i Radius jo in Mesh Size jo in You may enter the cylinder end centers directly into the edit boxes or dick on the buttons below to select centers with the cursor Surface Select First End Surface Center Second End Surface Center 3D Select The 3D Select button enables you to locate endpoints anywhere within the bounding box of the model The Surface Select button will only allow you to locate endpoints on the surface of the model FIGURE 59 Free Cylinder Meshing dialog e Surface selection allows you to select two points anywhere on the surface of the model Click the Surface Select button and the main window containing the geometry model will become active Use the Ctrl Left mouse button to select the first and second end points Only points on surfaces can be selected A small dot will appear for each endpoint and the xyz coordinates will automatically appear in the fields provided on the Free Cylinder Meshing dialog e 3D select allows you to
152. i stage collectors e Support for symmetry in model simulation e Parallel processing TBD Revise Add more background context discussion of applications discussion of what advantages BOA has compared to competitors discussion overview of the optimizer etc 2 0 Installation BOA is available via download from www Calcreek com BOA is certified for operation in Win dows 2000 Windows XP Windows Vista and Windows 7 2 1 Minimum System Requirements e Operating System Windows 2000 XP Vista and Windows 7 e Memory Requirements gigabyte of RAM or greater Boa supports multicore CPU Architecture 2 2 Software Requirements for Optimization Runs The following software programs are required for running Optimization cases 4 5 10 BOA Version 4 User Manual v0 5 updates in progress e Microsoft Excel SolidWorks 3D CAD software 2 3 Website Installation Download BOA Beta Version To install BOA Beta Version go to www calcreek com and click on Products In the Software Products section click on Boa In the Download BOA Beta Version and User Manual section click on Download BOA Beta Version You will have the option to Open or Save the installer If you choose Open the installer will install BOA to your specified location or the default directory which is C Program Files Beam Optics Analyzer If you choose Save you will be prompted for the directory in which to save the installer Save the file to the desired direct
153. ial These parame SurfName O Swf olor iefet 7 ters become active when you check Shell Mesh Refinement th 5 f A f M h 5 h k Set Anisotropic Mesh Size Set Curvature Based Refinement e Set Anisotropic Mesh Size check Type Parameter Factor 1 3 box In order for the GUI to determine E Tangential n Relative Mesh Size Limit ooa the unit vector normal to the shell sur Tangential 0 1 ei cnr 0 001 faces you must specify one of the ee Lae uien ea aO 1ESNES SETIN enttes wim El mesm shell surfaces Click on the Sel Surface refinement may be refined but not coarsened under adaptivity button to bring up the main window containing the geometric model Move the cursor to the desired surface on the shell press Ctrl Left mouse button and Enter to select The Shell Mesh Refinement dialog will reappear Enter the desired Surface Name if editable and select a Color The Surface Name field will not be editable for any surface that already has a name in the CAD model You can also set the Curvature based refinement parameters same as discussed above To complete the assignment click OK The shell will appear as an entry in the table FIGURE 56 Shell Mesh Refinement To modify a local mesh refinement entry once it has been defined select it in the table and click the Modify button The appropriate dialog will reappear and you can edit the values To delete an entry from the table select it and click the De
154. ield set to voltage and extent clipping used to remove a portion of the adapted mesh The Clipping State section shown in Figure 78 ee et et es allows you to remove sections of the displayed results res mae i in order to view the internal structure When the Clip Gipping gt ping radio button is set to On the XYZ ranges x Com xMin xMax 0 3 Min x Max y Min y Max z Min z Max are used to a On Lt Li J determine which portion of the results to display The gt yMin 11 yMax 11 ra ranges initially default to the full range of the problem 4 1 8 0 78 eo space For reference these default values appear E zMin i8 zmax jos above each edit box this makes it easy to reset the y P values The units for all values shown in parentheses S T T R a 4 after the words Clipping state are the models units a ea Changes to the ranges do not take effect in the graph FIGURE 78 Clipping State section of the ics window until you click the Apply button or hit Electrostatic Display Parameters dialog Enter Figure 79 shows two examples of extent clipping In both the clipping range corresponds to the values shown in Figure 78 In the left hand figure the electric vector field is On and the scalar field is set to voltage with Show Contours checked In the right hand figure the scalar field is set to voltage with Show Contours unchecked and the mesh display is set to On 1 60e
155. in Figure 185 will appear Unlike Figure 185 initially Seem gh ea the Geometry Solid Model File data ee g entry box will be blank C xyz Semilnfinite C wy Semi lnfinite C pz Semi lnfinite C 2 Semilnfinite Click the Browse button next to the The name of the geometry file will appear in C Sem lnfinite C p Semilnfinite 2 5emi lnfinite Cy Finite C p Finite t 2 Finite Geometry Solid Model File entry box to locate the geometry file This will bring up a Browse window that Model Units in allows you to locate the desired geometry file Locate the file SAT If you installed o Cancel Load Model BOA using the default directory set tings this file will be located in C FIGURE 185 Geometry Model Parameters dialog Program Files CCR Beam Optics Analyzer Examples CAD Files Select the file and click Open or alternatively double click on the file The informational El boaGui message shown in e The selected geometry file is not in Your case directory C 1Boa Examples M50C ProjectiExample 241 Figure 186 will I Do you wank to copy the selected File to your case directory inform you that BoaGui will cre No ate a copy of the file and place it in FIGURE 186 Geometry File Copy Message the current Case directory Click Yes al boaGui the Geometry Solid Model File entry box as a verify the initial model shown In Figure 1 85 J The model is not a CCR SIM model with correct topolo
156. in window as shown in Figure 210 i MSDC Project boa Sie a Project MSOC Project 5 1 Case Example 24 A Bm EG Case Example 2B Magnetic Flux Density Analysis Type Elec Date Modified Jul L Comments 1D Axial Magnetic Flux Density Pars 10 Axial Magnetic Flux u me Axial Trans Tz 0 i Align g E theta E Tesla Largest m Field Parameters o Independent Aare bwo tnd motik 4 we First Point Second Point Num of Plot Points R Plot Parameters Open gt gt i Case Example 26 Tkeration 4 Eurrent 4 3416 i FIGURE 210 Plot of the 1D Axial Magnetic Flux Density 9 When you are satisfied that the external magnetic field is correct click OK on the D Axial Magnetic Flux Density Parameters dialog to close the plot The main window will return to the geometry model and the D Axial Magnetic Flux Density Parameters dialog will close 4 2 2 5 Defining the Secondary Emitters Next you will define the secondary emitters iL The Attribute Assignment Parameters dialog should still be open with the Beam Optics tab active In the Emitter Assignments section click the Secondary Emitter Add button beneath the table This will bring up the graphics display window containing the geometry model In order to specify the secondary emitter surfaces you will first need to slice the model to expose the interior of the collector Open the View menu and selec
157. ing pulldown menu and select Parameters BOA Version 4 User Manual v0 5 updates in progress 5 10 159 2 The Electrostatic Mesh Parameters Optional dialog will appear as shown in Figure 214 Notice that Local Mesh Refinements table contains four entries that you did not explicitly cre ate BoaGui automatically generated these entries one local mesh refinement for each of the secondary emitter surfaces that you defined in the previous section BOAGui auto generates these entries because is important to model secondary emitter surfaces more accurately Electrostatic Mesh Parameters Optional Siz led lf Create Log File l J Global Mesh Refinement Set Mesh Size Type fi Mhai Size i Set Curvature Based Refinement Parameter Factor Relative Mesh Size Limit 005 Local Mesh Refinement Finer grain control of meshing on selected model entities Local Mesh Tag Dim SizeTy Mesh Size Size On Cur Par Cure Min Size Curv On Color Stage 1 Face 5 9 2 0 1 0 3 0 001 pellow Stage 2 Face 44 45 z 0 1 D a 0 001 pelor Stage 3 Face 20 21 2 0 1 0 3 0 001 pellow Stage 3 Wall 23 24 4 1 0 1 0 a 0 00 yellow s l gt Add Surface s Add Part Add Shell Modify Delete Boundary Layer To speci Boundary Layer meshes extruded trom selected surfaces Side Number Layers Thickness Enable fan h m im i j imin i Je s omm me CA F j A m ee x i E a lan ii n a le s P
158. ing the model around in the graphics display window To spin the model around hold down the left mouse button and move the mouse around To zoom in hold down the right mouse button and move the mouse forward or up To zoom out hold down the right mouse button and move the mouse backward or down Note These directions assume BOA Version 4 User Manual v0 5 updates in progress 5 10 143 you are in the Trackball mode which is the default If you are in Joystick mode see Section 3 5 for details on mouse control You may also want to experiment with different settings on the View menu such as predefined Orientations and different options for Surface Representation Wireframe vs Surface and View Representation Orthogonal vs Perspective 2 To return to the orientation shown in Figure 129 click View gt Reset View 4 2 1 7 Assigning Electrostatic Attributes Now you are ready to Attribute Assignment Properties begin assigning attributes Etectostatics Beam Optics Optimizer Mise Properties at the Part Level 1 Click on the Attributes m Part Name Visible Color Voltage Yol Charge Rel Permittivity Material Name Inf Dom menu item The A No Vacuum No No Yacuum No Attribute Assignment yellow No Vacuum No green Vacuum No cyan No Vacuum No Properties dialog blue No Vacuum No shown in Figure 1 9 0 No magenta Vacuum Yes will appear with the Electrostatics t
159. ionic emitter click on the Thermionic Emitter Add button Thermionic Emitter Parameters Name beneath the emitter table This will r Color led v Enable bring up the main window contain ing the geometric model Find the ar t AAR desired surface and select it by press Number of Particle Launch Mesh Faces 50 approximate ing Ctrl Left mouse button Click Number of Particles per Launch Face 1 ie 1 Enter to complete the selection The Number of Thermal Energy Levels per Launch Site dialog shown in Figure 24 will Number of Thermal Angles per Launch Site i must be an odd number appear Total Number of Particles Trajectories 50 approximate Emitter Temperature 1050 C Find Work Function optional Enter the desired Name and select a Emiter Work Funcion 8 ev Tungsten 1 8 Color If the surface is already named in the geometry model the Include Temperature Correction Include Relativistic Correction Name will not be editable Use the Meshing Parameters Enable checkbox to enable or disable Grid Present the emitter for the simulation Dis Cathode to Anode Spacing 10 f inches abling an emitter allows you to tem Cathode to Grid Spacing 10 inches porarily turn off an emitter without Depth of Finer Mesh Region extended from Emitter 0 inches deleting it only in effect with adaptivity Enter the parameters in the Emission Cancel Properties box including Number of Particl
160. irectories contain geometry files ACIS or a Para Solid files parameter files BOA input files and all output files See Appendices on page 176 for details on all input files internal files and output files created by BOA TBD maybe add a section discussing overview of all inputs amp outputs or is that unnecessary 3 2 Screen Organization When you first execute BoaGui the title bar and menu bar appear at the top of the screen and the section below the bars is blank When you open a Project described in the next section the screen below the bars will divide into three section as shown in Figure 3 e The Main Window By default this region is used for the graphic display of the model It can also be used to display other information when desired 6 5 10 BOA Version 4 User Manual v0 5 updates in progress e The Project Case Manager tree control The upper right hand window always contains the Project Case Manager tree control e The Corner Window technically the lower right corner window however it is referred to elsewhere in boaGui as simply the Corner Window By default this region displays the Job Monitoring graph It can be used to display other information when desired Title bar Menu bar Project Case Manager BoaGul Jlab Kiystron Gun Project boa me Fle View Ansys Mode Attrbutes Meshing Exeote Vew Rents Took Heb Main Window defaults to graphic display of model Corner Window defaults
161. isplay Legend Horizontal Vertical Initial Mesh Clipping State in RARE 1 Display Mesh Clipping Off SHS betas ae off on On i 7 Li g Li 1 i E Show Mesh Outline 1 8 0 78 Min 1 8 Max 0 78 Mesh Info Hide this dialog temporarily Hide Exit FIGURE 138 Electrostatic Display Parameters dialog The sections below demonstrate a few examples of the different results BOA can display includ ing e 3D contour plot of the voltage field cut along zx plane Figure 139 e Scalar slice of the voltage field on the zx plane Figure 141 and e Line plot of the E magnitude along the beam axis Figure 143 Work through these examples to get a feel for how the how various dialogs work Then experi ment on your own to generate additional results if desired 4 1 1 11 1 3D contour plot of the voltage field sliced along the zx plane BOA Version 4 User Manual v0 5 updates in progress 5 10 111 Figure 139 shows a 3D contour of the voltage field sliced along the zx plane To generate this pic Dosatui Lab Kisiren Gun Profeci boa my ie Ve Anaha Hoda Atiibutes Mahig Dokte Ver Asus fois Help Potential V 80e 004 1 35e 004 8 92e 003 Foe FIGURE 139 Electrostatic results with Voltage Contours On and model and Voltage field cut along the zx plane executed with Max Number of Adaptivity Passes 0 ture perform the following steps l 112 The Electrostatic Display
162. issions When the Goal Function radio button is set to Minimize Surface Electric Field use the Select Surface button to choose the surface on which to minimize the electric field Only CAD named surfaces can be selected BoaGui will produce an error message if you do not select a named sur face Once selected the surface Name and Tag appear on the dialog The Clear button clears the current selection The Clear button is provided as a convenience only strictly speaking it is not actually necessary If another surface is selected surface via the Select Surface button the previ ous selection is automatically cleared Note that only one surface for field minimization can be selected at a time in the current BOA version 3 8 4 2 Optimization Method The current BOA version includes two iterative sampling methods for Optimization Method Nelder Mead is the default method It is very efficient and works well for smooth goal func tions If the goal function is noisy and Nelder Mead fails to converge use Implicit Filtering instead Both Nelder Mead and Implicit Filtering require many goal function evaluations In BOA Optimizer each function evaluation besides computing other internal variables runs SolidWorks once and then runs BOA until convergence 3 8 4 3 Execution Parameters The Execution section at the bottom of the dialog contains the execution parameters for the Opti mizer The parameters in thi
163. ity This appendix section documents the 1D Axial Imported Magnetic Flux Density Boa Magnetic Flux Density fef file and the CCR Imported Magnetic Flux Density bf file only 6 1 3 1 1D Axial Magnetic Flux Density File Format File Format BOA Version 4 User Manual v0 5 updates in progress 5 10 181 Z Min 0 0 Max 1 117 Number of Cells 1117 field separator must be a blank space in the header 0 0 0000334038 field separator is a blank space or a tab 0 001 0 0000327384 the first data field is the z coordinate 0 002 0 0000320659 the second data field is Bz in Tesla 1 117 0 0018822490 zmax 1 117 as in the header In this example there are 1118 data points thus 1117 cells or intervals They must be equally spaced in z coordinate Also the header has total of nine data fields 6 1 3 2 Boa Magnetic Flux Density fef file File Format This file is generated by Boa The file format is xL x0 yO z0 is the coordinates of the lowest corner dx dx dy dz is the cell size Nxyz Nx Ny Nz are the number of cells per dimension x0 yO z0 dx dy dz Nx Ny Nz field separator is a blank space Each line below contains all k varied vector values for a fixed index pair 1 with 0 lt k lt Nz B 0 0 0 B 0 O 1 B 0 O Nz G 0 j 0 field separator is a blank space B 0 1 0 B O 1 1 BLO 1 Nz G 0 j 1 B 0 Ny 0 BI 0 Ny 1 BI O Ny Nz G 0 j Ny B 1 0 0 B 1 0 1
164. ive Add FIGURE 206 Attribute Assignment Properties dialog BOA Version 4 User Manual v0 5 updates in progress 5 10 155 3 The dialog in 1D Axial Magnetic Flux Density Parameters Figure 207 will pop up 10 Axial Magnetic Flux een ees Field Scale Axial Trans Tz E in Align of CAD Model to Axis z Grid Unit m 4 Use the Browse but B_theta iq Tesla Largest Field Radius 5 4251 J in Hurm r Coord 0 ton next to the D Field Parameters Axial Magnetic Flux Pree Dero i Enable entry box to locate the solace external magnetic x 2a aR z 259825 field file named Second Paint Starting Point _Bz bf If you fr 3 cfs ff f 4 installed BOA using Num of Plot Points Toy Came Geese the default directory a s Plot Parameter Open Plot to Verify Field settings this file will tie i be located in C Pro Files CCR B FIGURE 207 1D Axial Magnetic Flux Density Parameters UPDATE num gram Pues eam r coord should not default to 0 Optics Analyzer Examples Data Files Select the file and click Open or alternatively double click on the file 5 The message shown in Figure 208 will give you the The selected 10 Axial Magnetic Flux Density File is not in your case directory option to create a copy of the Ci Boa Examples MSOC ProjectiExample 2B You can either leave it at its original location so that it can be automatically external magnetic field file in the
165. ize Note that a smaller mesh size translates into a denser mesh For structured meshes reducing the mesh size by half increases the mesh density by roughly a factor of 8 e 2 This rule of thumb is less accurate for more unstructured meshes If the Set Global Mesh Size checkbox is unchecked then the meshing routine defaults to a relative mesh size of 0 25 Curvature based Refinement Curvature based Refinement allows the mesh to be refined automatically to match the curvature of the entities in the geometric model Checking the Set Curvature based Refinement checkbox enables the two controls next to it The Parame ter Factor is the size relative to the element size More precisely in 2D it is the ratio of the segment height to the arc chord which is the element size The Relative Mesh Size Limit 1s the minimum relative mesh size due to curvature refinement on all model entities with curved surfaces 3 9 1 2 Local Mesh Refinement The Local Mesh Refinement section enables you to con trol the size of the mesh for specific entities in the geom etry model The table in this section is initially blank Use the buttons beneath the table to set up local mesh refinements for specific sur faces parts and shells A shell is defined as a thin part such as the grid shown in Figure 53 The mesh defini tion for a shell includes additional parameters that provide for better meshing of thin parts FIGURE 53 For meshing a gri
166. l cases in the Project You can use the tree control to manage the Project and Cases 3 3 1 Project Menu Right clicking on the Project name bring ups the menu shown in Figure 4 It contains the follow ing menu items Add New Case Creates a new Case within the eoo g current Project A dialog box will prompt you a amble Projec F to specify the Name of the Case the Analysis 5 case Sampecase1 MEMET 3 Case Sample Case 2 Import Pre Existing Case Pd Ty P e and any desir ed Commen 1S You will also Case Sample Case 3 Import All Cases From Directory have the option to open the case immediately ee RSENS s make it the current case Once the new Case is f grees AeA A ia a a A Ans Oe s T EN T i Se ee T e A a created it will automatically appear beneath the Project in the Project Case Manager tree con FIGURE 4 Project Case Manager shown with trol Behind the scenes a new Case folder will Project Menu opened be placed in the current Project folder The case folder will include all files specific to the case Import Pre Existing Case Allows you to import an existing Case into the current Project You will be prompted to browse the directories on your computer to locate the desired Case folder e If you specify a removed Case folder in the current Project the Case will be re imported into the Project A removed Case is one that exists in the Project folder but that has been remo
167. ld in model units e g in Remember you define the number of number of polar angles Num Theta s in the Planar Particle section as described above Both sets of statistics can be saved via the Save Stat File Save button at the bottom of the screen 3 11 3 6 Generate Terminal Particles This section of the Beam Optics Display Control Panel dialog is D Beam Optics Display Control Panel Partide Iteration Emitters and Trajectories used to save information on the a Partide Selection Type terminal particles to a separate file The file is generated based se aos on the user specified Particle Oo Seed sus F Stage 1 Face Iteration see dropdown box at ees 2 Face e Display Traj Planar Partides W Stage 3 Face the top of the dialog Note that Ear Sioa the Emissions and Trajectories Trajectories section has no effect on the ter Manan Particies minal particle results All emit f f Generate Terminal Partides Fie ters enabled on the Beam Opt ICS Generate Display Particles File Partides File Name 4Enpa out tab of the Attribute Assignment AEE NE j properties dialog are included ee ae eee cae F a P paana To generate the file click the FIGURE 114 Terminal Particles section of Beam Optics Display Generate button An informa Control Panel dialog tion message will pop up showing the exact location path and filename for the file The default name for the file is n Enpa out l where n correspo
168. le No Transformation Required and Transformation Required Select No Trans formation Required if the beam as defined in the file can be used exactly as is 1 e 1f the 1ni BOA Version 4 User Manual v0 5 updates in progress 5 10 2i tial particle positions in the file match the surface you designated as the injected emitter If the two planes do not match select Transformation Required and specify the Axis of Original Spent Beam The original injected plane will be transformed to the actual injected plane If the specified emitter surface is not a flat plane having a regular shape only the No Transfor mation Required option will be available The specified emitter surface must approximate the initial particle positions in the file e Magic 2D Format The Magic2D file format is for a Polar beam Number of Azimuthal Sec tions 1s the number of azimuthal coordinates that Boa uses to convert a Magic2D spent beam which is an axisymmetric beam to a 3D Cartesian beam Skipped Particles per Timestep 1s the number of particles to be skipped per time step when reading the Magic2D 3D spent beam data to reduce computation costs Enter 1 to use all particles Number of Skipped Timesteps 1s the number of time steps to be skipped when reading the Magic2D 3D spent beam data file to reduce computational costs Enter 1 to use all steps This format is available only if the specified emitter surface is a flat plane having a regular shape such a
169. le and shown on the Geometry Model Parame ters dialog If the box is left unchecked the part is assumed to have no volume charge density Relative Permittivity section The Relative Permittivity for a part can be entered directly or looked up in the Materials Properties database See Section 3 12 3 for a description of the Mate rials Properties database Typically it is looked up so by default the Value field is non editable 1 e the Edit directly checkbox next to it is unchecked and the Material dropdown box is used to find the Relative Permittivity The Edit Directly checkbox allows you to enter a Relative Permittivity Value directly Use this fea ture if you want to either e enter a value independent of the Material Properties database the material name will default to Noname when it appears in the Parts table or e edit the Relative Permittivity Value of a user provided material in the Material Properties data base You can also add materials to the Material Properties database by selecting Add Your Own Material in the Material drop down box This will bring up the Material Properties dialog dis cussed in Section 3 12 3 It can also be accessed via the Jools gt Material Properties menu 3 8 1 2 Properties at the Surface Level The Properties at the Surface Level section shown in Figure 20 1s used to assign voltages and surface densities to specific surfaces in the model Unlike Properties at the Part Level
170. lete button 3 9 1 3 Boundary Layers Boundary Layers are lay ers of semi structured meshes extruding froma prescribed surface see A B Figure 57 They are useful if high field fidelity is d desired in the neighbor of a particular surface To add a Boundary Layer A a Mesh click on the Add ye M button beneath the table a Y This will bring up main window containing the geometric model Find the surface from which the boundary layer should extrude and select it by pressing Ctrl Left mouse button Click Enter to select The dialog shown in Figure 58 will appear FIGURE 57 Boundary Layer Meshes extruding from an anode Here there are four layers of equal thickness meshes 52 5 10 BOA Version 4 User Manual v0 5 updates in progress Enter the desired Name if editable and select a Color Remember the Name field will not be editable for any surface Ta ja Add Surface that already has a name in the CAD model Make sure the Enable check box D Boundary Layer Mesh is checked This checkbox allows you to ide E disable boundary layer meshes for a run Number Of Layers 4 of equal thickness without having to delete them from the Total Layer Thickness a001 case Select the desired Side Vacuum i side Solid side or Both sides Set the Number of Layers and the Total Layer Thickness in the analysis units Each layer will be of equal thickness To add more FIGURE 58 Boundary Layer M
171. log via the Line Plot button 64 5 10 BOA Version 4 User Manual v0 5 updates in progress e 2D 3D Display The majority of the dialog is devoted to the controls for 2D and 3D display of the electrostatic results This section is discussed next 2 Electrostatic Display Parameters OD 1D Display Iteration Selection Data Point Line Plot Current Selection lo 2D and 3D Display Display for Electric Field Parameters V m Surfaces Calculated Min Max Displayed Min Max Min 3245300 Min 3345300 Bar ake Max 3046100 Vector Scale Factor ii 00 Display Vector Field E Mon Ay On Display Legend Horizontal Vertical Display Scalar Field Scalar Field Parame ters V ih of r Calculated Min Max Displayed Min Max x Min 18000 Min i8000 D Ey 18000 EF Max 0 Max o Emag re Number of Contours 10 E Pho I Show Contours Apply Scalar Slicing M Display Legend Horizontal Vertical Initial Mesh Clipping State in 4 Display Mesh Clipping Off il ir on T Qn i On Show Mesh Qutline Mesh Info _ Hide this dialog temporarily Hide Exit FIGURE 73 Electrostatic Display Parameters dialog 3 11 1 1 2D 3D Display The 2D 3D section of the Electrostatic Display Parameters dialog provides controls for configur ing the 2D and 3D display of the electrostatic results It contains the following controls BOA Version 4 User Manual
172. log is a Free Region With this feature the user can specify a cylinder with a specified mesh density This is often required to get an adequately smooth solution in a region which will have an electron beam In this case the cylinder is specified by select ing Add a free cylinder and filling in the dialog shown in Figure 225 The parameters for the cylinder were chosen so Part Local Mesh Refinement Name Tag a Color default V Set Mesh Size ate size fe Size is 8 mm Set Curvature Based Refinement Relative Mesh Size Limit Parameter Factor Meshes set in entities with local mesh refinement may be refined but not _o Cancel coarsened under adaptivity FIGURE 224 Part Local Mesh Refinement dialog that it encompassed the beam for the MBK The mesh can now be generated Mesh Generate Initial Mesh and viewed in the usual manner Next the problem should run using Execute Single Case The default values should be used As usual progress will be shown in a DOS window This prob lem took three min utes on a Xeon 3 GHz processor When the program has finished close the DOS window and select View Results Magnetostatics Free Cylinder Meshing IV Enable Name Beamline Mesh Size 10 mm Radius 40 mm You may enter the cylinder end centers directly into the edit boxes or click on the buttons below to select centers with the cursor Surface Select First En
173. lor by Full T Change Color FIGURE 16 Color Trajectories dialog Basic colors EE Bee E Be_eaeae E o se EF ee E ECB EEE EERE EE Custom colors IB BREE CEEE EEDU Define Custom Colors gt FIGURE 16 Color Palate dialog The Trajectories item opens the dialog shown in Figure 16 To change the color of the trajectories for a given Particle Generation select the Particle Genera tion and click the Change Color button The Color Palette dialog shown in Figure 16 will appear The Color by dropdown box allows you to further control the color of the trajectories as follows Full shows the selected single color for all trajecto ries Particle ID varies the color of each trajectory based on its Particle ID The Particle ID legend pops up at the bottom of the Main Window when this option is selected Particle Current varies the color of each trajectory based on its current The Particle Current legend pops up at the bottom of the Main Window when this option is selected Status Bar Shows and Hides the status bar at the bottom of the boaGui screen When the status bar is shown a check mark appears in front of the Status Bar menu item Zoom Feature BoaGui also includes a Zoom feature although it is not menu driven The right mouse button controls the Zoom feature To zoom in hold down the right mouse button and move the mouse forward or up To zoom out hold down the
174. ls that correspond to those in the Materials Properties database Select the desired material and the Relative Permeability Value will appear along with the Format in which it is entered Format There are three possibilities for the Relative Permeability s Format e Scalar This type implies that the relative permeability is constant and uniform That is itis a single number In the current version most of the BOA provided materials in the Material Properties database have scalar relative permeabilities e File This type implies that the relative permeability is provided in a two column data file containing the BH curve In the current version the BOA provided Material Properties database contains three materials whose Relative Permeability is provided in file format e Formula type this feature is not yet functional Future versions of BOA will allow BH curves to be entered via equations eg B 0 2 H40 2 Edit Directly checkbox The Edit Directly checkbox allows you to enter Relative Perme ability both Format and Value directly Use this feature if you want to either e enter values independent of the Material Properties database the material name will default to Noname when it appears in the Parts table or e edit the Relative Permeability of a user provided material in the Material Properties database You can also add materials to the Material Properties database by selecting Add Your Own
175. m Number of Function Evaluations Execution terminates exactly when the number of iterations exceeds the Maximum Number of Iterations Behind the scenes the number of function evaluations in Nelder Mead is several factors more In addition Scale Depth is not applicable 3 8 4 4 Optimized Parameters The Optimized Parameters section specifies the design parameters to be optimized e Magnetic Field Position and Scale For analyses that include a magnetic filed Analysis set to Electro Magnetostatic Beam or Electro Magneto Self Field Beam the top of the section specifies the initial minimum and maximum axial translations of the field axis of translation and the initial minimum and maximum field scales Unit Axial Trans of B Min Trans Max Trans Axis Init Scale of B Min Scale and Max Scale For analyses that do not include a mag netic field Analysis set to Electrostatic Electrostatic Beam or Electrostatic Self Field Beam no optimization on the magnetic field position and scale is available so these fields are not enabled as shown in Figure 49 e Geometry Parameters The optimized geometry parameters are specified via design tables that are originally generated by SolidWorks and then converted to Excel spreadsheets Ask Mike to provide how to detail here These design tables must be added in the Optimized Parameters section Each optimized geometry parameter is represented by a coordinate in the de
176. ment The surface s will appear as an entry in the table To add a part to the Local Mesh Refine ment table use the Add Part button The process for adding a part is nearly identical to the process for adding a surface as described above The dia log shown in Figure 55 includes the same parameters discussed above To add a shell to the Local Mesh Refinements table click on the Add Shell button This will bring up the main window containing the geometric model Move the cursor to the part you D Part Local Mesh Refinement f anode Color dfn dt me Set Mesh Size Name Type Relative Size SIZE O 1 Meshes set in entities with local mesh refinement may be refined but not coarsened under adaptivity ee Set Curvature Based Refinement 0 3 0 001 Parameter Factor Relative Mesh Size Limit o FIGURE 55 Part Local Mesh Refinement want defined as a shell and select it by pressing Ctrl Left mouse button Click Enter to complete the selection The dialog shown in Figure 56 will appear Enter the desired Shell Name if edit able The Shell Name field will not be editable for any part that already has a name in the CAD model BOA Version 4 User Manual v0 5 updates in progress 5 10 51 With shell mesh refinement you can specify the mesh size across the shell R meae i shel Name ZARA vell Tag 3 thickness Normal as well as along its ESE surfaces Tangent
177. mesh is displayed the menu item either Complete or On Entity will appear with a check mark in front of it Note that you will only be able to see the mesh on the outer boundaries of the problem domain 1 e on the outer boundaries of the background part To see the internal mesh structure use Extent Clipping described in the next section 3 9 2 3 Extent Clipping for Initial Mesh The Extent Clipping Initial Mesh menu item brings up the Bech Extent Clipping Mesh Extent Clipping dialog box shown in Figure 63 This fea Specify Bounding Box Parameters to Clip Mesh ture allows you to remove sections of the mesh in order to view XMin o XMax fe the internal structure When the Clipping State radio buttons 1s set _ to Off the graphics window displays the mesh on the outer oOo k E boundaries of the problem domain When the radio button is set 2min 2 to On the XYZ ranges in the Specify Bounding Box Parameters Sipping Seis to Clip Mesh section are used to determine which area of the On mesh to display Keep in mind that you can choose to include dis eal play of all or selected parts in the model geometry using the Visi Cancel _ ble checkbox on the Electrostatics tab of the Attribute Assignment window FIGURE 63 Mesh Extent Clipping dialog A sample display is shown in Figure 64 Here an initial mesh was generated for a Pierce electron gun Parts of the gun were turned off in the Attribute Assignment window to allow visu
178. mponents of the point directly into the edit fields provided on the Single Point Electrostatic Field Extractor dialog Point Location x y amp Z e Surface Selection Allows you to select the point anywhere on the surface of the model Click the Surface Select button and the main window containing the geometry model will become active Use the Ctrl Left mouse button to select the point Only points on surfaces can be selected A small dot will appear for the selected point and the xyz coordinates will automati cally appear in the fields provided on the Single Point Electrostatic Field Extractor dialog Point Location x y amp Z e 3D Selection Allows you to select the point anywhere within the bounding box of the prob lem space Click the 3D Select button and the main window containing the geometry model will become active A 3 plane widget will appear Use the Ctrl Left mouse button to move the planes to their desired positions To complete the selection click 3D Select on the Single Point q2 5 10 BOA Version 4 User Manual v0 5 updates in progress Electrostatic Field Extractor dialog The xyz coordinates of the point represented by the inter section of the three planes will automatically appear in the fields provided on the Single Point Electrostatic Field Extractor dialog Point Location x y amp Z Once you specify the desired W Single Point Electrostatic Field Extractor n mS field and the desired point You ma
179. n your current case directory and ready to use with the current Electro Magnetostatic Beam You can view results of this integrated case by switching the analysis type first to magnetostatics Do you want to use this integrated magnetic field FIGURE 28 A Magnetostatic analysis exists in current case and is ready to use complete your External Magnetic Field selection If a magnetostatic case exists in the current directory but is incomplete 1 e the case started as a Magnetostatic case but the case was never executed then setting the External Magnetic Field Options dropdown box to Boa Integrated Magnetic Case will bring up the informational mes sage shown in Figure 29 This message indicates that you must go back and complete the Magne tostatic analysis before continuing with the integrated case That is first change the Analysis type back to Magnetostatic mesh is needed and execute the case boaGui A magnetostatic analysis is already in your current case directory but not ready to use You can try to re activate it by changing the current analysis type Electro Magnetostatic Beam to Magnetostatics remesh if needed and Execute Ok FIGURE 29 A Magnetostatic analysis exists in current case but is not ready to use If there is no magnetostatic case in the current directory 1 e the case was simply started as an Electro Magnetostatic Beam or Electro Magneto Self Field Beam analysis then s
180. nce Mormal y Normal z Normal Slicing Side wrt slicing plane normal C Negative Side f Positive Side gt Viewing Parameters m Slicing Style M Show Axes of Model C Hollow Set Opacity of Slicing Plane 0 35 f Solid State C Off f On Close FIGURE 173 Slice Electrostatic Model dialog Choose Plane section select yz plane In the Slicing Side section select Positive Side Click 134 5 10 BOA Version 4 User Manual v0 5 updates in progress Close The image in Figure 174 will appear Notice that the mesh is much more refined around the thermionic emitter and in the areas you defined as Local Mesh Refinements 1 e Anode Tunnel FocusElectrodeSurface and ModTunnel FIGURE 174 Initial Electrostatic Mesh with Extent Clipping and Sliced Model 6 To turn off the Extent Clipping feature reopen the Mesh Extent Clipping dialog 1 e open the Meshing pulldown menu and select Extent Clipping Initial Mesh and turn the Clipping State radio button to Off 7 To hide the initial mesh open the Meshing pulldown The Display Initial Mesh gt Complete item is preceded by a check mark indicating that the initial mesh is displayed Click it to uncheck it and the mesh display will turn off 8 To show the complete model again open the View menu and select Slice Model On the Slice Electrostatic Model dialog set the State radio button to Off 9 Click Close to clos
181. nds to the Particle Iteration number Click OK and the file will be created To display the newly created file click the Display Particles File but ton The file will pop up in a separate window The file format is documented in the Appendix 1 The term Enpa stands for End Particle Attributes 94 5 10 BOA Version 4 User Manual v0 5 updates in progress 3 11 4 Viewing Run Log This View Run Log menu item brings up a separate window containing the log file as shown in Figure 115 Note that the Total Emit ted Current reported in the log file is the total current emitted by the cathode It is not the actual transmit ted beam current when analyzing an electron gun with grids Electrons leave the cathode some are turned back and some intercept the grids To obtain the actual beam current when grids are present use the Display Planar Particles feature E E Example 2B_E log win32pad Sn E Ll File Edit View Favorites Tools Help Oech Steele QeiMag BOA Version 4 1 x64 MeshSim version 7 6 Jan 1 2010 17 55 13 Initiating Simmetrix libraries Loading att file and the model Complete loading att file and the model ACIS model file will be used Boa expects the initial mesh to be generated previously elsewhere Number of Specified Noncoarsen Geometric Entities 8 Electrostatic Beam with External Magnetic Field Analysis Characterization of Emitter s Properties Completed Injected Beam Powe
182. netostatic Line Plotter dia log e g Starting Point x Starting Point y etc e 3D Selection Allows you to select two endpoints anywhere within the bounding box of the problem space Click the 3D Select button and the main window containing the geometry model will become active A line widget with two endpoints will appear Use the Ctrl Left mouse button to move the endpoints to their desired locations To complete the selection click 3D Select on the Magnetostatic Line Plotter dialog The xyz coordinates will automatically appear in the fields provided on the Magnetostatic Line Plotter dialog e g Starting Point x Starting Point y etc 80 5 10 BOA Version 4 User Manual v0 5 updates in progress Once you specify the desired field and the desired line click the Plot button The resulting line plot will appear in the main window as shown in Figure 98 In this case the line plot corresponds to the settings shown in Figure 97 Magnetic Flux Density 0 12 0 10 a 0 06 0 02 20 40 60 80 100 Point Numbers FIGURE 98 Magnetic Flux Density Line Plot The Plot Parameters Open button opens a hidden portion at the bottom of the Electrostatic Line Plotter dialog This section TBD discuss here and or reference back to the earlier Plot Parame ters section To exit the Magnetostatic Line Plotter dialog click the exit button and control will be returned to the Magnetostatic Display Parameters
183. o inches the velocity coordinates are assumed to be in inches sec I is the particle current is in Amperes Example of CCR Format 1 0 0 0 0 5 0 5 1 0e4 0 0 0 0 0 001 1 0 0 0 25 0 25 1 0e4 0 0 0 0 0 001 2 0 0 0 75 0 25 1 0e4 0 0 0 0 0 001 3 0 0 0 75 0 75 1 0e4 0 0 0 0 0 001 4 0 0 0 25 0 75 1 0e4 0 0 0 0 0 001 Format 2 A second CCR format has been added whose form is as follows comment line VelocityType explicit normalized relativistic LengthUnit 0 0254 unit conversion to meter this example indicates length unit is inch ZPlane 0 000 injecting plane if no velocity type is specified explicit type is assumed if no length unit is specified assume length unit is the same as model length unit q xx particle charge of xx is used instead of Ip if specified pID x y z vx vy vz Ip explicit OF pID x y z bx by bz Ip normalized or pID x y z gbx gby gbz Ip relativistic where z is not needed if zPlane is specified pID is the particle ID x y z is the particle position vx vy vz the particle velocity BOA Version 4 User Manual v0 5 updates in progress 5 10 179 Example of CCR Format 2 velocity is relativistic gama beta explicit LengthuUnit s normalized beta VelocityType relativistic Lengthunit 0 0254 inches 15 injecting particle coordinates ZPlane 4 083 injecting plane pID x y gbeta_x epee gbeta_z I 1 1 8054670E 04 6 5859 60E 04 3 3817550E 04 7 820037 0E
184. o of Contours 400 and Min value 1000000 BOA Version 4 User Manual v0 5 updates in progress 5 10 153 4 2 1 12 Viewing Electrostatic Results If desired you can also view the Electrostatic results as you did in Examples 1A and 1B Remem ber the first time you click on View Results gt Electrostatics you will be prompted to run the Elec trostatic postprocessor 4 2 1 13 Saving the Case Before closing the case make sure to save it Right click on the case name in the Project Case Tree Control and select Save Case 4 2 2 Example 2B Electro Magnetostatic Beam Analysis w Secondary Emissions This example extends Example 2A by adding an external magnetic field and adding secondary emissions 4 2 2 1 Creating a New Case To begin you will copy the previous Case Exam ple 2A to a new Case as follows 1 Right click on the Case Example 2A case in the Project Case Manager tree control The submenu shown in Figure 203 will appear 2 Select Save Case As from the sub menu The Copy Case Configurator dialog will appear 3 Change the name of the Case from Copy of Example 2A to Example 2B as shown in Figure 204 Copy Case Configurator Copy Selected Case Example 24 To CABoa Examples MSDC Project Example 2B Browse Copy Meshes I Add New Case to Current Project Case may only be added if it is placed In the current project directory Cancel FIGURE 204 Copy Case dialog
185. o button to cnet at On Because you Name Type Dim Tag Stage 1 Face default PowerDensity z 5 9 have not selected Stage 2 Face cyan PowerDensity 44 45 2 red PowerDensity z 20 21 2 any surfaces yet a Stage 3 Face 33 24 E on or Stage 3 wall red PowerDensity the Surface Selec tor dialog shown in Figure 199 will automatically pop Add Surfaces Modify Delete Cancel up 7 Click the Add Sur FIGURE 199 Surface Selector dialog face s button beneath the table This will bring up the graphics display window containing the geometry model BOA Version 4 User Manual v0 5 updates in progress 5 10 151 8 Rotate the model so that you can see the face sec tions of Stages 1 2 and 3 as shown in Figure 200 9 Select the Stage 1 Face by pressing the Ctrl Left mouse button The Stage 1 Face surface is a named surface in the CAD file consisting of tags 8 and 9 The Stage 1 Face will appear selected 1 e it will change from the default pink color to a dark green Press Enter and the Stage 1 Face will appear in the Selected Surfaces table 10 Next add the Stage 2 Face surface Again click the Add Surface s button FIGURE 200 Geometry model oriented to show Stage 1 2 and 3 Faces beneath the table on the Surface Selector dialog This will bring up the graphics display window containing the geome try model 11 Select the Stage 2 Face by pressing the Ctrl Left mouse button The Stage 2 Face surf
186. o exit the Single Point Mag netostatic Field Extractor dialog click the Exit button and control returns to the Magnetostatic Display Parameters dialog 3 11 3 Viewing Beam Analysis Results D single Point Magnetostatic Field Extractor Point Location You may enter the coordinates of a point directly into the edit boxes or dick on a button to use the cursor to select a point in the model The 30 Select button enables you to select a point anywhere within the bounding box of the model The Surface Select button will only allow you to select a point on the surface of the model 3D Select Surface Select Field to Inspect Field Value at Selected Point i Magnetic Flux Density B T C Magnetic Field H A m 4 2249e 007 Ee 466 1e 007 0 02006 0 02006 X Fa C Current Density J A m 2 y mag Close FIGURE 100 Results from Single Point Magnetostatic Field Extraction The Beam Analysis menu item will be active after completion of any analysis that includes beam optics This menu item brings up the beam optics results in the main window The Beam Optics Display Control Panel dialog automatically pops up on top as shown Figure 101 The initially r j BoaGui MSDC Project boa ois amp File View Analysis Model Attributes Meshing Execute View Results Tools Help Ed ISRC Hein Beam Optics Display COntol Pane Sem Particle Iteration Emitters and Trajectories Parti
187. o from my Excel table summary here e confirm bugs i reported were fixed Display Axes Shows and hides the X YZ axes along with coordinates enclosing the displayed 24 0 electrostatic part s When the display is On a check mark appears in front of the menu item Figure 14 shows an example of the axes displayed z 0 00576 with Axes Type Box Style as explained below Figure 12 shows an example of the axes displayed with Axes Type CAD Style 24 0 Axes Type BoaGui provides two options for the appearance of the axes CAD Style and Box Style CAD Style is the default Box Style shows a box enclosing the model and displays the axis coordinates The default Axes Type is CAD Style FIGURE 14 Example of Axes Displayed Figure 14 shows an example of the Axes Type set with Axis Type Box Style to Box Style Color Opens the submenu shown in Figure 15 The last item Trajectories will be active only if beam analysis results have been generated Selecting any of the first three items Background 16 5 10 BOA Version 4 User Manual v0 5 updates in progress Axes and Mesh results in the Color palette dialog shown in Figure 16 Use this dialog to set the desired color for the Background the Axes or the Mesh Gai td aS ehh t _ Display Axes Axes Type d Background w Status Bar Aes Mesh Trajectories FIGURE 15 Color Submenu D Color Trajectories t Farticle Generation Co
188. ocate the Injected Beam file Use the Enable checkbox to enable or disable the emitter for the simulation Dis abling an emitter allows you to tempo rarily turn off an emitter without deleting it Specify the file format using the radio buttons in the File Format for Planar Emitter section BOA supports four file formats e BOA format e Magic2D format e Magic3D format e Christine 3D format Injected Emitter Parameters Name Emitter Iv Enable Injected Emitter File Name CPI_injectedB m ibf Browse File Format for Planar Emitter BOA Format C No Transformation Required Transformation Required Axis of Original Spent Beam Magic2D Format Magic3D Format C Christine3D Format o C Number of Particles Verify Injecting Current Injecting Power kw Meshing Parameters Depth of Finer Mesh Region extended from Emitter only in effect with adaptivity fo in Cancel FIGURE 25 REPLACE new Tag filed Injected Emitter Parameters dialog The selections associated with each format are described below The file formats are defined in the Appendix BOA Format The BOA file format is for a DC Cartesian beam It contains the 3D particle positions and velocities at the original injected surface plane If the specified emitter surface is a flat plane having a regular shape such as a circular disk or a rectangular plate two options will be availab
189. og includes Restart ci Select Iteration Execution Priority Integration Order This parameter sets the order of the finite element Enter either 1 linear or 2 quadratic Qua dratic integration is more accurate however it can take 3 to 4 times longer to reach a solution The default value is L To restart a previous execution of Boa first check Enable then choose the particle iteration fram the drop IF You want the computer to spend less time executing boa Lowest r and more time on your other programs lower the execution priority level to Lower or Lowest FIGURE 67 Execute dialog Priority Level Cancel Max Number of Adaptivity Passes This parameter sets the maximum number of times BOA will call the adaptive meshing routines for mesh refinement Typically this value will be 2 or 3 however in some cases it may be advan tageous to set this to a lower value to reduce the turnaround time at the cost of accuracy This may be particularly applicable during the early stages of the design Setting the value to O will result in execution of BOA using only the initial mesh The default value is 0 Adaptivity Objective This parameter sets the accuracy objective for the adaptive meshing rou tines Provided the number of adaptivity passes does not exceed the Maximum Number of Adap tivity Passes the program will continue to invoke the mesh generation routines until the relative Energy Error Norm Es
190. oject JLab Klystron Gun Project Case Example 14 Case Example 1B 3 Case Example 1C gt Beam Optics Display Control Panel PartideTeration Emitters and Trajectories 9 T Emitters Display Power Densities emitter Off C On Display Traj Planar Particles C Off C Trajectories Planar Particles Generate Terminal Particles File Generate Particles File Name 9 Enpa out Planar Particles Choose Plane g yz 2x iC xy xyz x Normal Normal Distance 0 75 y Normal Opacity of Plane 0 35 z z Normal Generate Planar Particle Output Files Output File Beam Axis Direction Positive v Output File Papa ppo Output File and Plot Number of r Coords 19 Num theta Coords 4 7 Generate Plot Parameters Ee Jat ymax fa Hide this dialog temporarily Hide Close Iteration 9 Current 1 46736 FIGURE 178 Planar Particles 5 10 BOA Version 4 User Manual v0 5 updates in progress 9 Next generate a coordinated plot of the planar particles and create an output file Select the Output File and Plot radio button and click Generate The coordinated particle plot appears in the main window as shown in Figure 179 The detailed beam profile characteristics appear in the Plot Statistics section of the Beam Optics Display Control Panel dialog The particle output file named papa ppo is saved to the case directory BoaGui Jlab Klystron Gun Project boa Project Jlab Klys
191. oject Case Tree Control with Case opened 4 2 1 4 Saving a Case BOA Version 4 User Manual v0 5 updates in progress 5 10 F F anas ana po appear Initially the data entry FIGURE 182 The Project Case Tree Control shown with right fields will be empty click menu opened Specify the Case Name in the Tan E box provided In this example the Case Name is Example 2A New Case Name Example 24 000000 Select Electrostatic Beam in the Anal Analysis Type Electrostatic Beam z ysis Type dropdown box Beiak l If desired add Case Comments to Vee 24 Electrostatic Beam Analysis for MSDE Illustrates use of describe the case as shown in Figure 183 Leave the Open Case Now checkbox checked Click OK The new Case will appear A y beneath the Project in the Project Case 141 As you continue through this example it is a good idea to save your work occasionally To save a case right click on the Case name in the Project Case menu bar and select Save Case Alterna tively open the File pulldown menu and click Save Case 4 2 1 5 Specifying the Geometry File Next specify the geometry file on which to base the analysis The Boa installation Geometry Model Parameters Electro Magnetostatic Beam Geometry includes the geometry file you will need CAD Drawing to complete this example as discussed CAD below Geometry Solid Model File moca OOo 1 Click on the Model menu item and pee the dialog shown
192. oject Name in the box provided 4 Leave the User Material Library Location as 1s It is not used in this example This directory automatically defaults to your computer s home directory 140 5 10 BOA Version 4 User Manual v0 5 updates in progress 4 2 1 3 Creating a New Case l Select Add New Case The dia Click OK The new Project will appear in the Project Case Manager tree control on the right side of the BoaGui screen Behind the scenes a Project folder will be created in the specified location The project folder will contain the BOA Project file boa and all associated Case folders Right click on Project in the Project Case Manager tree con trol The popup menu shown in Figure 182 will appear add NEW ex E Import Pre Existing Case Import All Cases From Directory a log shown in Figure 183 will oe Manager tree control as shown in Figure 184 Behind the scenes a new Case folder will be placed in the cur rent Project folder The case folder will include all files specific to the case FIGURE 183 Add New Case dialog dase ple RTE Tupe Electrostatic Beam Date Modified May 18 2009 03 26 PM Comments User Manual Example 24 Electrostatic Beam Analysis For MSOC Illustrates use of an injected beam Hhh i nal ston on s A a T OT Te mes a a r N apek ean 5 a a a a es j panee T munai NTa h Te P 2 all a oi a wat To ia T Eyer a U m FIGURE 184 Pr
193. on set to Optics BOA Version 4 User Manual v0 5 updates in progress 5 10 47 Minimum Value and the Maximum Value Click OK and the geometry parameter will appear in the table in the Optimized Parameters section To modify an entry in the table select the desired row and click the Modify button To delete an entry select the desired row and click the Delete button 3 8 5 Misc Attributes The Temporary Thermionic Emitter Thickness Parameters internal CCR use only section is for internal CCR use during the Beta testing period 3 9 Meshing Menu gttboa _ Attributes Meshing Execute View Results Tools Help The Meshing pull down menu ee shown in Figure 51 controls generation of the initial mesh Generate Initial Mesh Display Initial Mesh Complete You must generate the initial Extent Clipping Initial Mesh On Entities mesh prior to executing BOA Initial Mesh Information Add Entities Keep in mind that if adaptive Abort Meshing meshing is used then the mesh will be adapted after the first iteration of BOA The sections below describe each of the FIGURE 51 Meshing pulldown menu menu items shown in Figure 51 3 9 1 Setting Mesh Parameters The Parameters menu item opens the Mesh Parameters dialog box shown in Figure 52 The pri mary purpose of the dialog is to provide user control over the generation of the initial mesh as follows 48 5 10 BOA Version 4 User Manual v0 5 updates in progress e Th
194. ory double click it and then follow the on screen instruction to proceed with the installation Obtain License File The BOA solver requires a license file To obtain a 30 day demo license please contact Thuc Bui at bui calcreek com with your name and address When the license file BoaLicense lic is received place it in C Program Files Beam Optics Ana lyzer license You will be asked for the serial number from the disk drive containing the exe cutable files This number can be obtained by opening a DOS window on the drive where the executables are stored and typing dir p The serial number consists of eight alpha numeric characters separated by a hyphen Download Latest BOA Patch To install the latest patch if one is available click on the Download BOA Latest Patch link to either Open or Save the patch The Download BOA Latest Patch link is located directly below the Download BOA Beta Version link on the webpage described in Step 1 above If you have chosen the default directory for BOA installation the patch will self extract to the proper location If not during the extraction you can browse to the bin folder under your BOA installation directory to unzip the patch 2 4 Executing BOA GUI If you chose to create a boaGui shortcut during installation on your desktop and or in the star tup menu click on the boaGui icon shown in Figure 1 to start the program BOA Version 4 User Manual v0 5 updates in progres
195. ostatic Display Parameters Im x OD 1D Display Data Point Line Plot Iteration Selection Current Selection jo v 2D and 3D Display Display for Electric Field Parameters Yim Surfaces Calculated Min Max Displayed Min Max Min 5030100 Min 3686700 e Max 5010700 Max 2980200 vector Scale Factor 0 1 Display Vector Field E C off Ay On MV DisplayLegend Horizontal vertical Display Scalar Field Scalar Field Parameters v C off re Calculated Min Max Displayed Min Max BES ie Min 18000 Min 18000 Ey pee Max 0 Max 9 C Emag Rg Number of Contours 49 Apply M Display Legend Horizontal vertical Scalar Slicing Adapted Mesh Display Mesh Clipping Off amp Clipping State in Show Mesh Outline Mesh Info Hide this dialog temporarily Hide FIGURE 149 Electrostatic results with Voltage Contours On Vector Field On executed with Max Number of Adaptivity Passes 2 UPDATE THIS PICTURE In my recheck with new version this picture looks different see below Confirm with Thuc that new picture is correct Eleciiec Field Yim p Fii i i Mike this is where I stopped my updates when I sent to you on 11 18 09 4 1 2 4 1 Viewing the Adapted Mesh Next look at the adapted mesh to see how it differs from the initial mesh BOA Version 4 User Manual v0 5 updates in progress 5 10 119 1 The Electrostatic Display Parame ters dialog should still be open
196. ostatic mesh during subsequent iterations The electron beam is simulated and the electric fields are updated based on space charge effects Self magnetic field from the beam electrons is not included e Electro Magneto Self Field Beam Performs an electrostatic simulation followed by a mag netostatic simulation The magnetostatic fields are interpolated to the electrostatic mesh during subsequent iterations The electron beam is simulated and the electric fields are updated based on space charge effects Self magnetic field from the beam electrons is included Heat Transfer A thermomechanical modeling module is planned for future versions This feature is not available in the initial beta release All Electrostatic analysis types include the option for a Single Case analysis or an Optimizer Analysis e Executing a Single Case means the user imports a single geometry specifies a single set of problem attributes meshes and then executes for that geometry and attribute set In contrast an Optimizer Analysis allows the user define goals for the optimal design then based on these goals Boa runs updates the geometry and other problem attributes re meshes and reruns until the goals are achieved Note Running the Optimizer requires both Excel and SolidWorks BOA will issue an error if the system does not meet these requirements 18 5 10 BOA Version 4 User Manual v0 5 updates in progress During an Optimization run the lower Co
197. ou to import a magnetic Se field from Maxwell2D in XY pegs I Enable coordinates This option brings First Point up the dialog box shown in Ns E faa 25a aes Ng 1 Second Faint Starting Foint Figure 34 O a a a ne Use the Browse button to locate ne Si E B as the desired Maxwell 2D file Flot Parameters Plot to Verify Field Ok Cancel Specify the Field Scale Transla tion Vector CAD Axes Al ig H FIGURE 34 Dialog for importing a Magnetic Flux Density File in ment of CAD Model to Z Axis and a Maxwell 2D XY coordinate format Grid Unit if appropriate See BOA Magnetic Flux Density fef file section above for definitions of these parameters 34 5 10 BOA Version 4 User Manual v0 5 updates in progress Use the Bz edit box to specify the uniform flux component 1 e the z component of the magnetic flux in Tesla Maxwell 2D RZ Imported Magnetic Flux Density Setting the External Magnetic Field Options dropdown box to the Maxwell 2D RZ Imported Magnetic Flux Density option Maxwell D RZ Parameters Maswell2D FZ File cae Field Scale i Axial Trans Tz 0 in Align of CAD Model to Axis E a Grid Lirit im T B_theta o O Tesla Largest Field Radius JE in Hum r Coord allows you to import a magnetic l Field Parameters field from Maxwell2D in RZ iS seer T Enable coordinates This option brings First Point up the dialog box shown in He 2 598 oot Ra Figure 35 Second Paint Starting Poin
198. ough this example it is a good idea to save your work occasionally To save a case right click on the Case name in the Project Case Manager tree control and select Save Case Alternatively open the File pulldown menu and click Save Case 4 1 2 3 Executing BOA with Adaptive meshing BOA Version 4 User Manual v0 5 updates in progress 5 10 rerun the initial mesh Window 4 Leave both checkboxes checked The initial mesh for this case 1s the same as in case Example 1A so there is no need to 5 Click OK The new case will appear in the Project Case Manager Tree control and the model will appear in the Main 6 To enter comments for case Example 1B right click on the new case Case Example 1B in the Project Case Manager tree control and select Display Edit Comments from the sub menu The Display Edit Comments dialog will Dis play Edit Comments User manual Example 1B Simple electrostatic analysis for the Jlab Elystron Gur With adaptive meshing Caneel FIGURE 147 Add New Case dialog 117 There is no need to run the initial mesh since it is identical to the initial mesh in case Example 1A and it has been copied into this case as dis cussed above l Open the Execute pulldown menu and select Single Case gt Execute The Execute Single Case dialog shown in Figure 148 will appear Set Max Number of Adaptivity Passes to 2 Leave all other parameters set to
199. pear in the fields provided on the Electrostatic Line Plotter dialog e g Starting Point x Starting Point y etc 3D Selection Allows you to select two endpoints anywhere within the bounding box of the problem space Click the 3D Select button and the main window containing the geometry model will become active A line widget with two endpoints will appear Use the Ctrl Left mouse button to move the endpoints to their desired locations To complete the selection click 3D Select on the Electrostatic Line Plotter dialog The xyz coordinates will automatically appear in the fields provided on the Electrostatic Line Plotter dialog e g Starting Point x Starting Point y etc Once you specify the desired field and the desired line click the Plot button The resulting line plot will appear in the main window as shown in Figure 83 In this case the line plot corresponds to the settings shown in Figure 82 Voltage A i a all 2000 i 6000 000 10000 12000 Scalar Potential V 14000 16000 18000 p pi HN 20 40 60 80 100 Point Numbers FIGURE 83 Voltage Line Plot BOA Version 4 User Manual v0 5 updates in progress 5 10 71 The Plot Parameters Open button opens a hidden portion at the bottom of the Electrostatic Line Plotter dialog This section TBD discuss here and or reference back to the earlier Plot Parame ters section To exit the Electrostatic Line Plotter di
200. played Min and Max values for the field The Displayed Min and Max values ini tially default to the Calculated Min and Max values The Calculated Min and Max values appear for reference this makes it easy to reset the values The Display Legend check box turns the legend on and off and the radio buttons labeled Horizontal and Vertical dic FIGURE 75 Display of Electric Vector Field tate the legend placement The Display Scalar Field radio buttons turn the display of the various scalar fields on and off Options include e Off does not display any scalar fields e Ex displays magnitude of the x component of the electric field e Ey displays magnitude of the y component of the electric field e Ez displays magnitude of the z component of the electric field 66 5 10 BOA Version 4 User Manual v0 5 updates in progress e Emag displays magnitude of the total electric field e V displays voltage e Rho displays charge density applies to electrostatic beam analyses only The Scalar Field Parameters section 1s active when the Display Scalar Field radio buttons are set to something other than Off The Show Contour checkbox controls the appearance of the scalar field contour plot If the checkbox is unchecked the scalar field appears as a standard continuous contour plot like the ones shown in Figure 76 The left hand figure shows the contour plot for the Potential V Potential
201. ptivity Objective oa i Beam Optics Parameters Humber of Allowable Iterations jo Adaptivity Every Iterations Mas Nun of Self Field Calc Self Field Relative Tol Output Solution and Source Fields Every Iterations Output Trajectory Data Every Iteration Performed after each converged beam calculation Min Hum of Iterations 4 Logging Options if Log to Screen W Log to File Example 24 E log Log File Marne Restart i Select Iteration Execution Priority To restart a previous execution of Boa first check Enable then choose the particle iteration from the drop IF You want the computer to spend less time executing boa and more time on your other programs lower the execution priority level to Lower or Lowest FIGURE 196 Execute Boa Priority Level Lowest Cancel For this example you will proceed directly to the Beam Analysis results to view the trajectories and the power densities on the interior surfaces of the collector BOA Version 4 User Manual v0 5 updates in progress 5 10 149 1 Open the View Results pulldown menu and select Beam Analysis The Beam Optics Display Control Panel dialog shown in Figure 197 will appear Beam Optics Display Control Panel Particle Iteration Emitters and Trajectories Particle Selection Type Genration 4 Ful No Display Power Densities f off H Emitter C On l Display Traj Planar Particles C off f Traje
202. r C Surfaces Parts Vector Field Type Magnetic Flux Density Current Density Vector a Magnetic Field Display Vector Field G Display Vector Field Comp c r pa R off C On of x Component y Component 7 Component Magnitude Scalar Slang Initial Mesh Display Mesh i Show Mesh Outline Off C On Mesh Info lect w D eng Component Parameters T Calculated FluxDensity Displayed FluxDensity Min 0 Min 0 Max 1 2505 Show Contours W Display Legend Horizontal F Vertical Clipping State mm 3500 3500 Cipping xMin o Max 350 C off 3500 3500 G On y Min 3500 y Max 3500 4400 5900 z Min 4400 z Max 5900 A _ Hide this dialog temporarily Hide Exit FIGURE 226 Magnetostatic display GUI uniform across the cross section as indicated by the uniform color 170 5 10 BOA Version 4 User Manual v0 5 updates in progress Various other components and field quantities can be plotted by selecting the vector field type and component FIGURE 227 Magnetic flux density as displayed with the controls set as in Figure 226 BOA Version 4 User Manual v0 5 updates in progress 5 10 171 The field also can be viewed on a plane using scalar slicing Turn the clipping off for this display to be most useful The dialog controlling the scalar slicing is shown in Figure 228 and the result ing display is shown in Figure 229 Scalar
203. r Job The sections below describe each of the menu items shown in Figure 66 shing Execute View Results Tools Help Single Case b Execute Generate Input Data Only Optimizer Abort Boa Job Monitor Parameters Monitor Job FIGURE 66 Execute pulldown menu 3 10 1 Executing a Single Case The Single Case menu item opens the sub menu shown in Figure 66 It includes e Execute Initiates the single case execution e Generate Input Data Only Generates only the input data set for the single case execution BOA can be executed using the command line provided that the required input parameters and files are provided This allows the user to make rapid or systematic changes to the input with out invoking the graphical user interface For advanced users this can result in a significant increase in efficiency The necessary command line arguments for executing BOA are pro vided in the Appendix The naming convention for the input data file is CaseName att where CaseName is the name of the current case The file will be placed in the Case directory e Abort Boa This item allows you to abort a simulation in progress This menu item is intended primarily for Beam Optics simulations Electrostatic and magnetostatic simulations run quickly so there is little need for an Abort function Prior to aborting an informational mes sage will report the last iteration available for post processing and
204. r Densities Trajectories Pla 84 5 10 BOA Version 4 User Manual v0 5 updates in progress nar Particles and Terminal Particles The contents of the dropdown box correspond to the saved iterations of the last run as defined by the parameter Output Solution and Source Fields Every N Iterations on the Execution Parameters dialogs The default iteration is the final iteration 3 11 3 3 Power Densities When the Display Power Densities radio button is set to On a blank version of the Surface Selector dialog will pop up automatically if no surfaces are selected yet This is shown below on the right side of Figure 104 In addition the following sections become active shown on the left side of Figure 104 e Power Densities e Initial or Adapted Mesh and e Clipping State The 3D power density display will appear in the main window Note that power densities are based on all emitters enabled in the case 1 e all emitters enabled on the Beam Optics tab of the Attribute Assignment properties dialog The Emitters and Trajectories table has no effect Beam Optics Display Control Panel o Sea partie Iteration Emitters and Trajectories Partide Selection Type Genration 4 bg E Fut No V Stage 1Face V Stage 2 Face Stage 3 Face v Stage 3 Wal ector Surface Selected Surfaces Generate Terminal Partides File Calaulated Displayed Display Legend Mn 1
205. r for Injected Emitter 6 is 69 287kW Loading External 1D Axial Imported Magnetic Field from the file MSDC_Bz bf Complete loading the external magnetic field The starting mesh is the initial mesh MSDC_E sms At iteration 6 The interpolation order of the solution field VoltageField is 1 Solving for the YoltageField There are O BL mesh regions Begin finite element analysis The mesh has 22455 regions 45168 faces 26862 edges and 4696 vertices Setting up linear matrix system PetscIterativeSolver numberOfElementsPerRow 6 STATIC SOLVER on formulation Electrostatic Analysis STATIC SOLVER 2344 eqs processor time to construct the LHS wo residual 6 616 seconds processor time to construct the LHS wo residual 6 616 seconds Elapsed processor time to construct the LHS wo residual 6 seconds processor time to construct the LHS wo residual 6 seconds processor time to construct the LHS wo residual 6 616 seconds Elapsed processor time to construct the LHS wo residual 6 seconds processor time to construct the LHS wo residual 6 141 seconds 1 Norm of LHS matrix 36 99 1 Norm of Source Vector 9 617e 666 At Petsc iteration 31 ResidualNorm 6 663655 1 Norm SolutionVector 3 639e 667 For PetscIterativeSolver Dumping residual history of cg with preconditioner sor to file cgSolver4U res OTATIA oop urn noe WIN INS Tab 8 Colk1Ln 1 FIGURE 115 Example of a Run Log accessed
206. re to save the case Right click on the case name in the Project Case Tree Control and select Save Case 6 Close the Case Right click on the case name in the Project Case Tree Control and select Close Case 122 5 10 BOA Version 4 User Manual v0 5 updates in progress 4 1 3 Example 1C Electrostatic Beam Analysis with Thermionic Emitter In this example you will extend Example 1A to create a beam optics analysis Adaptivity is not used in this example 4 1 3 1 Creating a new Case Project Jlab Klystron Gun Project To begin you will copy the first Case Example 1A to a new Case as follows Open Case Analysis p Date Mc Commer Case Exam Remove Case Clean Up Case Display Edit Comments 1 Right click on the Case Example 1A case in the Project Case Manager tree control The submenu shown in Figure 155 will appear 2 Select Save Case As from the sub menu The Nw Copy Case Configurator dialog will appear FIGURE 155 Save Case As on the Case sub menu 3 Change the name of the Case from Copy of Example 1A to Example 1C as shown in Figure 156 Copy icaveicontieurator vay 4 Uncheck the Copy Meshes checkbox You will generate a different initial mesh for this case Leave the other checkbox Copy Selected Case Example 14 To C Boa Examples 2 ilab Klpstron Gun Project Example 12 Browse checked Copy Meshes W Add New Case to Current Project 5 Click OK
207. right mouse button and move the mouse backward or down BOA Version 4 User Manual v0 5 updates in progress 5 10 17 3 6 Analysis Menu The Analysis pulldown menu shown in 02Gui Copied Exemples boal Figure 17 sets the analysis type for the cur rere ie Modei Amite Meshing Pera aaaea s rent case The selected analysis type appears Magnetostatic preceded by a check mark Each analysis RTEA k mE type requires different input parameters sie Electro Magneto Self Field Beam BoaGui enables and disables the appropriate Heat Transfer menus and execution parameters based on this selection Options include e Electrostatic Performs an electrostatic nalysis only analysis only FIGURE 17 Analysis pulldown menu e Magnetostatic Performs a magnetostatic analysis only e Electrostatic Beam Performs an electrostatic analysis followed by a beam simulation updating and refining the electric fields based on space charge effects Self magnetic field from the electron beam is not included in the simulation e Electrostatic Self Field Beam Performs an electrostatic analysis followed by a beam simu lation updating and refining the electric fields based on space charge effects Self magnetic field from the electron beam is included in the simulation e Electro Magnetostatic Beam Performs an electrostatic simulation followed by a magneto static simulation The magnetostatic fields are interpolated to the electr
208. rner Window will display the progress of the optimiza tion 3 7 Model Menu TBD This section needs some revisions add discussion of the multiple information messages that appear and explain initial vs final model I already added this to the examples but did not yet add here Also update section referenced below The Model menu item opens the Geometry Model Parameters dialog Geometry Model Parameters Electrostatic Beam Geometry box shown in Figure 18 It contains CAD Drawing two main sections one for specifying OoOo oo S O CAD Geometry and one for specifying Geometry Solid Model File Background The Model Units are ULAB Gun SAT Browse shown at the bottom of the dialog Background The exact title of the Geometry section varies with the selected Analysis Type For example in Figure 18 it is titled Electrostatic Beam Geometry because the Analysis Type for this particular us EE s analysis is set to Electrostatic Beam The Geometry section contains the fol lowing Model has built in symmetry C None Infinite C syz Semilnfinite C x y Semi lnfinite C pz Semi lnfinite C z2x Semi lntinite C y Semilnfinite f y Semilnfinite C2 Semi Infinite Model Urita in CAD Drawing This feature currently works for CAD drawings created in ok Cancel Load Model SolidWorks only e Optimization run The CAD Draw FIGURE 18 Geometry Model Parameters dialog ing is required for an Optimi
209. rocessor This will take some time Do you want to continue netostatics menu item following BOA exe ee cution BoaGui will display the Do not ask this question again informational message shown in Figure 86 No This message indicates that the Magneto static Field Postprocessor must be run in FIGURE 86 Postprocessor Informational Message order to generate the files necessary for dis play Click Yes and wait for the postprocessor to complete TBD waiting for case to complete this section BOA Version 4 User Manual v0 5 updates in progress 5 10 73 The default magnetostatic results will appear in the main window and the Magnetostatic Display Parameters dialog will automatically pop up on top as shown Figure 87 The displayed results 2 BoaGui Copied Examples boa f a Be File View Analysis Model Attributes Meshing Execute View Results Project Copied Examples Case Example 1A H Case Example 1B H Case Mag test 1 Magnetostatic Display Control Panel ii 0D 1D Display Iteration Selection Data Point Line Plot Current Selection 2D and 3D Display Field Parameters T Display for Calculated Flux Density Displayed Flux Density Surfaces Min 0 9157 Min 0 9157 Parts Max 0 91087 Max 0 91087 Vector Scale Factor pe Choose one Apply Magnetic Flux Density Current Density Vector V DisplayLegend Horizontal Vertical Component Parameters T
210. s FIGURE 217 Primaries and First amp Second Generation of Secondaries FIGURE 218 Primaries and First Second amp Third Generation of Secondaries BOA Version 4 User Manual v0 5 updates in progress 1B Remember when you click on View Results gt Electrostatics the first time you will be prompted to run the Electrostatic postprocessor 4 2 2 9 Saving the Case Before closing the case make sure to save it Right click on the case name in the Project Case Tree Control and select Save Case 4 3 Example 3 Solenoid for a Multibeam Klystron MBK 4 3 1 Example 3A Magnetostatic Analysis revise to match format of previous examples The geometry is a solenoid for a multibeam klystron MBK This klystron requires a uniform field from the gun through the RF circuit but a diverging field after the circuit to spread the beam into the collector The return has eight holes for the beam to pass through in the collector polepi BOA Version 4 User Manual v0 5 updates in progress 5 10 163 ece shown at the right There is one hole on center at the gun left end This is for access to the cathode The model is shown in Figure 219 FIGURE 219 Model for the MBK solenoid The coil is red and the iron return is violet The yellow object is the focus electrode for the electron gun This is not part of the magnetics problem and will be ignored by BOA It is included to show how parts from other relevant structures can be included
211. s BOA Version 4 User Manual v0 5 updates in progress 5 10 75 The Surface Part Display foie ee radio buttons control whether the results are shown for the whole geome try Parts or selected Sur faces Surfaces The radio buttons initially default to Part To view results for specific surfaces instead change the radio Add Surface s button to Surfaces The dialog shown in Figure 89 FIGURE 89 Surface Selector dialog will pop up Initially the table will be blank To specify a surface click the Add Surface radio button This will bring up the main window containing the geometric model Find the desired surface and select it by pressing Ctrl Left mouse button Click Enter to select TBD Integrate email response 3 19 10 resolve open issues also note that when the surface does not have a CAD name by convention it will be named in the GUI as SimFace_xx where xx is its tag Click OK to close the Surface Selector dia log Selected Surfaces Type MagneticFlux a The Vector Field Type radio butttons control the type of vector field displayed e Magnetic Flux Density e Current Density Vector or e Magnetic Field The Display Vector Field radio buttons turn the selected vector field on and off Figure 90 shows an example of Display Vector Field set to On for Vector Field Type Current Density Vector The Field Parameters section controls the appear anc
212. s or a 90 degree piece and 270 degree piece of a cylinder etc To define a part as an analytic cylindrical solenoid set the Select Current Vector Type Cylindrical Solenoid drop down box to Analytic Cylindrical ae eee Solenoid and click the Add Part s button Coil Current Amps Add More Parts next to it This will bring up the main win hed Asse ss Nia I E dow containing the geometric model 7 complete if needed Coil IR 7 optional Select the desired part by pressing Ctrl Left mouse button Click Enter to complete the Coil OR part selection The dialog box shown in Figure 45 will appear Enter the values for O E Cancel the Coil Current select the Coil Axis and set the Coil IR inner radius and the Coil FIGURE 45 Cylindrical Solenoid dialog OR outer radius If the chosen part represents the complete cylinder click OK to complete the definition If the cylindrical solenoid is composed of multiple pieces as described above use the Add More Parts button to select the other pieces to complete the cylinder Click OK to complete the definition The item will appear in the Current Density Attribute Assignment table Directional Current The Directional Current option enables you to specify a current with a uniform magnitude but directionally varying along a conductor This option requires an inlet face to which the incoming current is normal and an outlet face to which the outgoing current is also normal
213. s 5 10 FIGURE 1 BoaGui shortcut icon Alternatively doubleclick on the boaGui executable file in c Program Files Beam Optics Ana lyzer Figure 2 shows this file highlighted Fie Edit View Favorites Tools Help Gack BD search iP Folders Fi TOX Address a C Program Files Beam Optics Analysis bin File and Folder Tasks il Rename this file Gy Move this file A Copy this file Publish this file to the Web G E mail this file X Delete this file Other Places O Beam Optics Analysis 3 My Documents B Shared Documents o Bvkod mBo 8 vtkGraphics dll S vtkpng dil Si vtkfreetype dll S vtkDICOMParser dll S vtkexpat dl S vtk tiff dll a vtkFiltering dll vtkCommon dll S vtkzlb dil S vtkjpeg dll S disinc dl Eldistif_x Eldisgif_x S MFC7 1 dll SY msvcp7 1 dl S msvcr7 1 dll i My Computer J My Network Places Details FIGURE 2 Contents of c Program Files Beam Optics Analyzer directory Doubleclick on boaGui to execute the Boa Gui 3 0 Basic Operation 3 1 File Structure Boa uses a file structure that includes both Cases and Projects A Case consists of a single analysis and a Project is a logical grouping of Cases Typically users group all the simulations Cases associated with a single device into one Project The Project directory contains the boa project file with the file extension boa Case directories are located within the Project directory Case d
214. s Every el Iterations Output Trajectory Data Every fp Iterations Electrostatics without particles Performed after each converged beam calculation z Logging Options i Log to Screen MW Log to File Log File Name Example 14 E log Restart Enable Select beratior To restart a previous execution of Boa first check Enable then choose the particle iteration from the drop Execution Priority Sor TE vou want the computer to spend less time executing boa Priority Level Lowest and more time on your other programs lower the execution priority level to Lower or Lowest coca FIGURE 135 Execute Boa 4 A DOS window will appear indicating progress during BOA execution When BOA com pletes the following text will appear at the bottom of the window Proceed to View Results Press any key to continue Hit any key to close the DOS window and return control back to the user interface 4 1 1 11 Viewing Electrostatic Results without Adaptive Meshing After BOA completes you must run the post processor to view the Electrostatic results 1 Open the View Results pulldown menu Select Electrostatic An informational message will indicate that time is required Q Pete fiekidepey e generation of the Geotail to format the output for plotting as shown in shown in Figure 136 Click Yes and wait for the postprocessor to complete fe No boaGui Do not ask this question again
215. s Type Electro Magnetos Date Modified Feb 16 2010 10 3 Comments 0 00100 0 00597 0 0109 Particle Current Case Example 2B Iteration 4 Current 4 3416 FIGURE 106 Display Trajectories On Specifying Displayed Trajectories The specific trajectories displayed correspond to the settings in the Emissions and Trajectories section shown in Figure 107 This section includes the following controls e Emitters All enabled emitters in the case Po e xy appear in the table Emitters are turned on off Emitters and Trajectories for the purposes of display via the checkbox iia ros that precedes the emitter name At least one Ses v emitter must be checked at all times Emit faura aa ae D2 ters are defined and enabled for a case via the 5 Cia s Beam Optics tab of the Attribute Assignment e a na Properties dialog lt Generations The primary generation Oth artes File generation as well as any secondary genera es Fle Partides File Name 4Enpa out 1 i tions will appear in this section Generations are turned on off for the purposes of display via the checkbox that precedes the generation number At least one generation must be FIGURE 107 Emitters and Trajectories section checked at all times N C y Normal a Wa bE x b X Normak JE xyz Jo m M ee p PS 3 ait LO 2 i Ts eal x a T oe R aa mui e Particle Selection
216. s a circular disk or a rectangular plate The axis of the original spent beam e the spent beam defined in the file must be the z axis Thus the original injected plane will always be the r plane normal to the z axis and the direction of the beam is assumed to always point to the direction of the positive z axis The original injected plane will be transformed to the actual injected plane e Magic 3D Format The Magic3D file format is for a DC Cartesian beam As with the BOA format it contains the complete 3D particle attributes at the original injected surface If the specified emitter surface is a flat plane having a regular shape such as a circular disk or a rect angular plate two options will be available No Transformation Required and Transformation Required Select No Transformation Required if the beam as defined in the file can be used exactly as is 1 e if the initial particle positions in the file match the surface you designated as the injected emitter If the two planes do not match select Transformation Required and spec ify the Axis of Original Spent Beam The original injected plane will be transformed to the actual injected plane If the specified emitter surface is not a flat plane having a regular shape only the No Transfor mation Required option will be available The specified emitter surface must approximate the initial particle positions in the file Skipped Particles per Timestep is the number of particles to
217. s section vary slightly depending on the selected Optimization Method e Implicit Filtering method The Optimizer will terminate if the Maximum Number of Function Evaluations is exceeded This criterion is not hard set During the course of optimization if it is exceeded the optimization will not stop immediately but will proceed for many more itera tions before a complete stop In addition the objective of the optimization is to drive the Goal Function values toward zero which is unrealistic to achieve computationally to obtain the optimal design The Termination Tolerance tells the Optimizer an optimal configuration has been achieved if the goal function value is less than this tolerance The Maximum Execution Ars tells the Optimizer to stop if the total CPU time exceeds this value may not be functional yet but should be implemented soon The Restart Previous Optimization check tells the Opti mizer to start the optimization using the previous optimized parameters which would be updated and listed in the Optimized Parameters sub window The Scale Depth applicable for Implicit Filtering only is used to modify and scale the initial simplex when it encounters a stagnation to push the optimization forward 46 5 10 BOA Version 4 User Manual v0 5 updates in progress e Nelder Mead method The execution parameters are mostly the same as above However for Nelder Mead Maximum Number of Iterations is specified rather than Maximu
218. s tab Name The part name is identical to the name provided in the geometry file This property is not editable Color Specify a color for the part from the Color dropdown box Visible checkbox Check uncheck the box to show hide the part in the graphics display of the geometry model shown in the Main Window BoaGui will initially show all parts except for the background part as visible Opacity Opacity is the translucency of a part for the purposes of graphical display It ranges from 1 to 0 going from no transmission of light through the part opaque to full light transmission transparent A part s Opacity is editable only if it is set to Visible Notice that although by default the background part is set to invisible if you change it to visible then its Opacity defaults to 0 8 This default value allows you to see through it to the internal parts BOA Version 4 User Manual v0 5 updates in progress 5 10 21 Voltage Assigned to the Entire Part checkbox Check the box for any part that has potential and enter the voltage in Volts If the box is left unchecked the part is assumed to have no potential An unchecked box is not the same as a checked box with a voltage of zero Volume Charge Density Assigned Inside Part To assign a volume charge density inside of the part check the box and enter the volume charge density in Coloumbs per cubic length unit the length unit e g inch is defined in the geometry fi
219. s the Print Setup dialog box where you can select the printer and various print options File History Displays a history of the past four Project files opened This allows easy selection of previously loaded files Exit Closes BoaGui If the currently loaded Case has not been saved you will be given the option to save the Case or exit without saving Upon initiating BoaGui you must create or open a Project and then create or open a Case Most pulldown menus will be disabled until Project and Case are specified 3 5 View Menu BoaGui Project Jlab Klystron Gun Sample Project Gi File SVE Analysis Model Attributes Meshing Execute View E The View pulldown menu shown in Figure 8 con Onetan tains options that affect the display in the graphics region The menu items include Surface Representation view Representation d Refresh view Reset view Model Geometry Display Resolution Orientation Provides predefined orientations for Display Model Coordinates the graphics display including zx y zx y yz x yz x xy z xy z and Isometric The zx y orientation represents the zx plane with the y axis projecting out from the screen and so on w Display Model Slice Model Flot Parameters y Display Axes Axes Type Surface Representation Provides two types of visualization Wireframe and Surface Examples of both types are shown in Figure 9 Surface is the default vi
220. screen with the usual cntrl left mouse button Magnetostatic Mesh Parameters Optional W Create Log File Display Log File Global Mesh Refinement Set Mesh Size Type Relative Size Size ps Set Curvature Based Refinement Parameter Factor Relative Mesh Size Lirrut Local Mesh Refinement Finer grain control of meshing on selected model entities LocalMesh Tag Dim Size _Mesh Size _ CuvPar_ Curv Min Size Cury On Coil 2 3 1 0 1 1 0 2 0 001 1 Feturn 1 3 25 1 0 3 0 001 0 gt Add Sufacefs Add Part Add Shell Modify Delete Boundary Layer To specify Boundary Layer meshes extruded from selected surfaces Free Regions To specify free region meshes Free Cylinder BeamLine 1 0 202 5 300 0 202 5 1800 40 10 f Free Cylinder C Surface Constrained Cylinder 1 0 Add Modify Delete Cancel FIGURE 223 Mesh Parameters dialog Hit return to exit The dialog shown in Figure 224 will appear Make sure the Set Mesh Size box is checked Choose Absolute Size in the drop down menu for Type and enter 25 mm the thickness of the return for the value Uncheck the Set Curvature Based Refinement box and hit OK Changes to this or the coil s meshing can be made by selecting the appropriate part in the table and clicking on Modify 168 5 10 BOA Version 4 User Manual v0 5 updates in progress For this problem the only other entry in this dia
221. se 1 35e 004 CHD A Off 1 1 On On 1 1 Show Mesh Outline Sais 1 80e 004 Mesh Info Hide this dialog temporarily Hide Exit Case Example 1A Iteration Current FIGURE 142 Slice Electrostatic Model dialog 7 If desired experiment with other settings to see how the results change 8 When you are finished experimenting click Close and the cut plane will disappear 114 5 10 BOA Version 4 User Manual v0 5 updates in progress 9 To return to the complete model click on the View menu and select Slice Model On the result ing Slice Electrostatic Model dialog select the Off radio button in the State section Click Close to close the dialog 4 1 1 11 3 Line plot of the E magnitude along the beam axis i e z axis Figure 143 shows a line plot of the E magnitude along the z or beam axis To generate this pic ture perform the following steps aGui JLab Klystron Gun Project boa Project JLab Klystron Gun Project legend QQ Case Example 14 Em Analysis Type Electrostatic Electric Field Electrostatic Line Plotter x static anal You may enter line endpoint coordinates directly into the edit boxes or click on a button to the right to select endpoints 3D Select Surface Select A with the cursor The 3D Select button enables you to locate endpoints anywhere 1200000 _ 4 Field to Plot within the bounding box of
222. se Identical to menu item with the same name on the Case right click menu See pre vious section for details Use the tree control in the Project Case Manager to highlight the desired Case Remove Case Identical to menu item with the same name on the Case right click menu See previous section for details If a case is not open use the tree control in the Project Case Manager to highlight the desired Case Clean Up Case Identical to menu item with the same name on the Case right click menu See previous section for details If a case is not open use the tree control in the Project Case Manager to highlight the desired Case Display Edit Comments Identical to menu item with the same name on the Case right click menu See previous section for details If a case is not open use the tree control in the Project Case Manager to highlight the desired Case Close Case Identical to menu item with the same name on the Case right click menu See pre vious section for details BOA Version 4 User Manual v0 5 updates in progress 5 10 1 Save Case Identical to menu item with the same name on the Case right click menu See pre vious section for details Save Case As Identical to menu item with the same name on the Case right click menu See previous section for details If a case is not open use the tree control in the Project Case Manager to highlight the desired Case Print Setup Open
223. select two endpoints anywhere within the bounding box of the model Click the 3D Select button and the main window containing the geometry model will become active A line widget with two endpoints will appear Use the Ctrl Left mouse button to move the endpoints to their desired locations To complete the selection click 3D Select on the Free Cylinder Meshing dialog The xyz coordinates will automatically appear in the fields provided Click OK to complete the assignment The free region will appear as an entry in the table To add a Surface constrained Cylinder mesh select the Surface constrained Cylinder radio but ton and click the Add button This will bring up the main window containing the geometry model Find the surface on which to constrain the desired cylindrical region and select it by pressing Ctrl Left mouse button Click Enter to complete the selection The dialog shown in Figure 60 will appear 54 5 10 BOA Version 4 User Manual v0 5 updates in progress Enter the desired Name if editable Pere EE and select a Color Remember the Name field will not be editable for any surface that already has a name in the CAD model Make sure the Enable check box is checked This checkbox allows you to disable free regions for a run without having to delete them from the case Set the desired Mesh Size Define the cylindrical region by specifying its Radius and Length Specifying a positive length means the cylind
224. sign table The optimization routine initially sets the value in the design table to the nitial value then var ied it from the specified Minimum to the Maximum These reset design tables are then used by SolidWorks to update the geometry In other words these design tables are the interface between SolidWorks and the Optimizer To add a geometry parameter click Minimizetlecenchiela x the Add button next to the table One of the dialogs shown in Figure 50 will appear depending on selected Goal Function Use the Browse but ton to locate the Excel File design table Enter the Parameter Name Excel File Browse Parameter Name New Parameter Initial Value a Cell Col and Row e g B4 Minimum Value 0 Maximum Value 0 and the Cell location the column cmi number and row number in the E Excel spreadsheet e g B4 Note Bettis I that when the Goal Function is set to Excel File Browse Optics the dialog includes a drop Parameter Name New Parameter T down box with two commonly used parameters k2aspacing and kCur Initial Value o ae aS COl and Row e g B4 vatureRadius BoaGui will autofill Se _ the Parameter Name field when one cous of these parameters selected The FIGURE 50 Adding an Optimized Parameter top figure is for Goal Function set to Minimize Surface Electric Field bottom figure is for Goal functi
225. splay section at the top of Be e cardia deers estes pray l P hokis G ciek on Sartor FO the ight bc salee endnote sp select Surface Select the dialog The Electrostatic Line with the cursor Surface Select e e 7 The 3D Select button enables you to locate endpoints anywhere P l otter di alog will appear Field to Plot within the bounding box of the model The Surface Select button C voltage will only allow you to locate endpoints on the surface of the model 3 A Change the F e ld t O P l ot r adio but Starting Point Ending Point Number of Points to Plot ton to Electric Field E and leave the amp tiectric fiela E Bs x fo E 101 y Comp M ag checkbox checked C Electric Flux Density D z2 Comp H ol Shear Type C Linear V Mag z 1 7822 z 0 77645 Arc Length 4 Set the Starting Point and Ending point for both x and y to 0 Leave Ea C e the Starting Point and Ending Point FIGURE 144 Electrostatic Line Plotter for z at the default 5 Set the Abscissa Type radio button to Arc Length 6 Click Plot The line plot will appear in the main window as shown in Figure 143 7 If desired experiment with other settings to view different results 8 Click Exit to close the Electrostatic Line Plotter dialog 9 Click Exit to close the Electrostatic Display Parameters dialog 10 Before continuing on to Example 1B in the next section make sure to save the case Right click on the case name in t
226. sting of tags 44 and 45 The Stage 2 Face will appear selected it will change from cyan to a dark green Press Enter and the Assign Secondary Elec tron Emission Parameters dialog will reappear 11 Again change the Color to Yellow and leave all other parameters at their default values 12 Click OK to close the dialog The new secondary emitter will appear as the third entry in the Emitter Assignments table Figure 213 on the Assign Attributes Properties dialog 13 Repeat the above procedure two more times to define Stage 3 Face a named CAD surface consisting of tags 20 amp 21 and the Stage 3 Wall a named CAD surface consisting of tags 23 amp 24 as secondary emitters 14 After you have added all four secondary emitters the Emitter Assignments table should appear as shown in Figure 213 Note As discussed in the next section BoaGui will automatically generate Local Mesh Refinements for each of these surfaces It is important to model these surfaces with a higher degree of accuracy since they are now defined as secondary emitters 15 Click OK to close the Attribute Assignment Properties dialog 16 Thuc sometimes when I close the Attribute Assignment Properties dialog the geometry model appears a little odd See separate email message Generating the Initial Electrostatic Mesh check if still happening Once you complete the attribute assignments you are ready to generate the initial electrostatic mesh 1 Open the Mesh
227. t With Beam Current you specify the Beam Current and Beam Voltage The particle charge and its energy are then calculated from the beam current voltage and the beam geometry Thus each injecting particle charge varies on the injected emitter plane e Particle Charge With Particle Charge you specify Particle Charge and Particle Energy Each injecting particle has the same specified charge There are two options for Beam Shape e Circular With a Circular beam shape you specific Beam Radius Number of Particle Rings and Number of Particles Per Ring If you specify 5 rings and 32 particles per ring there will be a total of 160 injecting particles e Rectangle With a Rectangular beam shape you specify the Beam Height Beam Width Number of Vertical Particles along beam height and Number of Horizontal Particles along beam width If you specify 10 vertical and 6 horizontal there will be 60 injecting particles For the Beam Axis Type drop down box select the appropriate beam axis x y or z Note that the exact label for the Beam Height and Beam Width change according to the selected Beam Axis Type You can also specify the Azimuthal Particle Velocity rotation uniformly to all injecting particles and set the Injected Plane Coord the beam axis coordinate 3 12 2 Measuring Distance UPDATE THIS SECTION FOR 3D vs SURFACE SELECT FUNCTIONALITY Also do more bug
228. t x yo ie e M7 62g fp fo Eesecs Use the Browse button to locate Hum of Plot Points fei Se ie Ss F p the desired Maxwell 2D file The Plot Parameters pen gt gt ax Cancel remaining fields are defined as follows FIGURE 35 Dialog for importing a Magnetic Flux Density File in a Maxwell 2D RZ coordinate format The Field Scale is the scale factor for the imported mag netic field magnitude Set it to 1 to use the imported field as 1s The Axial Translation Tz is used to match the z coordinate of the origin of the imported flux to that of the corresponding axis of the CAD model the beam axis If the z axis of the geometry model is different from the z axis of the imported magnetic model a coordinate rotation is also required Use the Alignment of CAD Model to Z dropdown box to specify which coordinate axis of the CAD model x y or z to match to the z axis of the imported magnetic model B heta defines the 3rd uniform flux component theta component of the magnetic flux in Tesla The Largest Field Radius defines how far from the axis to compute B The Number of r Coordinates of the Field specities how many lines to compute BOA Version 4 User Manual v0 5 updates in progress 5 10 35 Pandira RZ Imported Mag netic Flux Density Setting the External Magnetic Field Options dropdown box to the Pandira RZ Imported Mag netic Flux Density option allows you to import a magnetic field from P
229. t Slice Model On the result ing Slice Electrostatic Model dialog select the zx plane in the Choose Plane section Click Close to close the Slice Electrostatic Model dialog BOA Version 4 User Manual v0 5 updates in progress 5 10 157 4 Rotate the model so that you can see the face sections of Stages 1 2 and 3 as shown in Figure 211 Select the Stage 1 Face by pressing the Ctrl Left mouse button The Stage 1 Face surface is a named surface in the CAD file consisting of tags 8 and 9 The Stage Face will appear selected 1 e it will change from the default pink color to a dark green Press Enter and the Assign Secondary Electron Emis sion Parameters dialog will appear shown in Figure 212 On the Assign Secondary Electron Emission Parameters dialog change the Color to Yellow and leave all other parameters at their default values Number of Second aries 3 Surface Material Copper and the secondary model set to Atomic Specification Click OK to close the dialog 8 The new secondary emitter will appear as the second entry in the Emitter Assignments table on the Assign Attributes Properties dia log as shown in Figure 213 Figure 213 shows the Emitter Assignments table with four second 158 FIGURE 211 Geometry model oriented to show Stage 1 2 and 3 Faces Assign Secondary Electron Emission Parameters Name Stage 1 Face Color red kd Number of Secondari
230. t to make it active Properties include Name The part name is identical to the name provided in the geometry file This property is not editable Color dropdown box Specify a color for the part Visible checkbox Check uncheck the box to show hide the part in the graphics display region BoaGui will initially set all parts to visible except for the background part BOA Version 4 User Manual v0 5 updates in progress 5 10 39 Opacity Opacity 1s the translucency of a part BoaGui uses it to draw the part in the graphics dis play window It ranges from to 0 going from no transmission of light through the part opaque to full light transmission transparent A part s Opacity is editable only if it is set to Visible Notice that although by default the background part is set to invisible if you change it to visible then its Opacity defaults to 0 8 This default value allows you to see the internal parts Relative Permeability section The Relative Permeability for a part can be entered directly or looked up in the Materials Properties database See Section 3 12 3 for a description of the Mate rials Properties database Typically it is looked up so by default the Format and Value fields are non editable 1 e the Edit directly checkbox between them is unchecked and the Material drop down box is used to find the Relative Permeability The fields in this section include Material This drop down box contains a list of materia
231. th adaptivity OF Cancel FIGURE 194 Injected Emitter Parameters dialog 8 Use the Browse button to locate the injected beam file _InjectedBeam ibf If you installed BOA using the default directory settings this file will be located in C Program Files CCR Beam Optics Analyzer Examples Data Files Select the file and click Open or alternatively double click on the file Note This beam profile was obtained from running a separate com puter code called MAGIC You can also create a beam profile using BoaGui s built in Cibo tool Tools gt Cibo BOA Version 4 User Manual v0 5 updates in progress 5 10 147 9 The informational message shown in WARNING the Injected Beam File is not in your case directory C Boa ExamplesiMSDC ProjectiExample 244 Figur e 195 will Do vou want the selected file copied to your case directory Esl boaGui inform you that BoaGui will cre Yes No ate a copy of the file and place it in FIGURE 195 Injected Beam File Copy Message the current Case directory Click Yes 10 Back on the Injected Emitter Parameters dialog leave the File Format for Planar Emitter radio button set to BOA Format with Transformation required and Axis of Original Spent Beam set to z 11 Click OK to complete the emitter definition and close the Injected Emitter Parameters dialog The newly defined emitter will appear in the Emitter Assignments table as shown in Figure 192
232. the BoaGui as shown in Figure 69 The convergence plot is automatically updated behind the scene as the beam simulation progresses BoaGui Project Jab Klysiron Gun Sample Project Case Sample Case 1 g ri Wew Anaya biod Attribute Meshing Execule view Rea Took Hep BOA Convergence tecta PaceTaxsh FIGURE 69 BOAGui shown with Job Monitoring On for a beam optics simulation 62 5 10 BOA Version 4 User Manual v0 5 updates in progress 3 11 View Results Menu k a Execute View Results Tools Help 2 Flectrostatics The View Results pulldown menu shown in Figure 70 provides access to all results includ Magnetostatics ing Electrostatics available for electrostatic ay ee analyses only Magnetostatics available for eum magnetostatic analyses only and Beam Analysis Geneiate Case Simmaly available for analyses that include beam optics The menu also enables you to view the execution log View Run Log generate a summary output file for the case Generate Case Summary and view the log file for optimization cases View FIGURE 70 View Results Pull down Menu Optimization Log View Optimizer Log 3 11 1 Viewing Electrostatic Results The Electrostatics menu item will be active after completion of an electrostatic analysis ah The first field display requires generation of the Electrostatic Field The first time you select this menu item fol i Postprocessor This will take some time Do you
233. the Sur face Property table 1s empty until you explicitly define properties to specific surfaces TBD Decide if this belongs here or in an earlier more general discussion about surfaces throughout the BOA GUI Each part in the geometry model consists of multiple surfaces These surfaces are defined when the CAD model is created Surfaces in the geometry model can be named in the CAD program that generates the geometry model If the geometry model contains names for the defined surfaces BoaGui will retain these names and will not allow you to edit the names If the geometry model contains surfaces that have not been named BoaGui will prompt you to name any surface for which you define properties These names will be editable 22 5 10 BOA Version 4 User Manual v0 5 updates in progress To assign a voltage to a surface click the Voltage Add button beneath the table This will bring up the Main Window containing the geometric model Select the Name oo ss sSOSSSSCS desired surface by pressing Ctrl Left mouse button Voltage Assignment and pressing Enter The Voltage Assignment dialog Color z box in Figure 21 will appear Enter the desired Name and Voltage and specify the Color If the surface is Voltage Assignedto Selected Faces mole already named in the geometry model the Name will not be editable Click OK to complete the assignment __Sencel_ and the item will appear in the table FIGURE 21 Surface Voltage
234. the named surface AnodeTunnel and it consists of surface tags 48 and 50 Because it is a named surface in the geometry file you only need to select one of the tags all tags associated with the named surface will automatically get included in the selection Click Enter to complete the selection 128 5 10 BOA Version 4 User Manual v0 5 updates in progress 5 The dialog in Figure 165 will appear The Surface Local Mesh Refinement Name entry box will not be editable It will be prepopulated with the name AnodeTunnel ge This is the name provided in the JUAB E Gun SAT file for this set of surface tags Set Set Mesh Size M Set Curvature Based Refinement the Color dropdown box to purple Check Type Relative Size Parameter Factor os both the Set Mesh Size and Set Curvature See for Relative Mesh Size Limit ono Based Refinement boxes Leave the remain Meshes in entities with local mesh ing entries at their default values Click OK to fnsment set may be refined but not ca complete the surface definition l FIGURE 165 Defining a Local Mesh 6 The newly defined surface will appear in the Refinement for the Surface Anode Tunnel Local Mesh Refinement section as shown in the first entry of the table in Figure 166 Local Mesh Refinement Finer grain control of meshing on selected model entities Local Mesh Mesh Si Siz Color Anode unnel 46 50 2 0 1 0 3 0 00 purple FocusEle
235. tic Mesh Parameters Optional aea W Create Log File Display Log File Global Mesh Refinement Set Mesh Size Type ate tte Size 5 Set Curvature Based Refinement Parameter Factor Relative Mesh Size Lirit 15 Local Mesh Refinement Finer grain control of meshing on selected model entities Local Mesh Hi Add Surfacels Add Fart Modify Delete Boundary Layer To specify Boundary Layer meshes extruded from selected surfaces Boundary Laver Side Number Layers Thickness Add Modif Delete Free Regions To specify free region meshes Free Cylinder Enable Facel Center Face Center Mesh Size f Free Cylinder C Face Constrained Cylinder Add Modify Delete 0 0 oneei FIGURE 162 Meshing Parameters Dialog Box 2 All tables in this section will be blank initially In this example the goal is to define the local mesh density 1 e Local Mesh Refinements for three different sets of surfaces These include the tunnel of the anode a portion of the focus electrode and the tunnel of the mod anode Defining a Local Mesh Refinement means that you specify the mesh for either a set of surfaces or for a part The initial mesh generation will create these meshes closely to your specifica tions Furthermore when adaptation is requested the adaptation routine may refine but never coarsen these meshes 3 Click the Add Surface s button beneath the table in the Local Mesh Refinement section
236. tic results This section is discussed next 4 Magi eto static Display Control Panel al al OB 1D Display Iteration Selection Data Point Line Plot Current Selection o gt 2D and 30 Display Display for i Surfaces Field Parameters nm Calculated Flux Density Displayed Flux Density Min 0 9157 Min 0 9157 ee Max 0 91087 Max 0 91087 f Parts Vector Scale Factor o Choose one Apply Magnetic Flux Density M Display Legend Horizontal Vertical Current Density Vector 5 Component Parameters T Display Vector Field Min Lle 038 wi 1 2478902772 On Max i 1e 038 Max 2 1402398 145 Display Vector Field Comp of Number of Contours 10 x Component W Show Contours Apply fy Component aE z Component Magnitude Calculated Flux Density Displayed Flux Density W DisplayLegend Horizontal Vertical Clipping State mm 3900 4900 Initial Mesh iaei e 3500 x Max 3500 Display Mesh Off 3500 3500 e off 0 On i On aldira 3500 y Ma 3500 4400 5300 Min A May 5900 I Show Mesh Outline 4400 ot Hide this dialog temporarily Hide Eyit FIGURE 88 Magnetostatic Display Parameters dialog UPDATE iteration selection gone amp MAGNETIC FIELD 3 11 2 1 2D 3D Display The 2D 3D section of the Magnetostatic Display Parameters dialog provides controls for config uring the 2D and 3D display of the magnetostatic results It contains the following control
237. tides Stage 3 Face C oF M Stage 3 Wall f Trajectories Planar Particles Generate Terminal Particles File mes Coys Come foxy ft yz x Normal lo 1S Normal Distance 0 08464 y Normal io Opacity of Plane 0 35 z Normal an hl Axis Dir Positive Numr s yp Num Theta s 4 7 Centroid by Primary Partides OutputFile papa ppo PE T 0 034645 Output File C Output File amp Plot Generate FIGURE 109 Planar Particles section of the Beam Optics Display Control Panel dialog yz the yz plane with normal in the x axis ZX the zx plane with normal in the y axis xy the xy plane with normal in the z axis xyz an arbitrary plane the three components of the vector normal to the plane are specified by the edit fields x Normal y Normal and z Normal The Normal Distance slider bar defines the distance of the plane along the normal vector The Opacity of Plane slider bar controls the opacity of the cut plane 90 5 10 BOA Version 4 User Manual v0 5 updates in progress The cut plane as defined here appears in the main window of the BoaGui with the particles pro jected onto it As you vary the above parameters you can see the cut plane change Yag a Gut MSOC Project boa lt Project MSDC Project a Case Lampie 24 MQ Case Example 28 Analysis Type Dectro Magnetostatx Beam Date Modified Feb 16 3010 1032 A
238. timate between the current iteration and the previous iteration is less than the Adaptivity Objective The Energy Error Norm Estimate is a global value describing the accuracy of the solution BOA computes this value internally based on the numerical solution It is not an input parameter See the Appendix for details The default value is 0 25 The Use Last Adapted Mesh as Initial Mesh checkbox allows you to start a simulation using the last adapted mesh This allows you to reduce the analysis time if you have already done an adap tive simulation with a good mesh and want to repeat the analysis with some minor changes such as small increase decrease in beam voltage different convergence criteria etc In such a scenario BOA Version 4 User Manual v0 5 updates in progress 5 10 59 you can just turn off adaptivity set Max Number of Adaptivity Passes 0 and start with an already good initial mesh 3 10 1 2 Beam Optics Parameters The Beam Optics Parameters section of the Execute BOA dialog is active when the Analysis type includes beam optics This section contains the following parameters Number of Allowable Iterations This parameter is the maximum number of iterations allowed in the BOA algorithm If the solution does not converge after the specified number of iterations BOA will stop the analysis and exit The default value is 10 Min Num of Iterations The minimum number of iterations performed in the BOA algorithm Adaptivi
239. tories defined trajectories onto user eran defined cross sections It includes 1 H Emitter e the ability to display the parti On Select Surface A Stage 1 Face Stage 2 Face cle Pro ections in 3D Display Traj Planar Partides M Stage 3 Face m or M Stage 3 Wall e the ability to generate more Se h f Trajectories detailed information on planar Ofna Paikea particle attributes You can save Generate Terminal Partides File this information to a separate Generate splay Particles File Partides File Name 4Enpa out output file view a 2D particle ower Densities W m 2 plot and view summary infor mation Terminal Particles This feature generates a separate file containing the terminal attributes of all parti cles 1L1e 038 li 1000000 L 1e 038 The subsequent sections describe how to use the Beam Optics Display Con trol Panel to produce results in each of these four areas Note that this is par ticularly complex feature rich dialog and that the various sections of the dia log change depending on which radio buttons are selected vie ols an 25 5 eee 2 5 2 6 3 11 3 2 Iteration Selection Hide this dialog temporarily Hide The Particle Iteration dropdown in the FIGURE 102 Beam Optics Display Control Panel dialog upper left corner of the Beam Optics Display Control Panel dialog specifies the iteration for which to display all beam optics results 1 e Powe
240. tron Gun Project ka Particle Position Particle Iteration Emitters and Trajectories 9 v Emitters Particle Generation Display Power Densities emitter 0 Display Traj Planar Particles t Off C Trajectories Planar Particles Generate Terminal Particles File Generate Particles File Name 9 Enpa out Particle Statistics The Particle Output File Papa ppo is Saved in the Case Directory Num Particles 304 Total Current 1 4683 A TotalKE 5172700 ey Total Current 1 468264 Total Kinetic Power 24 9668kW Beam Dia 0 20343in dr dz 9 4894e 005 d 2rfdz 2 538 85 Plot Parameters Return to Planar Particles Return Case Example 14 Iteration 9 Current 1 46826 FIGURE 179 Coordinated Plot of planar Particles 10 To return to the pre plot state of the Beam Optics Display Control Panel dialog click Return Experiment with other parameters and results as desired To close the Beam Optics Display Control Panel click Close If desired you can also view the Electrostatic results as you did in Examples 1A and 1B Before closing the case make sure to save it Right click on the case name in the Project Case Tree Control and select Save Case BOA Version 4 User Manual v0 5 updates in progress 5 10 139 4 2 Example 2 Multi stage Depressed Collector MSDC In this example BOA is used to perform both an Electrostatic Beam analysis and an Electro Magneto static Beam analysis on a multi staged
241. ttons to select the desired field Hoteni ene ye Plot Exit e Voltage a FIGURE 82 Electrostatic Line Plotter dialog e Charge Density applica ble for electrostatic beam analyses only e Electric field E Use the checkboxes to select x Comp y Comp z Comp or Mag the X component y component z component or total magnitude of E respectively Electric Flux Density D Use the checkboxes to select x Comp y Comp z Comp or Mag the x component y component z component or total magnitude of D respectively To specify the desired line for which to plot the selected field you must identify a Starting Point and an Ending point The dialog provides several options for identifying these two points e Direct entry Allows you to enter the x y and z components of each point directly in the edit fields provided on the Electrostatic Line Plotter dialog e g Starting Point x Starting Point y etc 70 5 10 BOA Version 4 User Manual v0 5 updates in progress e Surface Selection Allows you to select two points anywhere on the surface of the model Click the Surface Select button and the main window containing the geometry model will become active Use the Ctrl Left mouse button to select the first and second end points Only points on surfaces can be selected A small dot will appear for each endpoint and the xyz coor dinates will automatically ap
242. ty Only Radio Buttons These radio buttons control how often BOA calls the adaptivity routine It is enabled when Max Number of Adaptivity Passes gt 0 Options include performing adaptivity for e the first iteration only e the first three iterations or e after a user specified number of iterations Note that the first iteration does not include particles The self consistent method which BOA uses to push particles iterates on the electric field and emission current until their nor malized relative errors are less than Electric Field Convergence Criterion and Emission Current Convergence Criterion respectively both criteria are specified on the Beam Optics tab of the Attribute Assignment Properties dialog or until the number of iterations exceeds the Number of Allowable Iterations In the first iteration there are no particles yet thus the electrostatic field 1s solved without particles before any can be pushed Adaptive meshing is performed using the electric field Therefore if the first radio button is selected adaptivity for first iteration only no particles are involved Max Number of Self Field Calc and Self Field Relative Tol These parameters are enabled when the Analysis Type is either Electrostatic Self Field Beam or Electro Magneto Self Field Beam With the self field calculation the normalized relative energy norm of the self field of the previ ous Self field iteration to the present is compared with th
243. ty Passes is set to gt Q on the Execute BOA dialog The region is defined as a virtual column of user specified depth extending from the emitter surface The mesh within the column will be adaptively refined to approximately the same mesh size as on the emitter surface Click OK to complete the injected emitter definition The injected emitter will appear in the Emit ter Assignments table on the Beam Optics tab of the Attribute Assignment Properties dialog Secondary Emitters To add a secondary emitter click on the Rice a iors lise AEEA PATATE Secondary Emitter Add button beneath es the emitter table on the Beam Optics tab see Figure 23 This will bring up the graphics display window containing the see este geometric model Find the surface you ee arene want to define as a secondary emitter and select it by pressing Ctrl Left mouse but pah IE ton Click enter to complete the selection ee T he dia log box r hown T Figure 9 6 wi il 0 25 Secondary Yield Coefficient 23 Atomic Number A p p ear 63 546 Atomic Mass 9960 0 Material Density kg m 3 Color Number of Secondaries Copper Optional Select Yield or Atomic Specification Enter the desired Name and select a Ae Color If the surface is already named in Depth of Finer Mesh Regi eitendedtom T the geometry model the Name will not ee E be editable In the Number of Secondar ies field enter the number of scattered electrons caused by one incoming
244. u can change the color of the trajectories based on ID and current 3 11 3 5 Planar Particles BOA Version 4 User Manual v0 5 updates in progress 5 10 89 When the Display Traj Planar Particles radio button 1s set to Planar Particles a cut plane appears in the main window as shown in Figure 110 the Emissions and Trajectories section of the Beam Optics Display Control Panel dialog becomes active confirm only true if Mattie and thuc implement my suggestion and the Planar Particle section appears in the middle portion of the Beam Optics Dis play Control Panel and becomes active as shown in red in Figure 109 This sec tion contains input parameters needed to specify both the cut plane and to generate more detailed information about the pla nar particles Selecting Emissions The Emissions and Trajectories section specifies which emissions are included in the planar particle results See the Trajecto ries section above Section 3 11 3 4 for a complete explanation of this section Defining the Cut Plane In the Planar Particles section the Choose Plane radio buttons define the orientation for the cut plane Options include the three standard orthogonal planes and an arbitrary cut plane Beam Optics Display Control Panel Partide Iteration Emitters and Trajectories 4 z Partide Selection Type Display Power Densities fe Off On Select Surface v Stage 1 Face Stage 2 Face Display Traj Planar Par
245. u to locate endpoints on the surface of the model Fields to Plot Starting Point Ending Point Number of Points to Plot Magnetic Flux Density B xCom x fo xj 2s01 l y Comp Magnetic Field H l etme y 202 5 y 202 5 Abscissa Type li Current Density J V Mag z 300 z 2500 aia C ArcLength Plot Parameters Open gt gt _ Pot t FIGURE 230 Line Plotter dialog Legend Bm Magnetic Flux Density 0 020 0 015 0 010 paa EN E HHE E See ee e 1500 2000 2500 Point Numbers FIGURE 231 Magnetic flux density plotted along the line defined in Figure 230 174 5 10 BOA Version 4 User Manual v0 5 updates in progress TBD Add additional Example cases e Magnetostatic e Optimization case 5 0 Troubleshooting To report problems or bugs contact Thuc Bui bui calcreek com Is the Help gt Send Case to CCR menu item functional If so add a discussion here BOA Version 4 User Manual v0 5 updates in progress 5 10 175 6 0 Appendices This chapter contains the following Appendices e Appendix A Input Files e Appendix B Output Files Boa generated Files Intended for User e Appendix C Internal Files BOA generated Files for Internal Use Only 176 5 10 BOA Version 4 User Manual v0 5 updates in progress 6 1 Appendix A Input Files This appendix documents the input files required by BOA incl
246. uding e Geometry File required for all analyses Injected Beam File required in beam analyses if specifying an injected emitter e External Magnetic Field Files required in Electro Magnetostatic Beam and Electro Magneto Self Field Beam analyses e Excel Optimization File 6 1 1 Geometry File Each BOA analysis requires a geometry file The geometry file is specified on the Geometry Mod els Parameters dialog accessed via the Model gt Parameters menu item The file must be either an ACIS sat file or a ParaSolid x_t file It is important to be aware of the following restrictions and conventions Model Units The units used in the geometry model file dictate the units used in the BOA analysis You do not have the option to change units from within BOA Be sure to define the model units in the CAD package as you intend to use them in BOA TBD MAKE SURE THIS IS SAID in THE DIALOG SECTION TOO Part Names The geometry file contains parts representing the device being modeled When BOA imports the geometry file it uses the part names specified in that file Part names are not editable in BOA so make sure to name parts within the CAD program as you want them to appear in BOA Note to beta users The geometry file should not contain a Background part The newer version of BoaGui automatically creates a Background part when more than one non Background part exists in the CAD file Surface Names You are not required to n
247. utput File Browse Output File to be used Injection Specification Beam Current Beam shape Circular i by BOA for an injected Model Length Unit in E Injected Plane Coord E in emitter It enables you Beam Curent o Amp Beam Voltage E Volt to quickly and easily Beam Asis Type z Beam Asis Direction Positive a generate an injected V Beam Aadius 05 Ir beam profile in BOA format for a given set of Number Particle Rings Number Particles Per Ring i 0 parameters beam volt Azimuthal Farticle Velocity E rads age ment radius ae etc This can be useful eel for example to test a collector design with FIGURE 117 Cibo Configuration dialog out having detailed spent beam data from other RF codes The Cibo menu item brings up the Cibo Configurator dialog shown in Figure 117 The Cibo Out put Filename defaults to cibo ibf and the default location is the current Project directory Note that Cibo can be used with or without a case open in BoaGui If a case is open BoaGui will issue a warning if you set the Model Length Unit to something other than the length unit defined in the case If no case is opened no warning is given If a case is open with a specified geometry in the Model menu the model length unit is the specified model s Otherwise the default unit is meter 96 5 10 BOA Version 4 User Manual v0 5 updates in progress There are two options for Injection Specification e Beam Curren
248. utput Trajectory Data Every N Iterations described in the previous section 3 10 1 5 Execution Priority The Execution Priority section gives you some control over how much of your computer s resources are used when executing BOA If you want the computer to spend less time executing BOA and more time on your other programs change the Priority Level from Normal to Lower or Lowest 3 10 2 Executing an Optimizer Case The Optimizer menu item 7BD waiting for Optimizer example from M in order to see dialogs can t run without Solidworks 1 The Oth iteration of a beam simulation is the very first iteration with NULL space charge From the Ist iteration on space charge will be present due to particle motion BOA Version 4 User Manual v0 5 updates in progress 5 10 61 3 10 3 Monitoring a Beam Optics Run The two Job Monitoring menu items enable allow you to dynamically monitor ing Execute the convergence of a beam optics simula View Results Tools Help Single Case tion As shown in Figure 68 the Job Optimizer Monitor Parameters menu item allows ET A A a you to select the desired parameters for Monitor Job Boa Current Error plotting Current Current Error and or v Boa E Field Error Potential Error The Monitor Job menu item lets you toggle the monitoring on and off The convergence plot appears in FIGURE 68 Job Monitoring Parameters the lower right hand region of
249. v0 5 updates in progress 5 10 65 The Surface Part Display fe surraa Selecta radio buttons control whether the results are shown for the whole geome ST try Parts or selected Sur simFace_49 ElectricField faces Surfaces The radio buttons initially default to Parts To view results for specific surfaces instead change the radio button to Surfaces The dialog shown in Figure 74 will pop up Initially the table will be blank To spec ify a surface click the Add Surface radio button This will bring up the main window containing the geometric model Find the desired surface and select it by pressing Ctrl Left mouse button Click Enter to select TBD Integrate email response 3 19 10 resolve open issues also note that when the surface does not have a CAD name by convention it will be named in the GUI as SimFace_xx where xx is its tag Click OK to close the Surface Selector dialog Selected Surfaces Add Surface s FIGURE 74 Surface Selector dialog The Display Vector Field radio buttons turn the electric vector field display on and off Figure 75 shows an example of Display Vector Field set to On The Electric Field Parameters section con trols the appearance of the electric vector ionii field display This section is inactive if the Display Vector Field radio button is set to Off The parameter settings include the size of the vector arrows Vector Scale Factor and the Dis
250. ved from appearing in the Project Case Manager via the Remove Case menu item If you specify a Case folder in another Project the Case folder will be copied to the cur rent Project folder The case is not moved it is simply copied The original case remains located in the original Project folder The imported Case automatically appears beneath the Project in the Project Case Manager tree control Import All Cases From Directory Allows you to import all Cases from a Project into the cur rent Project You will be prompted to browse the directories on your computer to locate the desired Project folder If you specify the current Project folder all removed cases will be re imported into the Project If you specify another Project folder all Case folders in the Project including removed Cases will be copied to the current Project Cases are copied not moved The original cases remain located in the original Project folder 8 5 10 BOA Version 4 User Manual v0 5 updates in progress All imported Cases automatically appear beneath the Project in the Project Case Manager tree control 3 3 2 Case Menu Right clicking on one of the Cases brings up the menu shown in Figure 5 It contains the fol lowing menu items Projec k Jlab Klystron Gun Sample Project Case Samples seca Open Case Open Case Opens the selected Case Remove Case Clean Up Case Display Edit Comments Remove Case Removes
251. visible by unchecking the Visible checkbox for each 2 Rotate the model so that the emitter surface is clearly visible as shown in Figure 191 To center the visible model open the View menu and click FIGURE 191 Geometry rotated so that emitter surface is visible in yellow Refresh View BOA Version 4 User Manual v0 5 updates in progress 5 10 145 3 Click on the Beam Optics tab The dialog shown in Figure 192 will appear Unlike Figure 192 however both the Emitter Assignments table and the Optically Transparent Parts table will be blank Attribute Assignment Properties Electrostatics Beam Optics Optimizer Misc Beam Optic Parameters Emission Curent Convergence Criterion 9 905 Electric Field Convergence Criterion 0 005 Charge Neutralization Factor i Maximum Ho of Secondary Generations al Emitter Assignments ee eo aT ected E miter Thermionic Emitter Add Injected Emitter Add Secondary Emitter Add r External Magnetic Field Options Optically Transparent Parts Emitter yellow gt Optical Surface Assignments Inlet Hame Inlet Color Inlet Tag Outlet Name Outlet Color Penodic Add Reflective Add FIGURE 192 Attribute Assignment dialog box Beam Optics tab 4 Leave the Beam Optic Parameters set to the defaults 5 In the Emitter Assignments section click the Injected Emitter Add button beneath the table This will bring up the graphics display window containing
252. y x Comp x 3475 x 3475 101 Eae y Comp ESA you to create line plots for Magnetic Field H Boom as s Pee Type various fields Use the Field f Current Density J iv Mag 2 a7 z ie k E rc Lengi to Plot radio buttons to select the desired field Plot Parameters at Plot Exit e Magnetic Flux Density B f r a FIGURE 97 Magnetostatic Line Plotter dialog e Magnetic Field H e Current Density J Use the checkboxes to select x Comp y Comp z Comp or Mag the x component y com ponent z component or total magnitude of the selected field respectively To specify the desired line for which to plot the selected field you must identify a Starting Point and an Ending point The dialog provides several options for identifying these two points e Direct entry Allows you to enter the x y and z components of each point directly in the edit fields provided on the Magnetostatic Line Plotter dialog e g Starting Point x Starting Point y etc e Surface Selection Allows you to select two points anywhere on the surface of the model Click the Surface Select button and the main window containing the geometry model will become active Use the Ctrl Left mouse button to select the first and second end points Only points on surfaces can be selected A small dot will appear for each endpoint and the xyz coor dinates will automatically appear in the fields provided on the Mag
253. y but manipulation of the display thereafter rotation zoom pan is not signif icantly affected The default resolution is set to 0 5 NOTE For this parameter to take effect you must save and close the case and then reopen it Display Model Coordinates Dynamically displays the X Y Z coordinates of the mouse cursor as it moves through the graphics display region When this feature is on a check mark appears in front of the menu item and the three coordinates appear in the status bar Display Model Shows and hides the geometric model Hiding the model can sometimes be use ful when viewing results When the display is on a check mark appears in front of the menu item Slice Model This menu item allows you to create a slicing plane and remove the model on either side of the plane providing a view of the interior of the model This can be useful when assigning attributes or when viewing results for example when verifying that a beam is centered in a drift tunnel or to measure beam minimum position and diameter inside a part The menu item brings up the dialog box shown Slice Electrostatic Model in Figure 11 The Choose Plane radio buttons Choose Plane define the plane used to slice the model C yzplane x Center Choose one of the three standard orthogonal zxplane y Center cut planes xy xz or yz plane or an arbitrary Cena cener cut plane xyz plane For the arbitrary cut A plane specify the three components of t
254. y enter the coordinates of a point directly into the edit boxes click the Extract button The or dick on a button to use the cursor to select a point in the model r esulting value s will appear ui The 3D Select button enables you to select a point anywhere within in the appropri ate Fie d Va lu e the bounding box of the model The Surface Select button will only allow you to select a point on the surface of the model at Selected Point box es as f 3D Select Surface Select shown in Figure 85 Note that IES Sere when Field to Inspects set to Electric Field or Electric Field to Inspect Field Value at Selected Point Flux Density the Field Voltage v 6184 1 esi aie ad ee a includes values for the x y H ic Field H im a 0 i 0 and z components as well as Sees the total magnitude of the f Blectric Flux Density D Cim 2 He field e To exit the Single Point Elec trostatic Field Extractor dia FIGURE 85 Results from Single Point Electrostatic Field Extraction log click the Exit button and control returns to the Electrostatic Display Parameters dialog 3 11 2 Viewing Magnetostatic Results THIS SECTION IS INCOMPLETE Complete after I get new Magnetostatic example from MR The Magnetostatics menu item will be active after completion of a magnetostatic analysis The first time you select the Mag gi The first field display requires generation of the Magnetostatic Field q Postp
255. y model to a file named MainScreen jpg and puts it in your case directory Plot Parameters This Plot Control Pane eo menu item brings up the 3 a Plot Type Plot Display Location Plot Control Panel dialog Model a fen Window apy shown in Figure 13 Use this dialog to view various plots File Commands and specify where they Data File Plot Format iff T appear Graphic File C Wsers Walerie BOA November 2009 Examples Jlab Browse _ Save The Plot Type drop down r e z Plot Title Display Mode Display File Date and Time box contains the following a ai options x Axis Title y Axis Tite Display Data Error Message Abscissa Range Lower Limit Upper Limit e Convergence a line plot Abscissa Axis Type Linear Logarithmic Ordinate Axis Type Linear Logarithmic e Permeability a line plot Parameter Name Color Par ticle a scatter P l ot Grid Lines Per Label x Axis 2 y Axis 7 iw Display Grid e Electrostatic Line Plot a line plot FIGURE 13 Plot Control Panel dialog BOA Version 4 User Manual v0 5 updates in progress 5 10 15 e Magnetostatic Line plot a line plot e External Magnetic Field a line plot e Model the geometric model e Optimizer Convergence get more info e Error Estimates get more info e Newton Residual get more info This section currently under revision e More details to be added integrate or show all inf
256. zation run The drawing is updated with each consecutive optimization run and a new geometry file is imported into the case to meet the specified optimization goals This CAD drawing must be created in SolidWorks and SolidWorks is a system requirement for Optimization runs e Single case For a single case run this feature is provided for convenience only It allows you to access the SolidWorks CAD drawing used to create the geometry file without leaving BoaGui WARNING If you make a change to the CAD drawing in SolidWorks BOA will not automatically copy the modified geometry file into the Case directory Make sure to copy the modified file to the Case directory by re specifying it as described in the section below Use the Browse button to locate specify path for the desired CAD file Use the CAD button to access the specified CAD drawing in SolidWorks Geometry Solid Model File Used to specify the geometry file either an ACIS sat file or a Para Solid x_t file on which the analysis is based This file is always required BOA Version 4 User Manual v0 5 updates in progress 5 10 19 Note for the current beta release the ParaSolid x_t file format has not been fully tested due to the issue with model units always in meters Use the Browse button to Cil boaGui locate the desired file The selected geometry file is not in your case directory C Boa ExamplesiJlab Klystron Gun Project Example 141 When you select the file 2 Do

User Manual - calabazas creek research, inc.

Contents

Download Pdf Manuals

Related Search

Related Contents