Class in Zendir.Classes | Inherits from UniverseModel

Declaration

class FuelLeakErrorModel;

Description

An error model that simulates fuel leakage at any point in the fuel network. The model tracks cumulative fuel flow through the parent component and computes a degradation level that progressively increases the leak fraction. Leaked fuel is removed from downstream components, creating an observable flow rate discrepancy that operators can use to locate the leak. The leak rate scales with flow, so reducing pump speed is a valid mitigation strategy.


Properties

DeclaredDescription
CumulativeFuelPassedTotal mass of fuel in kilograms that has passed through the component since initialization.Used to compute the degradation level via DegradationRate.
CumulativeLeakedMassTotal mass of fuel in kilograms lost to leakage since initialization.Accumulates each tick as LeakRate * step.
DegradationLevelCurrent degradation level ranging from 0 (new) to 1 (fully degraded).Computed from CumulativeFuelPassed * DegradationRate, capped at 1.0.
DegradationRateThe rate at which degradation accumulates per kilogram of fuel passed through the component.Higher values cause faster wear. For example, a rate of 1e-5 means the degradation levelincreases by 1e-5 for every kilogram of fuel that flows through the component.
ForceFailureWhen true, immediately forces maximum degradation (DegradationLevel = 1.0) regardless ofcumulative fuel passed. Useful for simulating sudden seal failure or testing worst-caseleak scenarios.
LeakCoefficientThe fraction of flow that leaks per unit of degradation level.The effective leak fraction is DegradationLevel * LeakCoefficient, capped at MaxLeakFraction.For example, at degradation 0.5 with coefficient 0.01, the leak fraction is 0.005 (0.5% of flow).
LeakFractionCurrent fraction of the component’s effective flow rate being lost to leakage.Computed as min(DegradationLevel * LeakCoefficient, MaxLeakFraction).
LeakOnsetFlowRateMinimum flow rate [kg/s] before leakage begins. Below this threshold the seal retainsenough contact pressure to contain the fluid even when degraded. A value of 0 (default)means any positive flow can leak. Slowing the pump so the flow is below this rateis a valid mitigation that eliminates leakage entirely.
LeakRateCurrent mass flow rate of fuel being lost through the leak [kg/s].Equals EffectiveFlowRate * LeakFraction when flow is at or above ,otherwise zero. This is the instantaneous leak rate and will vary with pump speed / flow ratethrough the component.
MaxLeakFractionMaximum fraction of flow that can be lost to leakage, preventing total flow loss even atfull degradation. Clamped between 0 and 1. A value of 0.5 means at most 50% of the flowcan leak regardless of degradation level.
InheritedDescription
IsEnabledIs true if the object is currently enabled.
NameThe display name or tag of this object.
ParentThe currently attached parent object.

Methods

InheritedDescription
FindParentWithIDReturns an attached parent that satisfies the specified ID.
FindParentWithTypeReturns an attached parent that satisfies the specified type.
FindRootWithIDReturns a root object that satisfies the specified ID.
FindRootWithTypeReturns a root object that satisfies the specified type.