Documentation

VerifiedMBSE.Matrix.ModelBoundary

Model Boundary: Explicit Declaration of What Is Not Verified #

Formal verification only guarantees properties on the inside of a model. This module treats the outside of the model as a first-class object so that "the V&V matrix is green" is not conflated with "the real system is safe".

A ModelBoundary records:

The intent is epistemic honesty, not bookkeeping. When the system changes, the boundary description should be revisited.

Dependency on VMatrix #

ModelBoundary is parameterized by the VMatrix it describes: ModelBoundary (vm : VMatrix). Accidentally reusing a boundary description for a different system therefore produces a type error. The verifiedCount field is not stored but derived as a function of vm.totalRecords, so it cannot drift out of sync with the matrix.

Because of the VMatrix dependency, this file lives in the Matrix namespace rather than VV.

Category of an unmodeled risk.

  • physical : RiskCategory

    Physical phenomena outside the formal model (single-event upsets from cosmic rays, micrometeoroid impact, material fatigue, ...).

  • environmental : RiskCategory

    Environmental factors (solar activity, thermal extremes, radiation).

  • human : RiskCategory

    Human factors (operator error, procedure misuse, inadequate training).

  • software : RiskCategory

    Software risks outside the verification boundary (COTS, firmware, OS).

  • hardware : RiskCategory

    Hardware risks (manufacturing defects, aging, part substitution).

  • organizational : RiskCategory

    Organizational and process risks (change management, supply chain).

Instances For
    Equations
    • One or more equations did not get rendered due to their size.
    Instances For

      Strength of the evidence supporting a property. Distinguishes proof from test and analysis so that ModelBoundary does not hide the difference.

      • verified : EvidenceKind

        Formal proof in Lean.

      • tested : EvidenceKind

        Supported by a test campaign (unit test, HIL, qualification).

      • analyzed : EvidenceKind

        Supported by an analysis method (FMEA, FTA, Monte Carlo).

      Instances For
        Equations
        • One or more equations did not get rendered due to their size.
        Instances For

          A risk the formal model does not cover. Requires an explicit rationale and mitigation so the engineer is forced to name and justify the gap.

          • description : String

            Short description of the risk.

          • category : RiskCategory

            Category of the risk.

          • rationale : String

            Rationale for leaving this risk out of the formal model.

          • mitigation : String

            Non-formal mitigation (process, test, redundancy, operational constraint).

          Instances For
            Equations
            • One or more equations did not get rendered due to their size.
            Instances For

              A property supported by test or analysis but not proved formally.

              • description : String

                Description of the property.

              • Kind of non-formal evidence (.tested or .analyzed).

              • source : String

                Reference to the supporting source (report ID, test campaign name, ...).

              Instances For
                Equations
                • One or more equations did not get rendered due to their size.
                Instances For

                  Composite view of what the model covers together with the risks outside it.

                  Parameterizing by the target VMatrix ties the boundary to a specific matrix: accidentally reusing a boundary description for a different system produces a type error. verifiedCount is derived from vm.totalRecords as a function rather than stored, so it cannot drift out of sync.

                  • systemName : String

                    Identifier of this boundary (typically the system name).

                  • Properties supported by test or analysis but not proved.

                  • unmodeled : List UnmodeledRisk

                    Risks deliberately left out of the formal model.

                  Instances For
                    Equations
                    • One or more equations did not get rendered due to their size.
                    Instances For

                      Number of formally verified properties, derived from the total record count of the target VMatrix.

                      Equations
                      Instances For

                        Number of unmodeled risks.

                        Equations
                        Instances For

                          Number of non-formal properties.

                          Equations
                          Instances For

                            Total number of tracked items (verified + non-formal + unmodeled).

                            Equations
                            Instances For

                              Filter unmodeled risks by category.

                              Equations
                              Instances For

                                Render a ModelBoundary as a human-readable summary string.

                                Equations
                                • One or more equations did not get rendered due to their size.
                                Instances For