Skip to content

Commit 143ff65

Browse files
committed
fix: Readme tighter wordings and updated figs
1 parent f86758d commit 143ff65

5 files changed

Lines changed: 2 additions & 322 deletions

File tree

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222

2323
**CNSD (Causal Neuro-Symbolic Diagnosis)** is a Python framework for diagnosing rolling-element **bearing faults** from vibration signals. A neural network proposes a diagnosis; then three independent layers check that proposal against the **physics of the signal** and the **causal structure of the machine**, and a consensus layer turns the result into an actionable maintenance decision.
2424

25-
The problem it solves is **operating-condition shift**: a model trained at one load or speed silently loses accuracy at another, and its confidence the usual signal for "can I trust this prediction?" is the first thing to break. CNSD answers a question a plain classifier cannot: *is this predicted fault physically present in the signal, and would it survive a change of operating condition?*
25+
The problem it solves is **operating-condition shift**: a model trained at one load or speed silently loses accuracy at another, and its confidence (the usual signal for "can I trust this prediction?") is the first thing to break. CNSD answers a question a plain classifier cannot: *is this predicted fault physically present in the signal, and would it survive a change of operating condition?*
2626

2727
```python
2828
from cnsd import CNSD, Dataset
@@ -127,7 +127,7 @@ Across three public bearing datasets, we compare reliability estimators at **mat
127127

128128
**Noise robustness.** As additive noise increases, the physics layer catches the ensemble's *confident* errors: **100% at 0 dB on XJTU-SY**, ~40% on the saturated CWRU regime.
129129

130-
> **On the CWRU null.** We report it at equal prominence because it is *evidence*, not a weakness. CNSD's thesis is that mechanistic verification helps where the signal is degraded and the network is unsure and adds nothing where predictions are already reliable. CWRU's cross-load task is comparatively saturated, so the absence of an advantage there is exactly what the mechanism predicts.
130+
> **On the CWRU null.** We report it at equal prominence because it is *evidence*, not a weakness. CNSD's thesis is that mechanistic verification helps where the signal is degraded and the network is unsure and adds nothing where predictions are already reliable. CWRU's cross-load task is comparatively saturated, so the absence of an advantage there is exactly what the mechanism predicts.
131131
132132
---
133133

docs/assets/architecture.png

839 KB
Loading

docs/assets/hero.png

-1.08 KB
Loading

docs/assets/make_readme_assets.py

Lines changed: 0 additions & 320 deletions
This file was deleted.

docs/assets/results.png

-31 Bytes
Loading

0 commit comments

Comments
 (0)