Skip to content

Releases: clrp-code/EGSnrc_CLRP

egs_brachy-2026-06-25-beta.1

Pre-release

Choose a tag to compare

Baseline: NRC EGSnrc v2025a (nrc/master at merge base 9edee3eb, Dec 2025).

This is the CLRP fork of EGSnrc required to build and run egs_brachy.

Paired application release: egs_brachy 2026-06-25-beta.1


CLRP additions (not in NRC EGSnrc)

Distribution & install

  • egs_brachy user code bundled as a git submodule at HEN_HOUSE/user_codes/egs_brachy
  • eb-setup.sh guided install, update, sync, and diagnostics for egs_brachy
  • Release tarballs: EGSnrc_CLRP-eb-setup-*.tar.gz (bootstrap installer) and full source archives
  • clrp_bashrc_additions: shell aliases for egs_brachy, egs_mird, and egs_chamber (exeb, exbeb, etc.)

egs++ extensions for brachytherapy workflows

  • getVolume() on key geometries (e.g. spheres, RZ) to support region discovery / volume correction
  • Gzipped egsphant input support (gzstream in egs_glib, egs_nd_geometry, egs_autoenvelope)
  • egsphant in egs_glib, including material-density file support
  • EGS_cSphericalShell and related geometry fixes used by brachy models
  • egs_internal_source: internal radionuclide emission source class (used by egs_mird)
  • Radionuclide source generation weighting updates (Martin Martinov)
  • Lowercase media-character support in egsphant files

Additional CLRP user codes

  • egs_mird: internal radionuclide dosimetry application (Ting Lee, Rowan Thomson, Martin Martinov)
  • egs_chamber: multiregion scoring variant maintained for CLRP work

Build, run, and data

  • Parallel-run script improvements for egs_brachy (egs-parallel-cpu, lock-file handling)
  • Brachy-oriented PEGS4 data (brachy_xcom_1.5MeV.pegs4dat, additional media such as AgBrAgI)
  • macOS DSO @rpath / rpath fixes so egs_brachy geometry libraries load correctly from $EGS_HOME/bin

New in this release vs NRC (beta.1)

CLRP-specific changes since egs_brachy-2026-06-23-alpha.3:

Run-anywhere I/O (#25)

Adopts NRC PR #1399 ahead of upstream merge:

  • Resolve .egsinp files from the current working directory first, then $EGS_HOME/<app>/
  • Write run artifacts to the input directory by default; override with -d / --output-dir
  • Consistent behaviour in Mortran core, egs++, wrapper scripts, GUI launch, and parallel run-control lock/.egsdat paths

eb-setup.sh install/update tooling (#24)

Interactive install and update from release tarballs or git; syncs egs_brachy into $EGS_HOME and runs configure.

Quieter egs++ startup logging

Removes stale revision noise from default application startup output.

Submodule bump

Points at egs_brachy 2026-06-25-beta.1 (5462d2a).


Install

From release tarball (recommended):

tar -xzf EGSnrc_CLRP-eb-setup-2026-06-25-beta.1.tar.gz
cd EGSnrc_CLRP-eb-setup-2026-06-25-beta.1
./eb-setup.sh install --egs-home $HOME/egs_home/

From git:

git clone https://github.com/clrp-code/EGSnrc_CLRP.git
cd EGSnrc_CLRP
git checkout egs_brachy
git submodule update --init
./configure
./eb-setup.sh sync

What this release does not include

  • Changes that are already in stock NRC EGSnrc (e.g. general v2025a core updates) are inherited from upstream, not listed here.
  • egs_brachy application features (scoring modes, source library, volume correction, etc.) are documented in the egs_brachy release, not repeated above.