How courtsb/mongoose works
MONGOOSE is an adaptive reduced-order Monte Carlo fission-operator workflow driven by CLI commands and a persistent case workspace. Its main run prepares and executes OpenMC pilot and modal calculations, extracts responses, builds and solves a reduced operator, then uses residuals and importance to refine the basis and allocate further histories. Separate branches support pin-local OpenMC models and bank-informed source phase-space libraries. The controller’s imports and README document the main orchestration; unsampled implementations limit finer-grained claims about internal calls.
Main entry points: controller.py Workflow controller · cli.py CLI · assembly.py Operator assembly · extractor.py Response extraction
Components 24
Case setup
- Configuration
src/mongoose/config/loader.py - Case index
src/mongoose/case/index.py - Workspace
src/mongoose/case/workspace.py
OpenMC transport
- Pilot transport
src/mongoose/adapters/openmc/pilot.py - Task preparation
src/mongoose/adapters/openmc/prepare.py - OpenMC runner
src/mongoose/adapters/openmc/runner.py - Persistent workers
src/mongoose/adapters/openmc/persistent.py - Task scheduler
src/mongoose/execution/scheduler.py - Pin-local adapter
src/mongoose/adapters/openmc/pin_local.py - Statepoint reader
src/mongoose/adapters/openmc/statepoint.py
Adaptive reduction
- Response extraction
src/mongoose/responses/extractor.py - Response library
src/mongoose/responses/library.py - Basis and enrichment
src/mongoose/basis/enrichment.py - Operator assembly
src/mongoose/operator/assembly.py - Eigen solver
src/mongoose/solve/eigen.py - History allocation
src/mongoose/importance/allocation.py
Source libraries
- Source workflow
src/mongoose/source/workflow.py - Phase-space library
src/mongoose/source/phase_space.py - Source spectrum
src/mongoose/source/spectrum.py
Workflow operations
- CLI
src/mongoose/cli.py - Preflight checks
src/mongoose/validation/preflight.py - Workflow controller
src/mongoose/workflow/controller.py
Other components
- User
- OpenMC
Connections 32
- User → CLI: invokes
README.md - CLI → Configuration: loads
- CLI → Workflow controller: dispatches
- CLI → Preflight checks: runs checks
- Workflow controller → Case index: uses
src/mongoose/workflow/controller.py - Workflow controller → Workspace: uses
- Workflow controller → Pilot transport: runs
src/mongoose/workflow/controller.py - Workflow controller → Task preparation: prepares tasks
src/mongoose/workflow/controller.py - Workflow controller → OpenMC runner: runs tasks
src/mongoose/workflow/controller.py - Workflow controller → Persistent workers: runs tasks
src/mongoose/workflow/controller.py - Workflow controller → Task scheduler: schedules
src/mongoose/workflow/controller.py - Workflow controller → Basis and enrichment: refines
src/mongoose/workflow/controller.py - Workflow controller → Response extraction: extracts responses
src/mongoose/workflow/controller.py - Workflow controller → Operator assembly: assembles
- Workflow controller → Eigen solver: solves
src/mongoose/workflow/controller.py - Workflow controller → History allocation: allocates histories
- Workflow controller → Source workflow: uses
src/mongoose/workflow/controller.py - Workflow controller → Phase-space library: uses
src/mongoose/workflow/controller.py - Task preparation → Pin-local adapter: adapts model
src/mongoose/adapters/openmc/prepare.py - Response extraction → Statepoint reader: reads tally
src/mongoose/responses/extractor.py - Response extraction → Response library: stores responses
src/mongoose/responses/extractor.py - Operator assembly → Response library: reads responses
src/mongoose/operator/assembly.py - Operator assembly → Basis and enrichment: uses modes
src/mongoose/operator/assembly.py - Eigen solver → Operator assembly: reads operator
- Basis and enrichment → Eigen solver: supports solve
src/mongoose/basis/enrichment.py - Source workflow → Phase-space library: uses library
- Source workflow → Source spectrum: uses spectrum
- Pilot transport → OpenMC runner: launches
src/mongoose/adapters/openmc/pilot.py - OpenMC runner → OpenMC: runs transport
README.md - Persistent workers → OpenMC: runs transport
README.md - Preflight checks → Case index: validates indexing
src/mongoose/validation/preflight.py - Preflight checks → Pilot transport: checks pilot
src/mongoose/validation/preflight.py