Input Output Reference — EnergyPlus 8.5

<< Prev | Table of Contents | Object Index | Next >>

Input Output Reference

Group - Operational Faults[LINK]

Introduction to Operational Faults Modeling[LINK]

Most of the buildings, either new or old, have operational faults in the sensors, controllers, meters, equipment and systems. Being able to model and simulate these faults and their impact on energy performance of buildings is crucial to improve accuracy of building simulations and to support the retrofit of buildings.

To date, the main practitioner use of EnergyPlus has been for new construction design. With the new high priority attached by USDOE to retrofit and improved operation of existing buildings, there is a need to extend the capabilities of EnergyPlus to model existing buildings, including faulty operation:

  • Retrofit analysis: starts with calibrated simulation; the ability to estimate the severity of common faults is expected to improve the accuracy and transparency of the calibrated model and hence the increase accuracy of the analysis of different retrofit measures.

  • Commissioning providers can use the fault models to demonstrate the saving to be expected from fixing faults found in retro-commissioning

  • Support for building operation by using the calibrated model, including unfixed faults, as a real-time reference model to detect, and verify the diagnosis of, newly occurring faults.

The users in these cases are practitioners, not power users, so it is needed to implement the fault models using conventional EnergyPlus objects rather than the EMS, which, in any case, could only be used to model limited types of faults.

Operational Fault Objects[LINK]

EnergyPlus contains a number of objects to model operational faults of sensors, meters, equipment and systems. The current implementation allows the modeling of the following fault types: (1) sensor faults with air economizers, (2) thermostat/humidistat offset faults, and (3) heating and cooling coil fouling faults.

The objects used by EnergyPlus to model the faults are as follows:

FaultModel:TemperatureSensorOffset:OutdoorAir[LINK]

This object defines the offset of an outdoor air dry-bulb temperature sensor that is used to determine applicability of an air economizer.

Inputs[LINK]

Field: Name[LINK]

This is the user-defined name of the fault.

Field: Availability Schedule Name[LINK]

This field provides the name of a schedule that will determine if this fault is applicable. When a fault is not applicable it is not modeled in the simulations. When it is applicable, then a user-defined sensor offset and a severity schedule will be applied. This schedule should be set to 1.0 when a fault is applicable and 0.0 when it is not. If this field is blank, the schedule has values of 1 for all time periods.

Field: Severity Schedule Name[LINK]

This field provides the name of a schedule that represents severity of a fault. This is used as a multiplier to the user-defined temperature offset. This schedule should be set to a non-zero value when a fault is applicable and 0.0 when it is not. If this field is blank, the schedule has values of 1 for all time periods.

Field: Controller Object Type[LINK]

This field defines the controller object type that this fault is associated with. Choices are from a list of applicable controller types. Current implementation supports air economizer the choice is Controller:OutdoorAir.

Field: Controller Object Name[LINK]

This field defines the name of the controller object associated with the fault. It should be one of the objects with the defined types.

Field: Temperature Sensor Offset[LINK]

This field defines the offset of the temperature sensor. A positive value means the sensor reads a temperature that is higher than the real value. A negative value means the sensor reads a temperature that is lower than the real value. A 0.0 value means no offset. Default is 0.0. The units are in degrees Celsius.

FaultModel:HumiditySensorOffset:OutdoorAir[LINK]

This object defines the offset of an outdoor air humidity sensor that is used to determine applicability of an air economizer.

Inputs[LINK]

Field: Name[LINK]

This is the user-defined name of the fault.

Field: Availability Schedule Name[LINK]

This field provides the name of a schedule that will determine if this fault is applicable. When a fault is not applicable it is not modeled in the simulations. When it is applicable, then a user-defined sensor offset and a severity schedule will be applied. This schedule should be set to 1.0 when a fault is applicable and 0.0 when it is not. If this field is blank, the schedule has values of 1 for all time periods.

Field: Severity Schedule Name[LINK]

This field provides the name of a schedule that represents severity of a fault. This is used as a multiplier to the user-defined temperature offset. This schedule should be set to a non-zero value when a fault is applicable and 0.0 when it is not. If this field is blank, the schedule has values of 1 for all time periods.

Field: Controller Object Type[LINK]

This field defines the controller object type that this fault is associated with. Choices are from a list of applicable controller types. Current implementation supports air economizer the choice is Controller:OutdoorAir.

Field: Controller Object Name[LINK]

This field defines the name of the controller object associated with the fault. It should be one of the objects with the defined types.

Field: Humidity Sensor Offset[LINK]

This field defines the offset of the humidity ratio sensor. A positive value means the sensor reads a humidity ratio that is higher than the real value. A negative value means the sensor reads a humidity ratio that is lower than the real value. A 0.0 value means no offset. Default is 0.0. The units are in kgWater/kgDryAir.

FaultModel:EnthalpySensorOffset:OutdoorAir[LINK]

This object defines the offset of an outdoor enthalpy sensor that is used to determine applicability of an air economizer.

Inputs[LINK]

Field: Name[LINK]

This is the user-defined name of the fault.

Field: Availability Schedule Name[LINK]

This field provides the name of a schedule that will determine if this fault is applicable. When a fault is not applicable it is not modeled in the simulations. When it is applicable, then a user-defined sensor offset and a severity schedule will be applied. This schedule should be set to 1.0 when a fault is applicable and 0.0 when it is not. If this field is blank, the schedule has values of 1 for all time periods.

Field: Severity Schedule Name[LINK]

This field provides the name of a schedule that represents severity of a fault. This is used as a multiplier to the user-defined temperature offset. This schedule should be set to a non-zero value when a fault is applicable and 0.0 when it is not. If this field is blank, the schedule has values of 1 for all time periods.

Field: Controller Object Type[LINK]

This field defines the controller object type that this fault is associated with. Choices are from a list of applicable controller types. Current implementation supports air economizer the choice is Controller:OutdoorAir.

Field: Controller Object Name[LINK]

This field defines the name of the controller object associated with the fault. It should be one of the objects with the defined types.

Field: Enthalpy Sensor Offset[LINK]

This field defines the offset of the enthalpy sensor. A positive value means the sensor reads an enthalpy that is higher than the real value. A negative value means the sensor reads an enthalpy that is lower than the real value. A 0.0 value means no offset. Default is 0.0. The units are in J/kg.

FaultModel:TemperatureSensorOffset:ReturnAir[LINK]

This object defines the offset of a return air dry-bulb temperature sensor that is used to determine applicability of an air economizer.

Inputs[LINK]

Field: Name[LINK]

This is the user-defined name of the fault.

Field: Availability Schedule Name[LINK]

This field provides the name of a schedule that will determine if this fault is applicable. When a fault is not applicable it is not modeled in the simulations. When it is applicable, then a user-defined sensor offset and a severity schedule will be applied. This schedule should be set to 1.0 when a fault is applicable and 0.0 when it is not. If this field is blank, the schedule has values of 1 for all time periods.

Field: Severity Schedule Name[LINK]

This field provides the name of a schedule that represents severity of a fault. This is used as a multiplier to the user-defined temperature offset. This schedule should be set to a non-zero value when a fault is applicable and 0.0 when it is not. If this field is blank, the schedule has values of 1 for all time periods.

Field: Controller Object Type[LINK]

This field defines the controller object type that this fault is associated with. Choices are from a list of applicable controller types. Current implementation supports air economizer the choice is Controller:OutdoorAir.

Field: Controller Object Name[LINK]

This field defines the name of the controller object associated with the fault. It should be one of the objects with the defined types.

Field: Temperature Sensor Offset[LINK]

This field defines the offset of the temperature sensor. A positive value means the sensor reads a temperature that is higher than the real value. A negative value means the sensor reads a temperature that is lower than the real value. A 0.0 value means no offset. Default is 0.0. The units are in degrees Celsius.

FaultModel:EnthalpySensorOffset:ReturnAir[LINK]

This object defines the offset of a return air enthalpy sensor that is used to determine applicability of an air economizer.

Inputs[LINK]

Field: Name[LINK]

This is the user-defined name of the fault.

Field: Availability Schedule Name[LINK]

This field provides the name of a schedule that will determine if this fault is applicable. When a fault is not applicable it is not modeled in the simulations. When it is applicable, then a user-defined sensor offset and a severity schedule will be applied. This schedule should be set to 1.0 when a fault is applicable and 0.0 when it is not. If this field is blank, the schedule has values of 1 for all time periods.

Field: Severity Schedule Name[LINK]

This field provides the name of a schedule that represents severity of a fault. This is used as a multiplier to the user-defined temperature offset. This schedule should be set to a non-zero value when a fault is applicable and 0.0 when it is not. If this field is blank, the schedule has values of 1 for all time periods.

Field: Controller Object Type[LINK]

This field defines the controller object type that this fault is associated with. Choices are from a list of applicable controller types. Current implementation supports air economizer the choice is Controller:OutdoorAir.

Field: Controller Object Name[LINK]

This field defines the name of the controller object associated with the fault. It should be one of the objects with the defined types.

Field: Enthalpy Sensor Offset[LINK]

This field defines the offset of the enthalpy sensor. A positive value means the sensor reads an enthalpy that is higher than the real value. A negative value means the sensor reads an enthalpy that is lower than the real value. A 0.0 value means no offset. Default is 0.0. The units are in J/kg.

FaultModel:Fouling:Coil[LINK]

This object defines the fouling for a simple water cooling coil or simple water heating coil.

Inputs[LINK]

Field: Name[LINK]

This is the user-defined name of the fault.

Field: Coil Name[LINK]

This field defines the name of the simple cooling coil or simple heating coil that has the fouling fault.

Field: Availability Schedule Name[LINK]

This field provides the name of a schedule that will determine if this fault is applicable. When a fault is not applicable it is not modeled in the simulations. When it is applicable, then user-defined fouling and a severity schedule will be applied. This schedule should be set to 1.0 when a fault is applicable and 0.0 when it is not. If this field is blank, the schedule has values of 1 for all time periods

Field: Severity Schedule Name[LINK]

This field provides the name of a schedule that represents severity of a fault. This is used as a multiplier to the user-defined fouling. If this field is blank, the schedule has values of 1 (no changes to fouling) for all time periods.

Field: Fouling Input Method[LINK]

There are two methods to input the fouling, i.e. FouledUARated and FoulingFactor. User chooses the appropriate method to determine the coil fouling.

Field: UAFouled[LINK]

This is the overall coil UA value including the coil fouling when the “FouledUARated” method is used. The unit is W/K.

Field: Water Side Fouling Factor[LINK]

The following four fields specify the required inputs when the “FoulingFactor” method is used. This field defines the fouling factor for the water side. The units are in m2-K/W.

Field: Air Side Fouling Factor[LINK]

This field defines the fouling factor for the air side. The units are in m2-K/W.

Field: Outside Coil Surface Area[LINK]

This field defines outside surface area of the cooling or heating coil. The units are in m2.

Field: Inside to Outside Coil Surface Area Ratio[LINK]

This field specifies the inside to outside surface area ratio of the cooling or heating coil.

IDF examples:

! example faults for an air economizer

  Schedule:Compact,
  OATSeveritySch,                   !- Name
  On/Off,                                   !- Schedule Type Limits Name
  Through: 6/30,                     !- Field 1
  For: AllDays,                       !- Field 2
  Until: 24:00,0,                   !- Field 3
  Through: 12/31,                   !- Field 4
  For: AllDays,                       !- Field 5
  Until: 24:00,1;                   !- Field 6

  FaultModel:TemperatureSensorOffset:OutdoorAir,
  OATFault,                                 !- Name
  ALWAYS_ON,                               !- Availability Schedule Name
  OATSeveritySch,                     !- Severity Schedule Name
  Controller:OutdoorAir,       !- Controller Object Type
  VAV_1_OA_Controller,           !- Controller Object Name
  -2.0;                                           !- Temperature Sensor Offset, deg C

  FaultModel:TemperatureSensorOffset:ReturnAir,
  RATFault,                                 !- Name
  ,                                                 !- Availability Schedule Name
  ,                                                 !- Severity Schedule Name
  Controller:OutdoorAir,       !- Controller Object Type
  VAV_2_OA_Controller,           !- Controller Object Name
  -2.0;                                         !- Temperature Sensor Offset, deg C

  FaultModel:EnthalpySensorOffset:ReturnAir,
  RAHFault,                                 !- Name
  ,                                                 !- Availability Schedule Name
  ,                                                 !- Severity Schedule Name
  Controller:OutdoorAir,       !- Controller Object Type
  VAV_2_OA_Controller,           !- Controller Object Name
  -2000;                                       !- Enthalpy Sensor Offset, J/Kg

  ! example faults for a fouling coil

  FaultModel:Fouling:Coil,
  CoolingCoilFault,               !- Name
  VAV_2_CoolC,                         !- Heating or Cooling Coil Name
  ALWAYS_ON,                             !- Availability Schedule Name
  ,                                               !- Severity Schedule Name
  FouledUARated,                     !- Fouling Input Method
  3000,                                       !- UAFouled, W/K
  ,                                               !- Water Side Fouling Factor, m2-K/W
  ,                                               !- Air Side Fouling Factor, m2-K/W
  ,                                               !- Outside Coil Surface Area, m2
  ;                                               !- Inside to Outside Coil Surface Area Ratio

FaultModel:ThermostatOffset[LINK]

This object defines the offset fault of a thermostat that leads to inappropriate operations of the HVAC system.

Inputs[LINK]

Field: Name[LINK]

This is the user-defined name of the fault.

Field: Thermostat Name[LINK]

This field defines the name of the thermostat object associated with the fault. It should be the name of a ZoneControl:Thermostat object.

Field: Availability Schedule Name[LINK]

This field provides the name of a schedule that will determine whether this fault is applicable or not. When a fault is not applicable it is not modeled in the simulations. When it is applicable, then a user-defined sensor offset and a severity schedule will be applied. This schedule should be set to “1.0” when a fault is applicable and “0.0” when it is not. If this field is blank, the schedule has values of 1.0 for all time periods.

Field: Severity Schedule Name[LINK]

This field provides the name of a schedule that represents severity of a fault. This is used as a multiplier to the reference thermostat offset value. This schedule should be set to a non-zero value when a fault is applicable and “0.0” when it is not. If this field is blank, the schedule has values of 1.0 for all time periods.

Field: Reference Thermostat Offset[LINK]

This field defines the reference offset value of the thermostat. A positive value means the zone air temperature reading is higher than the actual value. A negative value means the reading is lower than the actual value. A “0.0” value means no offset. Default is 2.0. The units are in degrees Celsius.

FaultModel:HumidistatOffset[LINK]

This object defines the offset fault of a humidistat that leads to inappropriate operations of the HVAC system.

Inputs[LINK]

Field: Name[LINK]

This is the user-defined name of the fault.

Field: Humidistat Name[LINK]

This field defines the name of the humidistat object associated with the fault. It should be the name of a ZoneControl:Humidistat object.

Field: Humidistat Offset Type[LINK]

This choice field determines the humidistat offset fault type. Two fault types are available: (1) Type ThermostatOffsetIndependent: humidistat offset is not related with thermostat offset. For this type, user needs to specify the Reference Humidistat Offset, Availability Schedule, and Severity Schedule (2) Type ThermostatOffsetDependent: humidistat offset is caused by thermostat offset fault. For this type, user only needs to specify the Related Thermostat Offset Fault Name.

Field: Availability Schedule Name[LINK]

This field provides the name of a schedule that will determine if this fault is applicable. This field is applicable for the Type ThermostatOffsetIndependent. When a fault is not applicable it is not modeled in the simulations. When it is applicable, then a user-defined sensor offset and a severity schedule will be applied. This schedule should be set to “1.0” when a fault is applicable and “0.0” when it is not. If this field is blank, the schedule has values of 1 for all time periods.

Field: Severity Schedule Name[LINK]

This field provides the name of a schedule that represents severity of a fault. This field is applicable for the Type ThermostatOffsetIndependent. This is used as a multiplier to the reference humidistat offset value. This schedule should be set to a non-zero value when a fault is applicable and “0.0” when it is not. If this field is blank, the schedule has values of 1.0 for all time periods.

Field: Reference Humidistat Offset[LINK]

This field defines the reference offset value of the humidistat. This field is required for the Type ThermostatOffsetIndependent. A positive value means the zone air temperature reading is higher than the actual value. A negative value means the reading is lower than the actual value. A “0.0” value means no offset. Default is 5.0. The units are in percentage.

An example of IDF codes for the thermostat/humidistat offset fault models:[LINK]

FaultModel:ThermostatOffset,
  Ther_Offset_Zone1,   !- Name
  Zone 1 Thermostat,   !- Thermostat Name
  AlwaysOn,            !- Availability Schedule Name
  AlwaysOne,           !- Severity Schedule Name
  2.0;                 !- Reference Thermostat Offset

  FaultModel:HumidistatOffset, 
  Humi_Offset_Zone1,   !- Name
  Zone 1 Humidistat,   !- Humidistat Name
  ThermostatOffsetDependent, !- Humidistat Offset Type
  ,                    !- Availability Schedule Name
  ,                    !- Severity Schedule Name
  ,                    !- Reference Humidistat Offset
  Ther_Offset_Zone1;   !- Related Thermostat Offset Fault Name

  FaultModel:HumidistatOffset, 
  Humi_Offset_Zone2,   !- Name
  Zone 2 Humidistat,   !- Humidistat Name
  ThermostatOffsetIndependent, !- Humidistat Offset Type
  AlwaysOn,            !- Availability Schedule Name
  AlwaysOne,           !- Severity Schedule Name
  10,                  !- Reference Humidistat Offset
  ;                    !- Related Thermostat Offset Fault Name

FaultModel:Fouling:AirFilter[LINK]

This object defines the fault of fouling air filter that leads to inappropriate operations of the corresponding fan.

Inputs[LINK]

Field: Name[LINK]

This is the user-defined name of the fault.

Field: Fan Name[LINK]

This field defines the name of a fan object associated with the fault. It should be the name of a fan object (Fan:ConstantVolume, Fan:OnOff, or Fan:VariableVolume).

Field: Fan Object Type[LINK]

This choice field defines the type of fan. The valid choices are Fan:OnOff, Fan:ConstantVolume, and Fan:VariableVolume. Both cycling and continuous fan operating modes are allowed for Fan:OnOff. Only the continuous fan operating mode is allowed for Fan:ConstantVolume. The variable airflow rate is allowed for Fan:VariableVolume.

Field: Availability Schedule Name[LINK]

This field provides the name of a schedule that will determine if this fault is applicable. This field is applicable for the Type ThermostatOffsetIndependent. When a fault is not applicable it is not modeled in the simulations. When it is applicable, then a user-defined Pressure Fraction Schedule will be applied. This schedule should be set to “1.0” when a fault is applicable and “0.0” when it is not. If this field is blank, the schedule has values of 1.0 for all time periods.

Field: Pressure Fraction Schedule Name[LINK]

This field provides the name of a schedule that describes the pressure rise variations of the fan associated with the fouling air filter. This is used as a multiplier to the fan design pressure rise. Because the fan pressure rise in the faulty case is higher than that in the design case, this schedule should be set to a value that is greater than 1.0 when a fault is applicable. If this field is blank, the schedule has values of 1.0 for all time periods.

Field: Fan Curve Name[LINK]

This field provides the name of a fan curve for the fan associated with the fault. The curve describes the relationship between the fan pressure rise and air flow rate. This is used to estimate the variations of the fan air flow rate in the faulty cases, given the Pressure Rise Variation Schedule. For variable speed fans, the curve should be the one corresponding to the maximum fan speed. The fan curve should cover the design operational point specified in the corresponding fan object. It is also required that the faulty fan operatinal state point falls within the fan selection range that is monotonically decreasing.

An example of IDF codes for the fouling air filter fault models:[LINK]

FaultModel:Fouling:AirFilter,
  DF_VAV_1_Fan,             !- Name
  VAV_1_Fan,                !- Fan Name
  Fan:VariableVolume,       !- Fan Object Type
  ALWAYS_ON,                !- Availability Schedule Name
  Pressure_Inc_Sch,         !- Pressure Fraction Schedule Name
  VAV_1_Fan_Curve;          !- Fan Curve Name

  Schedule:Compact,
  Pressure_Inc_Sch,        !- Name
  Any Number,              !- Schedule Type Limits Name
  Through: 12/31,          !- Field 1
  For: AllDays,            !- Field 2
  Until: 24:00,1.1;        !- Field 3

  Curve:Cubic,        
  VAV_1_Fan_Curve,         ! name     
  1263.1,                  ! Coefficient1 Constant        
  33.773,                  ! Coefficient2 x       
  -5.6906,                  ! Coefficient3 x**2        
  -0.2023,                  ! Coefficient4 x**3        
  4.0,                     ! Minimum Value of x       
  15.0;                    ! Maximum Value of x       

  Fan:VariableVolume,
  VAV_1_Fan,               !- Name
  HVACOperationSchd,       !- Availability Schedule Name
  0.5915,                  !- Fan Total Efficiency
  1109.648,                !- Pressure Rise {Pa}
  7.5202,                  !- Maximum Flow Rate {m3/s}
  FixedFlowRate,           !- Fan Power Minimum Flow Rate Input Method
  ,                        !- Fan Power Minimum Flow Fraction
  0.0000,                  !- Fan Power Minimum Air Flow Rate {m3/s}
  0.91,                    !- Motor Efficiency
  1.0,                     !- Motor In Airstream Fraction
  0.0407598940,            !- Fan Power Coefficient 1
  0.08804497,              !- Fan Power Coefficient 2
  -0.072926120,            !- Fan Power Coefficient 3
  0.9437398230,            !- Fan Power Coefficient 4
  0,                       !- Fan Power Coefficient 5
  VAV_1_HeatC-VAV_1_FanNode,  !- Air Inlet Node Name
  VAV_1 Supply Equipment Outlet Node,  !- Air Outlet Node Name
  Fan Energy;              !- End-Use Subcategory