Skip to main content

Crate dsfb_turbine

Crate dsfb_turbine 

Source
Expand description

§DSFB Structural Semiotics Engine for Gas Turbine Jet Engine Health Monitoring

A deterministic, read-only, observer-only augmentation layer for typed residual interpretation over existing Engine Health Monitoring (EHM), Gas Path Analysis (GPA), and Prognostics and Health Management (PHM) systems.

§Architectural Contract

  1. Read-only: All input data is accepted as &[f64] immutable slices. No mutable reference to upstream data is ever created.
  2. Non-interfering: No write path, callback, or feedback channel exists from DSFB to any upstream EHM/FADEC/GPA system.
  3. Deterministic: No random seeds, no stochastic sampling, no training-dependent weights. Given identical inputs and configuration, outputs are identical.
  4. no_std / no_alloc: The core module operates without heap allocation, suitable for embedded avionics and safety-critical environments.
  5. no_unsafe: #![forbid(unsafe_code)] is enforced for the library crate.

§Build Boundary

This crate uses the common split architecture:

  • core: no_std, no_alloc, deterministic inference primitives
  • dataset, pipeline, figures, report: std-gated evaluation tooling

§Non-Interference Invariant

If DSFB is removed, the upstream EHM/GPA/FADEC system is unchanged. DSFB does not modify, replace, or interact with any engine control, protection, or estimation logic.

§What DSFB Does NOT Do

  • Does not predict Remaining Useful Life (RUL)
  • Does not modify FADEC, EHM, or GPA systems
  • Does not change thrust management, fuel scheduling, or control loops
  • Does not replace Kalman filters, particle filters, or any estimation pipeline
  • Does not claim superiority over any incumbent method

§What DSFB Does

  • Converts health-parameter residual streams into typed structural episodes
  • Provides deterministic, auditable reason codes for each classification
  • Formalizes regime-conditioned admissibility envelopes
  • Enables early-warning detection of structural degradation trajectory changes
  • Produces audit-ready trace chains from raw residual to typed conclusion

Modules§

core
Core DSFB engine — no_std, no_alloc, no_unsafe.
dataset
Dataset loading for C-MAPSS and N-CMAPSS.
figures
SVG figure generation for DSFB gas turbine evaluation.
pipeline
Full DSFB evaluation pipeline.
report
Report generation — structured text output for evaluation results.

Constants§

NON_INTERFERENCE_CONTRACT
Non-interference contract version.
PAPER_DOI
Paper DOI for reproducibility lock.
VERSION
Crate version for paper-lock and reproducibility.