Class EquipmentFailureMode

java.lang.Object
neqsim.process.equipment.failure.EquipmentFailureMode
All Implemented Interfaces:
Serializable
public class EquipmentFailureMode extends Object implements Serializable
Represents a failure mode for process equipment.

Equipment failure modes define how equipment can fail and the consequences of that failure on process operations. This class supports both complete failures (trips) and degraded operation modes.

Typical Usage: 


EquipmentFailureMode tripMode = EquipmentFailureMode.builder().name("Compressor Trip")
    .type(FailureType.TRIP).capacityFactor(0.0) // Complete loss
    .mttr(24.0) // 24 hours to repair
    .build();

compressor.setFailureMode(tripMode);
Version:
1.0
Author:
NeqSim Development Team
See Also:

  • Field Details

    • serialVersionUID

      private static final long serialVersionUID
      See Also:

    • name

      private final String name
      Name of the failure mode.

    • description

      private final String description
      Description of the failure mode.

    • type

      private final EquipmentFailureMode.FailureType type
      Type of failure.

    • capacityFactor

      private final double capacityFactor
      Capacity factor when failed (0.0 = complete loss, 0.5 = 50% capacity, 1.0 = no effect).

    • efficiencyFactor

      private final double efficiencyFactor
      Efficiency factor when failed (multiplier on normal efficiency).

    • mttr

      private final double mttr
      Mean Time To Repair in hours.

    • failureFrequency

      private final double failureFrequency
      Failure frequency per year.

    • requiresImmediateAction

      private final boolean requiresImmediateAction
      Whether the failure requires immediate plant action.

    • autoRecoverable

      private final boolean autoRecoverable
      Whether the failure can be recovered automatically.

    • autoRecoveryTime

      private final double autoRecoveryTime
      Time in seconds before auto-recovery (if autoRecoverable).

  • Constructor Details

  • Method Details

    • getName

      public String getName()
      Gets the failure mode name.
      Returns:
      the name

    • getDescription

      public String getDescription()
      Gets the failure mode description.
      Returns:
      the description

    • getType

      public EquipmentFailureMode.FailureType getType()
      Gets the failure type.
      Returns:
      the failure type

    • getCapacityFactor

      public double getCapacityFactor()
      Gets the capacity factor (0.0 to 1.0).
      Returns:
      the capacity factor

    • getEfficiencyFactor

      public double getEfficiencyFactor()
      Gets the efficiency factor.
      Returns:
      the efficiency factor

    • getMttr

      public double getMttr()
      Gets the mean time to repair in hours.
      Returns:
      the MTTR

    • getFailureFrequency

      public double getFailureFrequency()
      Gets the failure frequency per year.
      Returns:
      the failure frequency

    • isRequiresImmediateAction

      public boolean isRequiresImmediateAction()
      Checks if immediate action is required.
      Returns:
      true if immediate action needed

    • isAutoRecoverable

      public boolean isAutoRecoverable()
      Checks if failure can auto-recover.
      Returns:
      true if auto-recoverable

    • getAutoRecoveryTime

      public double getAutoRecoveryTime()
      Gets the auto-recovery time in seconds.
      Returns:
      the auto-recovery time

    • isCompleteFailure

      public boolean isCompleteFailure()
      Checks if this is a complete failure (no output).
      Returns:
      true if complete failure

    • getProductionLossFactor

      public double getProductionLossFactor()
      Gets the production loss factor (1.0 - capacityFactor).
      Returns:
      the production loss as a fraction

    • trip

      public static EquipmentFailureMode trip(String equipmentType)
      Creates a standard trip failure mode.
      Parameters:
      equipmentType - type of equipment for MTTR estimation
      Returns:
      trip failure mode

    • degraded

      public static EquipmentFailureMode degraded(double capacityPercent)
      Creates a degraded operation failure mode.
      Parameters:
      capacityPercent - remaining capacity percentage (0-100)
      Returns:
      degraded failure mode

    • bypassed

      public static EquipmentFailureMode bypassed()
      Creates a bypass failure mode.
      Returns:
      bypass failure mode

    • maintenance

      public static EquipmentFailureMode maintenance(double durationHours)
      Creates a maintenance shutdown mode.
      Parameters:
      durationHours - planned maintenance duration
      Returns:
      maintenance failure mode

    • estimateMttr

      private static double estimateMttr(String equipmentType, EquipmentFailureMode.FailureType type)

    • builder

      public static EquipmentFailureMode.Builder builder()
      Creates a new builder.
      Returns:
      new builder instance

    • toString

      public String toString()
      Overrides:
      toString in class Object