# danielwei2002/trustpcb architecture

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

- Interactive diagram: https://gitdiagram.com/danielwei2002/trustpcb
- Repository: https://github.com/danielwei2002/trustpcb

## Overview

TrustPCB is a research workflow for reliability-aware PCB defect detection, not a general-purpose detection service. Researchers configure dataset paths and splits, train/evaluate a detector, derive and compare confidence calibrators and reliability signals, then evaluate risk scores and selective human-review referral. RQ1 benchmarking and RQ2/RQ3 analyses are distinct research stages; artifact provenance and path compatibility support reproducible runs. The README documents the overall capabilities, while source excerpts show selected module references and validations; unsampled wiring is not asserted as a confirmed call flow.

Main entry points: [`src/trustpcb/rq2_risk_evaluation.py`](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_risk_evaluation.py) (Risk evaluation), [`src/trustpcb/rq2_final_calibrator.py`](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_final_calibrator.py) (Final calibrator), [`src/trustpcb/rq2_data_partition.py`](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_data_partition.py) (Data partition), [`src/trustpcb/rq2_final_evaluation.py`](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_final_evaluation.py) (Final evaluation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundation["Data and provenance"]
  node_paths["Dataset paths<br/>[dataset_config.py]"]
  node_artifact_paths["Artifact compatibility"]
end

subgraph group_rq1["Detector benchmark"]
  node_rq1["RQ1 training workflow<br/>[rq1.py]"]
end

subgraph group_rq2["Reliability analysis"]
  node_partition["Data partition"]
  node_detector["Detector training"]
  node_confidence["Confidence extraction"]
  node_calibration_analysis["Calibration analysis"]
  node_comparison["Calibrator comparison"]
  node_final_calibrator["Final calibrator"]
  node_stability["Transformation stability"]
  node_risk["Risk evaluation"]
  node_sensitivity["Risk sensitivity"]
  node_fusion["Weighted fusion"]
  node_final_eval["Final evaluation"]
  node_weighted_eval["Weighted evaluation"]
end

subgraph group_rq3["Review and evaluation"]
  node_efficiency["Efficiency evaluation"]
  node_selective_review["Selective review"]
  node_rq3_final["RQ3 final evaluation"]
end

node_researcher(("Researcher"))
node_dataset[("PCB dataset")]
node_research_results[("Research artifacts")]

node_researcher -->|"configures"| node_paths
node_dataset -.->|"provides data"| node_partition
node_paths -.->|"sets paths"| node_partition
node_partition -.->|"defines splits"| node_detector
node_detector -->|"supplies checkpoint"| node_confidence
node_confidence -->|"provides predictions"| node_calibration_analysis
node_calibration_analysis -->|"provides correctness data"| node_comparison
node_comparison -->|"supports fitting"| node_final_calibrator
node_final_calibrator -->|"validates calibrator"| node_stability
node_final_calibrator -->|"supplies calibrated signals"| node_risk
node_risk -->|"evaluates sensitivity"| node_sensitivity
node_risk -->|"supplies risk signals"| node_fusion
node_fusion -->|"applies frozen weights"| node_weighted_eval
node_researcher -.->|"runs benchmark"| node_rq1
node_rq1 -.->|"records results"| node_research_results
node_stability -->|"evaluates transformations"| node_final_eval
node_risk -->|"evaluates predictions"| node_final_eval
node_final_eval -.->|"writes metrics"| node_research_results
node_risk -->|"supports referral"| node_selective_review
node_weighted_eval -->|"supports review analysis"| node_selective_review
node_selective_review -->|"provides review results"| node_rq3_final
node_efficiency -.->|"records timings"| node_research_results
node_rq3_final -.->|"writes evaluation"| node_research_results
node_artifact_paths -.->|"resolves inputs"| node_research_results

click node_paths "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/dataset_config.py"
click node_artifact_paths "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_artifact_paths.py"
click node_rq1 "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq1.py"
click node_partition "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_data_partition.py"
click node_detector "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_detector_training.py"
click node_confidence "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_confidence_distribution.py"
click node_calibration_analysis "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_calibration_analysis.py"
click node_comparison "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_calibrator_comparison.py"
click node_final_calibrator "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_final_calibrator.py"
click node_stability "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_transformation_stability.py"
click node_risk "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_risk_evaluation.py"
click node_sensitivity "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_risk_sensitivity.py"
click node_fusion "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_weighted_fusion.py"
click node_final_eval "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_final_evaluation.py"
click node_weighted_eval "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_weighted_final_evaluation.py"
click node_efficiency "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq3_computational_efficiency.py"
click node_selective_review "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq3_selective_review.py"
click node_rq3_final "https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq3_final_evaluation.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_paths,node_artifact_paths toneBlue
class node_rq1,node_dataset,node_research_results toneAmber
class node_partition,node_detector,node_confidence,node_calibration_analysis,node_comparison,node_final_calibrator,node_stability,node_risk,node_sensitivity,node_fusion,node_final_eval,node_weighted_eval toneMint
class node_efficiency,node_selective_review,node_rq3_final toneRose
class node_researcher toneIndigo
```

## Components

### Data and provenance

- [Dataset paths](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/dataset_config.py): `src/trustpcb/dataset_config.py`
- [Artifact compatibility](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_artifact_paths.py): `src/trustpcb/rq2_artifact_paths.py`

### Detector benchmark

- [RQ1 training workflow](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq1.py): `src/trustpcb/rq1.py`

### Reliability analysis

- [Data partition](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_data_partition.py): `src/trustpcb/rq2_data_partition.py`
- [Detector training](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_detector_training.py): `src/trustpcb/rq2_detector_training.py`
- [Confidence extraction](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_confidence_distribution.py): `src/trustpcb/rq2_confidence_distribution.py`
- [Calibration analysis](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_calibration_analysis.py): `src/trustpcb/rq2_calibration_analysis.py`
- [Calibrator comparison](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_calibrator_comparison.py): `src/trustpcb/rq2_calibrator_comparison.py`
- [Final calibrator](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_final_calibrator.py): `src/trustpcb/rq2_final_calibrator.py`
- [Transformation stability](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_transformation_stability.py): `src/trustpcb/rq2_transformation_stability.py`
- [Risk evaluation](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_risk_evaluation.py): `src/trustpcb/rq2_risk_evaluation.py`
- [Risk sensitivity](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_risk_sensitivity.py): `src/trustpcb/rq2_risk_sensitivity.py`
- [Weighted fusion](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_weighted_fusion.py): `src/trustpcb/rq2_weighted_fusion.py`
- [Final evaluation](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_final_evaluation.py): `src/trustpcb/rq2_final_evaluation.py`
- [Weighted evaluation](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq2_weighted_final_evaluation.py): `src/trustpcb/rq2_weighted_final_evaluation.py`

### Review and evaluation

- [Efficiency evaluation](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq3_computational_efficiency.py): `src/trustpcb/rq3_computational_efficiency.py`
- [Selective review](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq3_selective_review.py): `src/trustpcb/rq3_selective_review.py`
- [RQ3 final evaluation](https://github.com/danielwei2002/trustpcb/blob/main/src/trustpcb/rq3_final_evaluation.py): `src/trustpcb/rq3_final_evaluation.py`

### Other components

- **Researcher**
- **PCB dataset**
- **Research artifacts**

## Connections

- Researcher → Dataset paths: configures (evidence: `src/trustpcb/dataset_config.py`)
- PCB dataset → Data partition: provides data (evidence: `README.md`)
- Dataset paths → Data partition: sets paths (evidence: `src/trustpcb/rq2_data_partition.py`)
- Data partition → Detector training: defines splits (evidence: `src/trustpcb/rq2_detector_training.py`)
- Detector training → Confidence extraction: supplies checkpoint (evidence: `src/trustpcb/rq2_confidence_distribution.py`)
- Confidence extraction → Calibration analysis: provides predictions (evidence: `src/trustpcb/rq2_calibration_analysis.py`)
- Calibration analysis → Calibrator comparison: provides correctness data (evidence: `src/trustpcb/rq2_calibrator_comparison.py`)
- Calibrator comparison → Final calibrator: supports fitting (evidence: `src/trustpcb/rq2_final_calibrator.py`)
- Final calibrator → Transformation stability: validates calibrator (evidence: `src/trustpcb/rq2_transformation_stability.py`)
- Final calibrator → Risk evaluation: supplies calibrated signals (evidence: `src/trustpcb/rq2_risk_evaluation.py`)
- Risk evaluation → Risk sensitivity: evaluates sensitivity (evidence: `src/trustpcb/rq2_risk_sensitivity.py`)
- Risk evaluation → Weighted fusion: supplies risk signals (evidence: `src/trustpcb/rq2_weighted_fusion.py`)
- Weighted fusion → Weighted evaluation: applies frozen weights (evidence: `src/trustpcb/rq2_weighted_final_evaluation.py`)
- Researcher → RQ1 training workflow: runs benchmark (evidence: `README.md`)
- RQ1 training workflow → Research artifacts: records results (evidence: `README.md`)
- Transformation stability → Final evaluation: evaluates transformations (evidence: `src/trustpcb/rq2_final_evaluation.py`)
- Risk evaluation → Final evaluation: evaluates predictions (evidence: `src/trustpcb/rq2_final_evaluation.py`)
- Final evaluation → Research artifacts: writes metrics (evidence: `README.md`)
- Risk evaluation → Selective review: supports referral (evidence: `src/trustpcb/rq3_selective_review.py`)
- Weighted evaluation → Selective review: supports review analysis (evidence: `src/trustpcb/rq3_selective_review.py`)
- Selective review → RQ3 final evaluation: provides review results (evidence: `src/trustpcb/rq3_final_evaluation.py`)
- Efficiency evaluation → Research artifacts: records timings (evidence: `README.md`)
- RQ3 final evaluation → Research artifacts: writes evaluation (evidence: `README.md`)
- Artifact compatibility → Research artifacts: resolves inputs (evidence: `src/trustpcb/rq2_artifact_paths.py`)
