# gandharv2323/hydrox-tesseract-26 architecture

> Architecture diagram of the GitHub repository gandharv2323/hydrox-tesseract-26, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gandharv2323/hydrox-tesseract-26
- Repository: https://github.com/gandharv2323/hydrox-tesseract-26

## Overview

HydroX is a pump-monitoring digital twin: sensor readings are simulated or replayed, processed into live health/anomaly/fault/RUL state, then exposed through REST and WebSocket interfaces. Its advanced inference path validates readings, accumulates sliding windows, derives hybrid features, and combines anomaly, fault, and prognostic estimates with calibration and consistency logic. Training, data preparation, and evaluation are important supporting product capabilities. Some runtime internals and API wiring are documented but not fully excerpted; uncertain links are omitted.

Main entry points: [`training/train_all.py`](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/training/train_all.py) (Model Training), [`pipeline/inference_engine.py`](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/inference_engine.py) (Inference Orchestrator), [`main.py`](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/main.py) (API And Broadcast), [`pipeline/representation.py`](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/representation.py) (Hybrid Representation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Live Monitoring"]
  node_simulator["Sensor Simulator<br/>[sensor_sim.py]"]
  node_legacy["Legacy Detector<br/>[ml_model.py]"]
  node_health["Pump Health Metrics<br/>[health_engine.py]"]
  node_api["API And Broadcast<br/>[main.py]"]
  node_api_server["API Server Wrapper<br/>[server.py]"]
end

subgraph group_inference["Advanced Inference"]
  node_buffer["Sliding Window<br/>[buffer.py]"]
  node_features["Window Features<br/>[features.py]"]
  node_representation["Hybrid Representation<br/>[representation.py]"]
  node_inference_engine["Inference Orchestrator"]
end

subgraph group_ml["Models And Calibration"]
  node_fault["Fault Classifier"]
  node_rul["RUL Predictor<br/>[rul_lstm.py]"]
  node_latent["Shared Latent Encoder<br/>[shared_latent.py]"]
  node_threshold["Threshold Calibration<br/>[threshold.py]"]
  node_fusion["Learned Score Fusion<br/>[fusion_meta.py]"]
  node_score_fusion["Fallback Score Fusion<br/>[score_fusion.py]"]
end

subgraph group_data["Data And Training"]
  node_synthetic["Synthetic Data Generator<br/>[generate_data.py]"]
  node_data_loader["Real Data Loader<br/>[loader.py]"]
  node_preprocessing["Data Preprocessing<br/>[preprocessing.py]"]
  node_dataset["Dataset Loader<br/>[dataset_loader.py]"]
  node_trainer["Model Training<br/>[train_all.py]"]
end

subgraph group_evaluation["Evaluation"]
  node_eval_pipeline["Model Metrics<br/>[pipeline.py]"]
  node_eval_report["Evaluation Reports<br/>[report.py]"]
  node_scenario_eval["Scenario Evaluation<br/>[scenario_runner.py]"]
end

node_operator(("Monitoring Client"))
node_dashboard(("Dashboard Consumer"))
node_unity(("Unity Consumer"))

node_operator -->|"requests state"| node_api
node_simulator -->|"supplies readings"| node_api
node_api -->|"runs detector"| node_legacy
node_api -->|"computes metrics"| node_health
node_api -->|"runs inference"| node_inference_engine
node_api -->|"streams state"| node_dashboard
node_api -->|"serves payload"| node_unity
node_api_server -->|"imports"| node_api
node_inference_engine -->|"pushes readings"| node_buffer
node_inference_engine -->|"builds features"| node_representation
node_representation -->|"extracts descriptors"| node_features
node_representation -->|"encodes windows"| node_latent
node_inference_engine -->|"classifies faults"| node_fault
node_inference_engine -->|"predicts RUL"| node_rul
node_inference_engine -->|"loads threshold"| node_threshold
node_inference_engine -->|"fuses scores"| node_fusion
node_inference_engine -->|"uses fallback"| node_score_fusion
node_synthetic -->|"builds windows"| node_buffer
node_synthetic -->|"extracts features"| node_features
node_data_loader -.->|"prepares data"| node_preprocessing
node_dataset -->|"uses simulation"| node_simulator
node_trainer -->|"generates samples"| node_synthetic
node_trainer -->|"loads real data"| node_data_loader
node_trainer -->|"prepares real data"| node_preprocessing
node_trainer -->|"builds training features"| node_representation
node_trainer -->|"trains classifier"| node_fault
node_trainer -->|"trains predictor"| node_rul
node_trainer -->|"trains encoder"| node_latent
node_trainer -->|"calibrates thresholds"| node_threshold
node_trainer -->|"trains fusion"| node_fusion
node_eval_report -.->|"computes metrics"| node_eval_pipeline
node_scenario_eval -->|"runs scenarios"| node_inference_engine
node_scenario_eval -->|"drives scenarios"| node_simulator

click node_simulator "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/sensor_sim.py"
click node_legacy "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/ml_model.py"
click node_health "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/health_engine.py"
click node_api "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/main.py"
click node_api_server "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/api/server.py"
click node_buffer "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/buffer.py"
click node_features "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/features.py"
click node_representation "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/representation.py"
click node_inference_engine "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/inference_engine.py"
click node_fault "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/fault_classifier.py"
click node_rul "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/rul_lstm.py"
click node_latent "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/models/shared_latent.py"
click node_threshold "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/calibration/threshold.py"
click node_fusion "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/calibration/fusion_meta.py"
click node_score_fusion "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/calibration/score_fusion.py"
click node_synthetic "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/training/generate_data.py"
click node_data_loader "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/data_pipeline/loader.py"
click node_preprocessing "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/data_pipeline/preprocessing.py"
click node_dataset "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/dataset_loader.py"
click node_trainer "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/training/train_all.py"
click node_eval_pipeline "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/evaluation/pipeline.py"
click node_eval_report "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/evaluation/report.py"
click node_scenario_eval "https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/evaluation/scenario_runner.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_simulator,node_legacy,node_health,node_api,node_api_server,node_operator toneBlue
class node_buffer,node_features,node_representation,node_inference_engine toneAmber
class node_fault,node_rul,node_latent,node_threshold,node_fusion,node_score_fusion toneMint
class node_synthetic,node_data_loader,node_preprocessing,node_dataset,node_trainer toneRose
class node_eval_pipeline,node_eval_report,node_scenario_eval,node_dashboard,node_unity toneIndigo
```

## Components

### Live Monitoring

- [Sensor Simulator](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/sensor_sim.py): `sensor_sim.py`
- [Legacy Detector](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/ml_model.py): `ml_model.py`
- [Pump Health Metrics](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/health_engine.py): `health_engine.py`
- [API And Broadcast](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/main.py): `main.py`
- [API Server Wrapper](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/api/server.py): `api/server.py`

### Advanced Inference

- [Sliding Window](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/buffer.py): `pipeline/buffer.py`
- [Window Features](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/features.py): `pipeline/features.py`
- [Hybrid Representation](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/representation.py): `pipeline/representation.py`
- [Inference Orchestrator](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/inference_engine.py): `pipeline/inference_engine.py`

### Models And Calibration

- [Fault Classifier](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/fault_classifier.py): `pipeline/fault_classifier.py`
- [RUL Predictor](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/pipeline/rul_lstm.py): `pipeline/rul_lstm.py`
- [Shared Latent Encoder](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/models/shared_latent.py): `models/shared_latent.py`
- [Threshold Calibration](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/calibration/threshold.py): `calibration/threshold.py`
- [Learned Score Fusion](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/calibration/fusion_meta.py): `calibration/fusion_meta.py`
- [Fallback Score Fusion](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/calibration/score_fusion.py): `calibration/score_fusion.py`

### Data And Training

- [Synthetic Data Generator](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/training/generate_data.py): `training/generate_data.py`
- [Real Data Loader](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/data_pipeline/loader.py): `data_pipeline/loader.py`
- [Data Preprocessing](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/data_pipeline/preprocessing.py): `data_pipeline/preprocessing.py`
- [Dataset Loader](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/dataset_loader.py): `dataset_loader.py`
- [Model Training](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/training/train_all.py): `training/train_all.py`

### Evaluation

- [Model Metrics](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/evaluation/pipeline.py): `evaluation/pipeline.py`
- [Evaluation Reports](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/evaluation/report.py): `evaluation/report.py`
- [Scenario Evaluation](https://github.com/gandharv2323/hydrox-tesseract-26/blob/master/evaluation/scenario_runner.py): `evaluation/scenario_runner.py`

### Other components

- **Monitoring Client**
- **Dashboard Consumer**
- **Unity Consumer**

## Connections

- Monitoring Client → API And Broadcast: requests state (evidence: `README.md`)
- Sensor Simulator → API And Broadcast: supplies readings (evidence: `README.md`)
- API And Broadcast → Legacy Detector: runs detector (evidence: `README.md`)
- API And Broadcast → Pump Health Metrics: computes metrics (evidence: `README.md`)
- API And Broadcast → Inference Orchestrator: runs inference (evidence: `README.md`)
- API And Broadcast → Dashboard Consumer: streams state (evidence: `README.md`)
- API And Broadcast → Unity Consumer: serves payload (evidence: `README.md`)
- API Server Wrapper → API And Broadcast: imports (evidence: `api/server.py`)
- Inference Orchestrator → Sliding Window: pushes readings (evidence: `pipeline/inference_engine.py`)
- Inference Orchestrator → Hybrid Representation: builds features (evidence: `pipeline/inference_engine.py`)
- Hybrid Representation → Window Features: extracts descriptors (evidence: `pipeline/representation.py`)
- Hybrid Representation → Shared Latent Encoder: encodes windows (evidence: `pipeline/representation.py`)
- Inference Orchestrator → Fault Classifier: classifies faults (evidence: `pipeline/inference_engine.py`)
- Inference Orchestrator → RUL Predictor: predicts RUL (evidence: `pipeline/inference_engine.py`)
- Inference Orchestrator → Threshold Calibration: loads threshold (evidence: `pipeline/inference_engine.py`)
- Inference Orchestrator → Learned Score Fusion: fuses scores (evidence: `pipeline/inference_engine.py`)
- Inference Orchestrator → Fallback Score Fusion: uses fallback (evidence: `pipeline/inference_engine.py`)
- Synthetic Data Generator → Sliding Window: builds windows (evidence: `training/generate_data.py`)
- Synthetic Data Generator → Window Features: extracts features (evidence: `training/generate_data.py`)
- Real Data Loader → Data Preprocessing: prepares data
- Dataset Loader → Sensor Simulator: uses simulation (evidence: `dataset_loader.py`)
- Model Training → Synthetic Data Generator: generates samples (evidence: `training/train_all.py`)
- Model Training → Real Data Loader: loads real data (evidence: `training/train_all.py`)
- Model Training → Data Preprocessing: prepares real data (evidence: `training/train_all.py`)
- Model Training → Hybrid Representation: builds training features (evidence: `training/train_all.py`)
- Model Training → Fault Classifier: trains classifier (evidence: `training/train_all.py`)
- Model Training → RUL Predictor: trains predictor (evidence: `training/train_all.py`)
- Model Training → Shared Latent Encoder: trains encoder (evidence: `training/train_all.py`)
- Model Training → Threshold Calibration: calibrates thresholds (evidence: `training/train_all.py`)
- Model Training → Learned Score Fusion: trains fusion (evidence: `training/train_all.py`)
- Evaluation Reports → Model Metrics: computes metrics
- Scenario Evaluation → Inference Orchestrator: runs scenarios (evidence: `evaluation/scenario_runner.py`)
- Scenario Evaluation → Sensor Simulator: drives scenarios (evidence: `evaluation/scenario_runner.py`)
