How do I…?¶
The common jobs, each in the viewer, on the command line and in Python. Pick the tab
you use; the choice is remembered on every page. model.i stands for your MCNP input.
Cells, surfaces, materials and universes are always MCNP numbers, and lengths are in cm.
…find gaps and overlaps?¶
Open the Check workspace (Ctrl+2), then Problems on the left. Choose the region and run the check: it works in the background. Each problem found is a row, largest first; its arrow frames it, slices through it and selects its cells.
While you look around, the slice also lists the gaps and overlaps it runs into. Gaps are drawn black and overlaps magenta.
--h is the spacing of the lines traced through the model, in cm: smaller finds
thinner problems and takes longer (the time goes as 1/h²). The command exits with
status 1 when it finds a problem, so scripts can test it.
The check traces lines through the whole model, so it finds every gap or overlap that
a line crosses, however thin: a 1 mm gap is found whenever a line crosses it. Lines
are h apart, so a problem smaller than h in every direction can be missed.
…measure volumes and masses?¶
Explore workspace, Volumes panel: volumes by material, cell or universe, with their uncertainty and mass, sortable. Refine halves the line spacing; the table can be saved as CSV next to the input. A cell's page in the inspector also has Measure.
Each volume comes with sigma, one standard deviation: about 95 % of the time the
true volume is within 2 sigma.
…find which cell is at a point?¶
Double-click it, in the 3D view or the slice: the inspector shows the cell, its material and density, and the path through universes and lattices. Type three numbers in the search box at the top (Ctrl+K) to go to a point.
…see what a line crosses?¶
The Ruler tool (M): click two points, or click a face to go through the layers behind it. The Ruler window lists each cell crossed, with its material and length, and copies them as CSV.
…draw tally results over the geometry?¶
llevant reads FMESH results (meshtal files, and D1SUNED out=cuv files), MCTAL cell
tallies (F4, F6, F7, F8), and a CSV file of values per cell or material.
Drop the file on the window, or open the Results workspace (Ctrl+3), Fields panel, Open field…. Choose the tally and its bins; Style… sets the colour map, the scale and the legend.
llevant slice model.i --plane z=0.5 --field run.msht --tally 14 --log -o flux.png
llevant render model.i --field mctal --tally 4 -o f4.png
llevant slice model.i --plane z=0.5 --field heat.csv -o heat.png
A CSV file has a column cell (or material) and a column of values whose header
names them, with their unit:
More options (energy and time bins, scales, colour bars): Fields.
…compare two versions of a model?¶
When the input changes on disk, the viewer offers to reload it; after reloading, the cells that changed are selected and checked for gaps and overlaps.
It lists the cells and universes whose geometry or material changed, the new ones, the removed ones and those only renumbered. Exits with status 1 if they differ.
…look inside one universe on its own?¶
Right-click inside a filled cell, then Open u=N on its own. The universe opens in its own frame, cut to a box around its contents; ⬅ Back returns to the model.
Every command takes --universe:
…hide or isolate cells?¶
Click a cell to select it, then H to hide it, Shift+H to show only it, Alt+H to show everything again. The Find panel (or Ctrl+K) selects cells by a rule:
| Rule | Selects |
|---|---|
c 12 40-55 |
cells 12 and 40 to 55 |
m 5 |
cells of material 5 |
u 20040 |
cells of universe 20040 |
fill 20040 |
the cells universe 20040 fills |
in c 100 |
cell 100 and everything inside it |
$ shield |
cells whose $ comment contains "shield" |
u 20040 & m 5, m 5 \| m 6, ! void |
and, or, not |
…make an image for a report?¶
Set the view up, then in the File menu, Export the 3D view (PNG) or
Export the slice (PNG): the image is saved next to the input, with the colour
bar. The File menu can also copy the llevant render command that draws the same
3D view again, to put in a script.
--colour takes cell, material, universe or realistic (what materials look
like: steel, concrete, water…). To choose a material's look yourself, see
Realistic images.