4.15. Layers

The Layers tab allows the user to create customized views. The user has the possibility to change the fill color of the regions displaying regions, materials or even color encoding of biasing, cuts, thresholds etc. Moreover The user has the possibility to overlay a background image e.g a technical drawing, project USRBIN.gifUSRBIN data, BEAM parameters, lattices, voxels, transformations as well 3D representations using a raytracing technique. Or a combination of any of the above.

grab-geometry-layers1.gif

The buttons on the top allow the user to create, rename, clone or delete a layer.

Warning

There are 4 predefined system layers:
  • Boundary

  • Media

  • 3D

  • Lattice

where the user can only control the “Options”.

The “Global” checkbox when ticked makes the layer common to all projects. It saves the information in the flair.ini file rather in the flair project

The listbox on the top allows:

  • to access and modify the various options for each layer type

  • to turn ON/OFF the visibility of the layer type

  • Click on <add> or with the keyboard [Ins] to add a new layer

  • Right-Click to remove the layer or with the keyboard [Del]

Buttons:
ok.gif Apply

Perform the changes and redraws the viewports. Most of the actions are refreshed automatically.

reset.gif Reset

Reset current layer to the default parameters

info.gif Help

Show the documentation page

The following layer types are available:

Options:

allows the user to modify the global options for ALL viewports and layers

grab-geometry-layers2.gif
Title

Display the viewport title on the top-right corner

Coordinate System

Display the coordinate system on the bottom-left

Viewport lines

Display other viewports as dashed lines

Show Errors

Enable the error lines drawing. (As well the error message)

Orientation Cube

Set size of the orientation/navigation cube. Set to 0 to hide.

Grid

Display the grid

Grid Level

Opacity of the grid

Lattice Level

Opacity of the hashed lines when lattices are displayed

Crosshair

Display a cross hair in the center of the screen

Text Background

Opacity of the background color for all text on screen

Shortcut

Select a shortcut for faster accessing of the layer

General Font

Font to use for all text

Grid Font

Font to use for displaying grid values

Palette Font

Font to use for displaying palette values

4.15.1. Show Layer

Color & text information to be displayed on the 2D plot

grab-geometry-layers3.gif
Vertices

Display the intersection vertices of body boundaries

Labels

Choose type of labels to display, None, Region, Material or color Value

Color

Color to fill the regions. It can be any random for the Region, predefined for the Material and from a color palette (see colorband) for any numerical value

Region

random color

Material

predefined material color

Material-Decay

material for decay transport

Density

material density

USRBIN

USRBIN.gifUSRBIN by region

Importance

BIASING what(3) for all-particles

Importance-H

BIASING what(3) for hadrons

Importance-E

BIASING what(3) for emf particles

Importance-N

BIASING what(3) for neutrons

Splitting

BIASING what(2) for all-particles

Splitting-H

BIASING what(2) for hadrons

Splitting-E

BIASING what(2) for emf particles

Splitting-N

BIASING what(2) for neutrons

Corrfactor

CORRFACT what(2)

Corrfactor-dE/dx

CORRFACT what(1)

Corrfactor-rho

CORRFACT what(2) * MATERIAL.density

Deltaray

DELTARAY

e-Production

EMFCUT e production

e-Transport

EMFCUT e transport

g-Production

EMFCUT g production

g-Transport

EMFCUT g transport

Lattices

Control lattice display :Off: do not display lattices :Show: show lattices when display is idle :Prompt: show lattices promptly. Can slow down the refreshing of display

Voxel

Control voxels display :Off: do not display voxels :Show: show voxels when display is idle :Prompt: show voxels promptly. Can slow down the refreshing of display

Palette

Select palette to display color information like importances etc.

4.15.2. Image Layer

Display a background image e.g. a technical drawing of your object properly aligned with the geometry

grab-geometry-layers4.gif
Image

Click to select the image to display accepted formats png, gif, jpg, tif, bmp

Calibrate

Click to open the calibration dialog

Alpha

Select transparency/opacity level of the image plot on the back the standard material colors

Color Adjust

Interpolate the colors with the black-white range

Black

color to use for the #000000 value

White

color to use for the #ffffff value

Prompt draw

Normally the image drawing is done when the display is idle. Prompt will force to draw the image immediately however rendering the display a bit slow

grab-geometry-layers3b.gif

The calibration dialog needs at least 3 markers (the more the better) to find the transformation from the image coordinates to the geometry coordinates. Note: The markers should not fall all in the same line, otherwise the program cannot calculate the transformation matrix

Add

add a new marker any point in the image and enter the

Ctrl-Click

the geometry (x,y,z) corresponding to this point

Right-Click

on any point to insert a new marker, delete or edit the coordinates of the marker

Zoom In

or MouseWheel

Zoom Out

Info

To dump to the output window the calibration error

Ok

To close the window and accept the calibration

Cancel

To close and forget the calibration

Once the image is properly calibrated then it will appear as a background image in the viewport when the appropriate layer is selected.

Note

Please try to change the colors of your image in order to make it easier visible on the screen

../_images/grab-geometry-layers3c.gif

Final image on the viewport window

4.15.3. Userdump Layer

Reads the default USERDUMP file and draws the particle trajectories.

grab-geometry-layers5.gif
Userdump file

file to read

Start

Starting event

# Events

Number of events to plot

Listbox

Select particle types to draw as well their limits in energy and track color

4.15.4. Usrbin Layer

Display cuts of one or multiple USRBINs dynamically in the geometry. Up to 20 usrbin can be loaded and displayed at the same time. The layer index selects the parameters of the specific usrbin. For each displayed pixel, the first USRBIN.gifUSRBIN that includes the displayed location is drawn. Therefore select the finer mesh first and the coarser as last.

grab-geometry-layers6.gif
USRBIN from Inp

Check if you want to display a USRBIN card as a checker grid pattern.

Usrbin file

Load USRBIN file

Detector

Select detector to display from USRBIN file

Norm

Normalization constant to use

X-offset

Additional offset to apply to USRBIN

Y-offset

To get the offsets from Input select the

Z-offset

“USRBIN from Inp” select the USRBIN and then switch to file.

Rotdefi

Select a ROT-DEFI.gifROT-DEFI to be applied to the USRBIN

Transparency

Select transparency/opacity level of the usrbin plot on top the standard material colors

Prompt

Display promptly the usrbins. WARNING can slow down display

Palette

Palette to use for this usrbin

Note

The color scale is not automatically selected you have to define it using the Palette layer

grab-geometry-layers4b.gif

4.15.5. 3D Layer

Display 3D raytraced images behind the viewport. The usual cut will be visible and all transparent object will be filled with the ray-traced image behind.

grab-geometry-layers7.gif
Perspective

Select orthographic (default) or perspective projection

FOV

Field of View in degrees from 0 to 180. It is enabled only in the perspective/combo mode.

Def. Lights:

Use default (predefined) lights

Ambient Light

Amount of ambient light for dark regions

Antialias

Perform super sampling to enhance image WARNING Increases the rendering time.

Quality

Enable higher quality effects, like reflections, refractions etc… from objects WARNING Increases the rendering time.

Shadows

Enable if you want lights to cast shadows WARNING Increases the rendering time.

Ambient Occlusion

Enable calculation of ambient occlusion for softer shadows. The higher the value more samples are used WARNING Increases the rendering time.

Edge detection

Draw edges of regions as black lines. WARNING Increases the rendering time.

Black Holes

Select how to treat the rays when hitting a black hole material. - Stop the ray and treated as transparent. - Ignore only the first (external) black hole region. - Ignore and treat black holes as vacuum. WARNING Can lead to errors in display.

Show errors

Check if you want to display errors as red error lines. Note: if the [Show] layer is activated also errors on the displayed projection are also shown from that layer

Xray level

Set automatic transparency for each region it finds emulating an xray image

Clipped by

Set a clipping body to clip the 3D image

Negative clip

Use the negative of the body

Project body

Use this body as a projection surface for the USRBIN values. Useful if you want to display fluences in vacuum or in transparent objects.

Usrbin as texture
Use the USRBIN values as the surface

color texture on regions. If unselected USRBINS will be displayed only on the Projection body

grab-geometry-layers5b.gif

4.15.6. Palette Layer

Select the color band limits, gradient and palette. To be used in combination when showing numerical values, density, biasing, thresholds etc or USRBIN data. Up to 3 different palettes can be used. For example a gray-scale one for plotting densities and a color one for overlaying USRBIN.gifUSRBIN values.

grab-geometry-layers8.gif
Palette

Select the Palette type to use. There are several predefined palettes however the user can create its own.

Log

Logarithmic or linear scale

Invert

Reverse palette order

Transparent(<Min)

If selected do not paint anything for values smaller than the palette minimum If not selected all values<Min will be painted with the minimum color

Transparent(>Max)

If selected do not paint anything for values greater than the palette maximum. If not selected all values>Max will be painted with the maximum color

Minimum

Minimum value of the color band

Maximum

Maximum value of the color band

Colors

Number of colors to be interpolated

CPD
Colors per decade. Active when the “Log” option

is selected. When modified the Maximum value is calculated as a function from the minimum and the number of colors, to ensure correct rounding of colors per decade.

grab-geometry-layers6b.gif

A combination of the 3D, USRBIN and Colorband

4.15.7. Voxel Layer

Select and display ROI (Regions of Interest) embedded in the voxel file.

ROI Colors

Control the blending of ROI colors and displayed values

Listbox

Select ROIS to be displayed/filtered