Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
04edfe6
feat(awb): import and export Isograph Availability Workbench projects
danyill Nov 16, 2026
50379cb
docs(awb): describe Availability Workbench capability and limits in m…
danyill Nov 17, 2026
29adfb7
docs(awb): compare all tutorial examples with Availability Workbench
danyill Nov 17, 2026
0e35c93
docs(awb): keep example validation out of the in-app manual
danyill Nov 17, 2026
989210c
feat(awb): carry PM, spares, resources, phases and labels both ways
danyill Nov 17, 2026
a3ee53f
feat(awb): sidecar, normalization, dry-run and MCP parity
danyill Nov 17, 2026
caf49c2
feat(awb): GUI reduced-model export and final validation notes
danyill Nov 17, 2026
7273d27
feat(awb): approximate dormant failures with inspection detection delay
danyill Nov 19, 2026
b0052ac
feat(awb): use the shortest-life mode for multi-mode Weibull imports
danyill Nov 19, 2026
97e2232
docs(awb): record inspection approximation and shipped-example recheck
danyill Nov 19, 2026
7262846
fix(awb): never let an imported spare pool run dry; fit competing Wei…
danyill Nov 19, 2026
cb9e27a
test(awb): zero-stock spares stay supplied; competing Weibull fit
danyill Nov 19, 2026
94c9dab
fix(awb): imported PM does not wait for pooled spares; restore block …
danyill Nov 19, 2026
c0d115e
docs(awb): shipped-example comparison after the spare and Weibull fixes
danyill Nov 19, 2026
0b85db4
Merge remote-tracking branch 'origin/main' into feat/awb-import-export
danyill Nov 19, 2026
c0326a3
docs(awb): regenerate the manual reference after merging main; spare …
danyill Nov 19, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 15 additions & 9 deletions docs/AWB_FORMAT.md
Original file line number Diff line number Diff line change
Expand Up @@ -187,22 +187,26 @@ the `Id` label.
|---:|---|---|
| 0 | Exponential | `FmMttf` = mean time to failure |
| 1 | Weibull | `FmEta1` = scale, `FmBeta1` = shape, `FmGamma1` = location |
| 2 | Bi-Weibull | three modes; RAPTOR keeps the first |
| 3 | Tri-Weibull | three modes; RAPTOR keeps the first |
| 2 | Bi-Weibull | two competing modes (mode-3 columns are an unused placeholder); RAPTOR moment-matches one Weibull |
| 3 | Tri-Weibull | three competing modes; RAPTOR moment-matches one Weibull |
| 4 | Fixed | `FmMttf` = fixed time |
| 5 | Lognormal | `FmMttf` = mean, `FmStd` = standard deviation |
| 6 | Normal | `FmMttf` = mean, `FmStd` = standard deviation |
| 7 | Buffer | stored capacity; no RAPTOR equivalent |
| 8 | Phased Bi-Weibull | phased; RAPTOR keeps the first mode |
| 9 | Phased Tri-Weibull | phased; RAPTOR keeps the first mode |
| 8 | Phased Bi-Weibull | phased; RAPTOR moment-matches the two modes |
| 9 | Phased Tri-Weibull | phased; RAPTOR moment-matches the three modes |

All times in AWB are **hours**. RAPTOR converts from its model unit with
`raptor/core/units_conv.py` (`days` = 24, `years` = 8760, etc.) and records
the conversion in the summary.

RAPTOR reads the same enum in reverse. A multi-mode or buffer law becomes
its first Weibull mode and is listed under "multi-mode or buffer failure
distribution". A dormant AWB failure (`FmDormant = 1`) becomes a RAPTOR
RAPTOR reads the same enum in reverse. AWB's Weibull modes compete (the
item fails at the first of them), so a bi-/tri-Weibull law becomes one
Weibull with the same mean and coefficient of variation as the competing-risk
life, located at the earliest mode's location. This is an approximation:
failure counts agree, but the hazard shape, and so the effect of PM, is only
close. A buffer law becomes its first mode. Both are listed under
"multi-mode or buffer failure distribution". A dormant AWB failure (`FmDormant = 1`) becomes a RAPTOR
block with no repair. A non-zero start-up failure probability is reported
but cannot be modelled by RAPTOR.

Expand Down Expand Up @@ -286,9 +290,11 @@ AWB field was written; the `.raptor.json` sidecar keeps the RAPTOR copy).
| Feature | Why |
|---|---|
| consequences and cost models | RAPTOR has no financial/safety/environmental consequence model |
| inspection tasks | AWB inspections are not imported as RAPTOR PM |
| inspection tasks | a dormant failure with an enabled inspection uses the expected detection delay; other inspections remain partial |
| extra planned tasks | RAPTOR has one PM per block; extra AWB tasks are not imported |
| two-level spare holdings | AWB level-1 and level-2 stock are summed |
| spare supply chain | AWB level 3 never runs out: every RAPTOR pool emergency-orders after level 1 + 2 + 3 delays, and stocked pools reorder one-for-one after the level 3 + 2 delay |
| level-1 spare logistic delay on stocked spares | the per-draw level-1 delay on a spare taken from stock is not modelled |
| spare repair shop | AWB spare repair/recycling is not imported |
| labour call-out delay | AWB labour logistics delay is not imported |
| phase capacity/load rules | only AWB phase logic/out-of-service rules are imported |
Expand All @@ -300,7 +306,7 @@ AWB field was written; the `.raptor.json` sidecar keeps the RAPTOR copy).
| standby and NOT logic | RAPTOR nodes have no equivalent |
| block consequence links | not imported |
| dormant failures | modelled as never repaired |
| multi-mode/buffer failure laws | only the first Weibull mode is kept |
| multi-mode/buffer failure laws | moment-matched to one Weibull (buffer: first mode) |
| non-maintainable blocks | RAPTOR repair is off |
| start-up failure probability | not modelled by RAPTOR |

Expand Down
58 changes: 58 additions & 0 deletions docs/AWB_VALIDATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,6 +140,64 @@ losses: capacity is preserved in the sidecar, and the repair law is
mean-matched for AWB. AWB demonstration mode may still refuse to analyse a
project of this size; that is its object limit, not a file-format failure.

### Shipped AWB examples

Stored AWB results vs RAPTOR on the imported model (100 trials, AWB's own
count; same lifetime). Measured 2026-11-20 with the junction-node fix from
`main` (#339) applied: without it every AWB fan-out is mis-wired.

| AWB project | AWB Am | RAPTOR A | Result |
|---|---:|---:|---|
| OilAndGasExample | 0.9732 | 0.9747 | agrees (+0.15 pp) |
| SapDemo | 0.6293 | 0.6522 | agrees within the approximations (+2.3 pp) |
| Example1 | 0.0883 | 0.0959 | agrees within the approximations (+0.8 pp) |
| MaximoDemo | 0.6118 | 0.3654 | AWB's stored results look stale (below) |

`ALTExample` and the `PumpExample` library example have no RBD blocks.

Three import defects made Example1/SapDemo/MaximoDemo look "not
comparable" (≈0.5 % available) before this:

* **Spare pools ran dry.** An AWB spare with no stock came in as a RAPTOR
pool with no ordering, so the first demand left the block `Done`
(`No_spares`). AWB level 3 is unlimited; pools now emergency-order after
the level 1+2+3 delay.
* **Planned tasks waited for spares.** AWB's spare logistic delays hold
up corrective actions only; imported PM no longer draws on the pool.
* **Bi-Weibull picked a placeholder mode.** The shortest-η rule included
the unused third-mode columns (8760 h). Multi-mode laws are now
moment-matched to the competing-risk life.

The per-subsystem figures (top-level superblocks, each run on its own) agree
to within about 2 pp for Example1 and SapDemo. The dormant `PO` block,
modelled with the inspection detection-delay approximation, gives 0.682 vs
AWB 0.655 (SapDemo) and 0.183 vs 0.175 (Example1, inspection disabled, never
repaired). RAPTOR's outage counts run lower than AWB's `W` because AWB
counts zero-duration PM/inspection outages that RAPTOR does not.

**MaximoDemo.** Its spares carry level-2/3 delays of 96 h and 480 h, like
Example1's, but AWB's stored per-block spare downtime is only about the
level-1 delay (for example 45 h over 1.5 demands for the drive shaft), and its
subsystem results are almost identical to SapDemo's, which has no level-2/3
delays. RAPTOR's MaximoDemo subsystems instead resemble AWB's own Example1
results (ELEC 0.67 vs 0.73, MON 0.80 vs 0.80). The stored results were most
likely computed before those delays were entered. This has not been checked
by re-running AWB.

---|---:|---:|---|
| OilAndGasExample | 0.973217 | 0.974734 | Δ 0.152 pp; agrees |
| Example1 | 0.088322 | 0.006982 | not comparable |
| SapDemo | 0.629333 | 0.005037 | not comparable |
| MaximoDemo | 0.611809 | 0.005037 | not comparable |

`ALTExample` and the `PumpExample` library example have no RBD blocks.

The new inspection approximation improves the model but does not make
Example1/SapDemo/MaximoDemo comparable: Example1 has its inspection
disabled, while SapDemo/MaximoDemo still lose PM/inspection timing,
multi-mode Weibull shape and topology semantics. OilAndGasExample remains
the clean shipped-AWB comparison.

---

## 2. Compatibility screening of all 27 examples
Expand Down
4 changes: 2 additions & 2 deletions docs/manual.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -1804,8 +1804,8 @@ In short:
|Mission phases |partial: durations and block cut/linked rules |partial: durations and cut/linked rules; node/hierarchy and capacity/load rules are not imported
|Out-of-service states |yes: applied to the AWB copy |yes: AWB global logic state becomes a RAPTOR cut/linked state
|Block dependencies |not exported |partial: AWB state dependencies become 100% idle dependencies
|Preventive maintenance |partial: one planned task per failure model |partial: first enabled planned task; inspections and extra tasks are not imported
|Spare holdings |partial: level-1 stock and lead time |partial: level 1 + 2 become one pool; repair shop is not imported
|Preventive maintenance |partial: one planned task per failure model |partial: first enabled planned task; dormant inspections become a detection delay; other inspections/extra tasks are partial
|Spare holdings |partial: level-1 stock and lead time |partial: level 1 + 2 become one pool that emergency-orders after the level 1 + 2 + 3 delay (AWB never runs out); planned tasks do not wait for spares; repair shop is not imported
|Labour/equipment resources |partial: resource pools and task links |partial: labour/equipment become RAPTOR resources; call-out delay is not imported
|Capacity products and capacity targets |not exported |not imported
|Consequence and cost models |not exported |not imported
Expand Down
4 changes: 2 additions & 2 deletions docs/manual.html
Original file line number Diff line number Diff line change
Expand Up @@ -2685,12 +2685,12 @@ <h3 id="awb-interchange">Availability Workbench interchange</h3>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Preventive maintenance</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">partial: one planned task per failure model</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">partial: first enabled planned task; inspections and extra tasks are not imported</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">partial: first enabled planned task; dormant inspections become a detection delay; other inspections/extra tasks are partial</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Spare holdings</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">partial: level-1 stock and lead time</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">partial: level 1 + 2 become one pool; repair shop is not imported</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">partial: level 1 + 2 become one pool that emergency-orders after the level 1 + 2 + 3 delay (AWB never runs out); planned tasks do not wait for spares; repair shop is not imported</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Labour/equipment resources</p></td>
Expand Down
Loading