release candidate 0.1

Author: maureeungaro

.github/workflows/dev_release.yml

@@ -16,7 +16,7 @@ jobs:
   dev-release:
     runs-on: ubuntu-latest
     env:
-      DEVMD_SINCE: "2024-08-09"   # optional fixed start date
+      DEVMD_SINCE: "2026-04-29"   # optional fixed start date
       TAG_NAME: "dev"             # reuse the same tag each night
       RELEASE_TITLE: "Dev Nightly"
     steps:

ci/update-devmd.sh

@@ -18,7 +18,8 @@ fi
 echo "[devmd] branch = $BRANCH"
 
 # --- Time window (optional) ---
-SINCE="2024-08-09" # Manually set the start date for commits
+SINCE="2026-04-29" # Manually set the start date for commits
+
 UNTIL="${DEVMD_UNTIL:-}"   # e.g. 2025-09-01
 FLAGS=""
 [ -n "$SINCE" ] && FLAGS="$FLAGS --since=$SINCE"

examples/basic/b2/b2.py

@@ -1,14 +1,65 @@
 #!/usr/bin/env python3
-
-# gemc api
 from gconfiguration import autogeometry
-
-# build_geometry and define_materials are in geometry.py, materials.py
-from geometry import build_geometry
-from materials import define_materials
+from gvolume import GVolume
 
 cfg = autogeometry("examples", "b2")
 
-build_geometry(cfg)
-define_materials(cfg)
+fNbOfChambers = 5
+chamberSpacing = 800  # from chamber center to center
+
+chamberWidth = 200.0  # width of the chambers
+targetLength = 50.0  # full length of Target
+
+trackerLength = (fNbOfChambers + 1) * chamberSpacing
+worldLength = 1.2 * (2 * targetLength + trackerLength)
+
+targetRadius = 0.5 * targetLength  # Radius of Target
+targetLength = 0.5 * targetLength  # Half length of the Target
+trackerSize = 0.5 * trackerLength  # Half length of the Tracker
+
+gvolume = GVolume('root')
+gvolume.description = 'World'
+gvolume.make_box(worldLength * 0.5, worldLength * 0.5, worldLength * 0.5)
+gvolume.material = 'G4_AIR'
+gvolume.color = 'ghostwhite'
+gvolume.visible = 0
+gvolume.publish(cfg)
+
+tz = -(targetLength + trackerSize)
+gvolume = GVolume('target')
+gvolume.description = 'Lead Target'
+gvolume.make_tube(0, targetRadius, targetLength, 0, 360)
+gvolume.material = 'G4_Pb'
+gvolume.set_position(0, 0, tz)
+gvolume.color = 'steelblue'
+gvolume.publish(cfg)
+
+gvolume = GVolume('tracker')
+gvolume.description = 'Chamber Tracker Container'
+gvolume.make_tube(0, trackerSize, trackerSize, 0, 360)
+gvolume.material = 'G4_AIR'
+gvolume.opacity = 0.1
+gvolume.publish(cfg)
+
+firstPosition = -trackerSize + chamberSpacing
+firstLength = trackerLength / 10
+lastLength = trackerLength
+halfWidth = 0.5 * chamberWidth
+rmaxFirst = 0.5 * firstLength
+
+rmaxIncr = 0.5 * (lastLength - firstLength) / (fNbOfChambers - 1)
 
+# loop from 0 to fNbOfChambers
+for copyNo in range(fNbOfChambers):
+	Zposition = firstPosition + copyNo * chamberSpacing
+	rmax = rmaxFirst + copyNo * rmaxIncr
+	gvolume = GVolume(f'chamber_{copyNo}')
+	gvolume.mother = 'tracker'
+	gvolume.description = f'Chamber Tracker {copyNo}'
+	gvolume.make_tube(0, rmax, halfWidth, 0, 360)
+	gvolume.material = 'G4_Xe'
+	gvolume.color = 'metallic, papayawhip'
+	gvolume.set_position(0, 0, Zposition)
+	gvolume.digitization = 'flux'  # adds edep, pid, etc to hits
+	gvolume.set_identifier('mychamber', copyNo)
+	gvolume.publish(cfg)

examples/basic/b2/geometry.py

@@ -0,0 +1,68 @@
+<br/>
+
+The code is stable enough at this point to call this a release.
+
+# Release notes
+
+The core of GEMC is now complete and includes:
+
+- Python API to create geometry and materials
+- Support for ASCII, SQLite, GDML, CAD meshes volume imports
+- Custom extensibility of digitization, output formats, electro-magnetic fields 
+- Built-in dosimeter, flux, particle_counter 
+- Built-in ASCII, CSV, JSON, ROOT output 
+- pyvista 3D visualization
+
+
+Two examples are provided that reproduce the Geant4 basic examples B1 and B2.
+
+The CI workflow includes:
+
+- Code deployment and testing
+- A nightly `dev` release 
+- Homepage and Doxygen documentation
+- Sanitizer checks
+- CodeQL analysis
+
+# Issues Addressed
+
+- [[#21]](https://github.com/gemc/src/issues/21): Complete multipoles fields implementation
+- [[#25]](https://github.com/gemc/src/issues/25): add g4 dialog with search capabilities
+- [[#34]](https://github.com/gemc/src/issues/34): sqlite db
+- [[#29]](https://github.com/gemc/src/issues/29): new class logger
+- [[#23]](https://github.com/gemc/src/issues/23): complete B1 example
+- [[#1]](https://github.com/gemc/src/issues/1): Update homepage
+- [[#19]](https://github.com/gemc/src/issues/19): Add doxygen
+- [[#50]](https://github.com/gemc/src/issues/50): simplify goptions command line
+- [[#51]](https://github.com/gemc/src/issues/51): use verbosity and options in meson.build
+- [[#60]](https://github.com/gemc/src/issues/60): revisit i_test meson option
+- [[#68]](https://github.com/gemc/src/issues/68): add JSON output format
+- [[#67]](https://github.com/gemc/src/issues/67): gdata flow not clear
+- [[#44]](https://github.com/gemc/src/issues/44): all options help consistency
+- [[#69]](https://github.com/gemc/src/issues/69): add detector tree viewer
+- [[#26]](https://github.com/gemc/src/issues/26): add csv output
+- [[#37]](https://github.com/gemc/src/issues/37): add B2 example
+- [[#53]](https://github.com/gemc/src/issues/53): each subclass should instantiate its own logger
+
+
+
+
+# Supported platforms
+
+Both AMD and ARM processors are supported.
+
+- macOS: 26
+- Ubuntu: 24.04
+- AlmaLinux: 9.4
+- Fedora: 42
+- Debian: 13
+- ArchLinux: latest
+
+
+
+# Dependencies
+
+- Geant4: 11.4.1 or higher
+- CLHEP: 2.4.6.0 or higher
+- Xerces-C: 3.2 or higher
+

examples/basic/b2/materials.py

@@ -0,0 +1,36 @@
+<br/>
+
+Descripton of changes and fixes in this release.
+
+# Release notes
+
+
+
+# New Developments
+
+
+
+# Issues Addressed
+
+
+
+# Supported platforms
+
+Both AMD and ARM processors are supported.
+
+- macOS: 26
+- Ubuntu: 24.04
+- AlmaLinux: 9.4
+- Fedora: 42
+- Debian: 13
+- ArchLinux: latest
+
+
+
+# Dependencies
+
+- Geant4: 11.4.1 or higher
+- CLHEP: 2.4.6.0 or higher
+- Xerces-C: 3.2 or higher
+
+# Detailed list of changes and fixes