How throddy/diesel-mas works
diesel-mas is an advisory decision-support system for forecasting hydrotreated diesel sulfur and recommending operating adjustments; it does not write to process control. The operator-facing workflow assembles plant and laboratory data, assesses data quality and product quality, evaluates feasible actions, applies safety and reliability checks, and presents an explanation for the technologist. The graph reflects the README and indexed source references; where implementation excerpts were unavailable, relationships are included only when documented or visible in the index.
Main entry points: pipeline.py System assembly · orchestrator.py Decision orchestration · quality_agent.py Quality assessment · optimization_agent.py Action generation
Components 27
Data and features
- Plant data sources
- Data loading
src/data/loaders.py - Prepared data store
src/data/store.py - Time alignment
src/data/alignment.py - Feature dataset
src/features/dataset.py - Process features
src/features/process_features.py - Quality features
src/features/quality_features.py
Quality forecasting
- Sulfur forecast
src/models/quality.py - Horizon forecasts
src/models/horizons.py - Soft sensors
src/models/soft_sensors.py
Decision agents
- Agent contracts
src/schemas.py - Data quality checks
src/agents/data_quality_agent.py - Quality assessment
src/agents/quality_agent.py - Reliability assessment
src/agents/reliability_agent.py - Action generation
src/agents/optimization_agent.py - Safety review
src/agents/safety_agent.py - What-if assessment
src/agents/whatif_agent.py - Decision orchestration
src/agents/orchestrator.py - Agent message bus
src/mas/bus.py - Recommendation explanation
src/agents/explainer_agent.py
Action evaluation
- Action candidates
src/optimization/candidates.py - Feasibility constraints
src/optimization/constraints.py - Expected loss
src/decision/expected_loss.py
Operator interface
- Decision UI
app.py - System assembly
src/pipeline.py - Configuration
src/config.py
Other components
- Operator
Connections 37
- Operator → Decision UI: requests decision
README.md - Decision UI → System assembly: builds system
app.py - System assembly → Configuration: loads settings
src/pipeline.py - Plant data sources → Data loading: provides measurements
README.md - System assembly → Prepared data store: loads prepared data
src/pipeline.py - Data loading → Prepared data store: reads prepared data
src/data/loaders.py - System assembly → Data loading: loads data
src/pipeline.py - System assembly → Data quality checks: assembles agent
src/pipeline.py - System assembly → Quality assessment: assembles agent
src/pipeline.py - System assembly → Reliability assessment: assembles agent
src/pipeline.py - System assembly → Action generation: assembles agent
src/pipeline.py - System assembly → Safety review: assembles agent
src/pipeline.py - System assembly → What-if assessment: assembles agent
src/pipeline.py - System assembly → Decision orchestration: assembles orchestrator
src/pipeline.py - System assembly → Sulfur forecast: loads model
src/pipeline.py - System assembly → Feature dataset: uses data preparation
- Feature dataset → Time alignment: aligns availability
src/features/dataset.py - Feature dataset → Process features: builds features
src/features/dataset.py - Feature dataset → Quality features: builds features
src/features/dataset.py - Quality assessment → Process features: uses features
src/agents/quality_agent.py - Quality assessment → Quality features: uses features
src/agents/quality_agent.py - Quality assessment → Sulfur forecast: forecasts sulfur
src/agents/quality_agent.py - Quality assessment → Horizon forecasts: requests horizons
src/agents/quality_agent.py - Quality assessment → Soft sensors: requests estimates
src/agents/quality_agent.py - Decision orchestration → Data quality checks: requests state
src/agents/orchestrator.py - Decision orchestration → Quality assessment: requests assessment
src/agents/orchestrator.py - Decision orchestration → Reliability assessment: requests assessment
src/agents/orchestrator.py - Decision orchestration → Action generation: requests candidates
src/agents/orchestrator.py - Decision orchestration → Safety review: checks candidates
src/agents/orchestrator.py - Action generation → Action candidates: generates actions
src/agents/optimization_agent.py - Action generation → Expected loss: ranks by loss
src/agents/optimization_agent.py - Action generation → What-if assessment: sends scenarios
src/agents/optimization_agent.py - Decision orchestration → Recommendation explanation: builds explanation
src/agents/orchestrator.py - Decision orchestration → Agent message bus: publishes messages
src/agents/orchestrator.py - Decision orchestration → Operator: presents recommendation
src/agents/orchestrator.py - Action generation → Feasibility constraints: checks feasibility
- Agent contracts → Decision orchestration: defines contracts
src/agents/orchestrator.py