Manual

USING BTR

See more at https://github.com/EDlougach/BTR/tree/master/BTR%204%20Manuals

BTR session

BTR working session typically includes optional steps as following:

1. Input / Import the NBI configuration;

2. Modify the Input parameters;

3. Choose the Beam geometry / optics;

4. Set the Environment (gas, fields);

5. Set the Beam Tracing Options;

6. Select the Surfaces for power scan;

7. Run the simulation;

8. View the results;

9. Store the results and the input data list to disk;

10. Read the results and input data list from disk.

Input / Import the NBI configuration

The procedures of NBI configuration Data Input and Import are discussed in Section BTR INPUT.

To read the NBI Configuration from external text file (BTR I/O format) choose Data → Read command from the Main Menu and set the path\name for the Config-file.

To import the NBI Configuration from PDP Input file choose Data → Import → NBI geom command from the Main Menu.

Modify the Input parameters

Input LIST of parameters can be modified through Data-editor (see Chapter “Input via Data-editor”) or by means of Pop-up Dialogs (see Chapter “Input via Pop-up Dialogs”).

Choose the Beam geometry / optics

To switch between SINGAP and MAMuG beam option:

- choose Options → Beam command from the main Menu;

- the Beam Dialog appears;

- select the needed option in Beam Source section of the dialog;

- if chosen option is SINGAP, press FILE button and set path/name for input beamlets file;

- choose Active Channels and Rows for beam simulation by left mouse button clicks on the ”beam emitters” (long rectangles at X = 0).

Set the Environment (gas, fields)

To set gas profile along X coordinate choose Edit → Gas profile command from the main Menu. You can set the data either directly or read it from file.

See par. “Gas Density profile” in Chapter ”Environment” for details.

Set the Beam Tracing Options

To set beam tracing options use the Beam Dialog (Options → Beam command on the main Menu).

Select the Surfaces for power scan

To select (or unselect) a surface manually:

- this is to be done before the start of beam tracing;

- pick up its “hot point” (small rectangle in its mass center) -> the marked surface turns red (marked);

- invoke the pop-up menu (by right mouse-button mouse click on the Configuration plot);

- choose Select/Unselect from the pop-up menu;

- repeat this operation for all interesting surfaces.

If you have not selected any number of surfaces before starting the beam, BTR offers to invoke the automatic selection procedure. If accepted it performs the dynamic selection of surfaces which accept non-zero amount of power during the beam tracing.

Run the simulation

To START beam tracing press the green button (GO) from the Toolbar or choose Go command from the pop-up menu (right mouse click on the Configuration plot). To STOP the calculation press the red cross button from the Toolbar or choose Stop command from the pop-up menu (right mouse click on the Configuration plot).

View the results

To see the Load Summary for an Active Surface (violet, with numeric label above the “hot point”) :

- pick up (mark) the surface by its “hot point”;

- the Load Summary for the marked surface is displayed in the Upper-Right view.

To display Multi-color / Contour Maps for the marked surface:

- invoke the pop-up menu (right mouse click on the Configuration plot);

- choose Multi-color Map or Contour Map;

- enjoy the picture on the Upper-Right view.

To show power density values (labels) on the Contour Map:

- left mouse click on the Contours Map;

- the PD value appears at the clicked point.

To display 3D-view of power deposition for the marked surface:

- right mouse click on the Map (Upper-Right view);

- the 3D-view appears in the lower-Right view.

To display power density profiles for the marked surface:

- left mouse click on the Multi-color Map (Upper-Right view);

- the profiles appears in the lower-Right view.

To see the total list of Active Surfaces:

- left mouse click on the Configuration plot (anywhere out of the “hot points” or “Beam Emitters”.

Store the results and the input data list to disk

To write the input data and the results to the disk:

- choose Results -> Save All from the Main Menu;

- new folder is created, and the output files are stored;

- the folder’s name is generated automatically, and BTR notifies you about the generated name (you can rename it whenever you want).

Read the results and input data list from disk

To read the I/O list and the results from disk:

- choose Results -> Read All from the Main Menu;

- File Dialog appears;

- Open the folder with the results, and open the file “Config.dat” in it;

- See the file preview and choose ACCEPT or REJECT.

Finite GG aperture radius (3.0)

This new option allows to set the initial thickness of a beamlet at GG and vary the beamlet cone angular width (similarly to Cut-Off ratio, but with source point shift). The following 2 input parameters are added to Green panel (section “Beam tracing”):

Beamlet Radius at GG, m

Beamlet Focus distance from GG, m

The negative beamlet focus value defines the divergent beamlet, positive – convergent. The infinity (abs(Focus) >100 m) results in parallel (cylindrical) beamlet with the preset radius. If any (or both) of the two parameters is zero, the beamlet is modeled in the usual way, i.e. emitted from an aperture center-point.

Combined power maps (3.0)

This GUI feature allows the user to plot several selected power maps on one image. Typically the selected maps should not overlap, but this fact is not checked by BTR. To perform the procedure, BTR chooses the “best” plane to show the projection of all the surfaces selected, and then outlines the surfaces limits and maps the power density onto the created plane. Note: the incident power density on the combi-plane corresponds to the original selected surface density, the angle of vision has no influence.

BTR messages to the author (3.0)

The procedure of bugs tracing becomes easier. If you encounter any problem, which can be connected with Input data modifications, you can send the automatic message to E.Dlougach directly from BTR, via the command Menu->File->Send->BTR Input. BTR will include the full Input List (Green panel content) to the message body.