How alertxsto/scentinel works
Scentinel is a desktop waste-load assessment and RDF-suitability screening application. Operators enter batch composition, moisture, tonnage and age; the assessment pipeline derives gas generation, material balance, route suitability and a recommendation. A separate project workflow configures bin geometry and gas sources, meshes and generates an OpenFOAM case, runs it in Podman, samples concentrations and presents results; projects and immutable run records preserve provenance, while virtual sensors replay simulated readings. Relationships for unsampled subsystems are limited to README statements and SOURCE INDEX references; physical sensor acquisition is not implemented.
Main entry points: main_window.py Project editor · pipeline.py Assessment pipeline · solver_worker.py Solver worker · casegen.py OpenFOAM case
Components 28
Desktop workspace
- App startup
src/scentinel/app.py - Home window
src/scentinel/ui/home_window.py - Docked workspace
src/scentinel/ui/workspace.py - Project editor
src/scentinel/ui/main_window.py - Setup panel
src/scentinel/ui/setup_panel.py - Runtime language
src/scentinel/ui/i18n.py - Results panel
src/scentinel/ui/results_panel.py - Field view
src/scentinel/ui/field_view.py - Virtual sensors
src/scentinel/ui/sensor_lab.py
Waste assessment
- Batch panel
src/scentinel/ui/batch_panel.py - Waste composition
src/scentinel/core/composition.py - Scenario inputs
src/scentinel/core/scenario.py - Gas catalogue
src/scentinel/core/gas_data.py - Gas generation
src/scentinel/core/generation.py - Assessment pipeline
src/scentinel/core/pipeline.py - Material balance
src/scentinel/core/massbalance.py - Route suitability
src/scentinel/core/suitability.py - Recommendation
src/scentinel/core/recommend.py
CFD simulation
- Bin geometry
src/scentinel/core/geometry.py - Gmsh meshing
src/scentinel/core/mesh.py - OpenFOAM case
src/scentinel/core/casegen.py - Solver worker
src/scentinel/ui/solver_worker.py - Container runner
src/scentinel/core/runner.py - Podman execution
src/scentinel/core/container.py - Probe postprocessing
src/scentinel/core/post.py
Projects and records
- Project files
src/scentinel/core/project.py - Run history
src/scentinel/core/history.py
Other components
- Operator
Connections 36
- Operator → Home window: opens app
README.md - Home window → Project editor: opens workspace
src/scentinel/ui/home_window.py - App startup → Home window: starts
src/scentinel/app.py - App startup → Runtime language: initializes
src/scentinel/app.py - Project editor → Setup panel: edits inputs
src/scentinel/ui/main_window.py - Project editor → Batch panel: shows panel
src/scentinel/ui/main_window.py - Project editor → Runtime language: switches language
src/scentinel/ui/main_window.py - Setup panel → Scenario inputs: configures
src/scentinel/ui/setup_panel.py - Setup panel → Bin geometry: configures
src/scentinel/ui/setup_panel.py - Setup panel → Gas catalogue: selects gases
src/scentinel/ui/setup_panel.py - Batch panel → Assessment pipeline: assesses batch
src/scentinel/ui/batch_panel.py - Assessment pipeline → Gas generation: calculates gas
src/scentinel/core/pipeline.py - Assessment pipeline → Material balance: balances material
src/scentinel/core/pipeline.py - Assessment pipeline → Route suitability: scores routes
src/scentinel/core/pipeline.py - Assessment pipeline → Recommendation: forms recommendation
src/scentinel/core/pipeline.py - Assessment pipeline → Waste composition: uses composition
src/scentinel/core/pipeline.py - Gas generation → Waste composition: uses composition
src/scentinel/core/generation.py - Project editor → Solver worker: starts simulation
src/scentinel/ui/main_window.py - Solver worker → Gmsh meshing: generates mesh
src/scentinel/ui/solver_worker.py - Solver worker → OpenFOAM case: writes case
src/scentinel/ui/solver_worker.py - Solver worker → Container runner: runs solver
src/scentinel/ui/solver_worker.py - Solver worker → Probe postprocessing: samples results
src/scentinel/ui/solver_worker.py - Gmsh meshing → Bin geometry: meshes geometry
src/scentinel/core/mesh.py - OpenFOAM case → Scenario inputs: reads inputs
src/scentinel/core/casegen.py - OpenFOAM case → Bin geometry: reads geometry
src/scentinel/core/casegen.py - OpenFOAM case → Gas generation: uses gas rates
src/scentinel/core/casegen.py - OpenFOAM case → Gas catalogue: resolves gases
src/scentinel/core/casegen.py - Container runner → Podman execution: executes in
src/scentinel/core/runner.py - Project editor → Results panel: updates results
src/scentinel/ui/main_window.py - Results panel → Field view: renders field
src/scentinel/ui/results_panel.py - Results panel → Run history: reads runs
src/scentinel/ui/results_panel.py - Project editor → Virtual sensors: opens lab
src/scentinel/ui/main_window.py - Virtual sensors → Project files: reads configuration
src/scentinel/ui/sensor_lab.py - Project editor → Project files: saves and loads
src/scentinel/core/project.py - Project editor → Run history: records attempts
src/scentinel/ui/main_window.py - Solver worker → Run history: finalizes record