← All labs

OpenMC 0.15.2 / LAB · RUNS ON ONE CPU

Particle transmission through an absorber.

Run real particle histories and compare transmission and uncertainty at two particle counts.

What this model means

A synthetic one-group pure absorber, infinite in the sideways directions; a normally incident beam; no scattering or evaluated nuclear data. This is not a real wall material.

T = exp(−ΣL), with Σ = 0.5 cm⁻¹ and L = 2 cm

Transmission near 0.367879, with a reported standard error. The run checks agreement within six standard errors and reduced uncertainty with 100 times more histories.

NO INSTALL NEEDED

Predict the answer, then check it

You do not need to run anything for this part. A calculator is enough.

  1. Find Σ and L above: Σ = 0.5 per cm and L = 2 cm.
  2. Calculate T = e−(Σ × L). Write down the number.
  3. Type your number below. Select Check.

SCENE OF RECORDDISPLAY ONLY · NEVER SOLVER INPUT

The run as one scene

The absorber slab of the OpenMC lab, with the neutron flux from a mesh tally of the same model. The slab is infinite sideways in the model; the 10 cm by 10 cm window is the tally region and the display extent.

ParaView still of neutron flux per source particle on the absorber slab (display extent of an infinite slab).

A still from ParaView. Load 3D to turn the scene and pick a field.

Take it with you

The .usdz opens with Quick Look on a Mac or iPhone, in Blender, in usdview and in NVIDIA Omniverse. The ParaView bundle holds the raw solver files and a script that opens them with the same colouring. The layer zip is the same scene as separate files.

Receipt

Scene run
OpenMC 0.15.2, Python 3.11.16, Linux-6.8.0-1064-azure-x86_64-with-glibc2.35. 1-group infinite lateral slab; monodirectional fixed source; pure absorption; same as the lab. Addition: one mesh tally: 40 slices along x, 10 cm x 10 cm window, score flux. Wall time 2.73 s.
Geometry
NVIDIA USD BRep 1.0.0 (exact solids and the display mesh). OpenUSD 0.26.8. Units: cm.
Result layers
ParaView 6.2, exported headless on the runner.
Made
2026-10-15T11:42:10Z, workflow run 38728950747 ↗.
Checks against the lab's verified receipt
Transmission, scene run vs the lab's verified receipt: 0.3678910 vs 0.3678910, the same to 1e-12; analytical 0.3678794.
Script hashes
scene run 360712c833a984eb…; the lab's script e0c7dcbadefec0e2… (unchanged).

Rules this scene keeps

  1. Geometry is for display, never solver input. The solver used its own description of the slab.
  2. The flux field comes from a real OpenMC 0.15.2 run of the same model as the lab, with one mesh tally added. Its receipt is in this scene.
  3. Every number here has a source file and a hash in manifest.json.
  4. Nothing here predicts a real fusion chamber.

Run the lab

You need

  • A computer with Linux x86-64, Windows with WSL2 Ubuntu, or a Mac (Intel packages; an Apple-silicon Mac needs Rosetta 2). Native Windows is not tested.
  • Conda. Conda installation guide ↗. On Windows, install WSL2 Ubuntu ↗ first, then install Conda inside Ubuntu.
  • An internet connection. Installation takes 5 to 15 minutes. The run itself takes a few seconds.

Words used below. A terminal is the window where you type commands. An environment is a separate set of programs installed only for this lab. The receipt is the file results/receipt.json that the lab writes when it finishes.

  1. 1. Download and extract the lab

    Download OpenMC 0.15.2 lab (.zip) ↓

    Extract the ZIP in your Linux home folder. On Windows, the folder must be inside Ubuntu, not on the Windows desktop.

    Open a terminal in the extracted folder. Read README.md before you change anything.

  2. 2. Create the environment

    Type the first command for your computer. Press Enter. Wait until the prompt returns. This takes 5 to 15 minutes.

    On Linux or WSL2:

    conda create -n vtb-openmc --file explicit-linux-64.txt

    On a Mac (Intel packages; an Apple-silicon Mac needs Rosetta 2):

    conda create -n vtb-openmc --file explicit-osx-64.txt

    Type the second command. Press Enter. The prompt now starts with (vtb-openmc).

    conda activate vtb-openmc
  3. 3. Run the lab

    Before you run: write down the answer you expect from the equation above.

    Type the command below. Press Enter.

    OMP_NUM_THREADS=1 OPENBLAS_NUM_THREADS=1 python run.py

    Read the last line in the terminal. It must contain VTB_RECEIPT and status: passed.

    If it does not: stop. Copy the error message. Compare your installed packages (conda list) with the explicit file you used. Do not change the seed.

  4. 4. Read the receipt and keep it

    Open results/receipt.json. Compare the numbers with the equation above.

    Compare the random error for 10,000 and 1,000,000 particles. The second is about ten times smaller. Read each mean together with its error.

    Keep the receipt, the lock file and any change you made together. A new run replaces the files in results/, so copy the folder first if you want to keep an earlier run.

  5. 5. Change one thing

    Open run.py in a text editor. Find sigma, length, source_x = 0.5, 2.0, 1e-9. Change 0.5 to 1.0. Save the file. Predict the new T first: e−2 ≈ 0.135. Then run the command from step 3 again.

    The new receipt shows a different script hash. That is correct. It means the run is yours, not the packaged example. Write down what you changed and what you predicted.

YOUR ACCOUNT · NO INSTALL

Run this lab here

A Linux runner runs the packaged script with the numbers you choose and sends the receipt to your account. You can change only Σ (macroscopic cross section) and L (slab thickness), each inside a fixed range. Predict the result first, as in step 5. The receipt is labelled “Hosted”, never “Unchanged example”.

Sign in to run this lab here →

YOUR ACCOUNT

Add this run

Keep the run in your account. Do this after step 4, and again after each change in step 5.

Sign in to keep this run in your account →

Verification and provenance

Verified with the real solver on Linux x86-64 (Ubuntu 22.04 CI). Run time: 1.07 seconds. Peak memory: 153.3 MiB. These numbers include program start-up and exclude installation. Your computer will differ.

Also verified on macOS 14 on an Apple-silicon runner under Rosetta 2 (GitHub macos-14 CI), run 37694071725: the same script passed every check in 4.30 seconds. The Mac lock explicit-osx-64.txt and its receipt are in the download.

Package SHA-256: 411864c44089c7b2b8b66cb13342472df6d19b6f6a0357242e9aba316f7b8f66

Native Windows is not tested for this lab. Each download includes the original teaching code, the MIT license, dependency license links, the analytical checks, and the verification receipts. The solver packages keep their own licenses.

Follow the reproducibility journey →