Card 9 - CONTROLLER Definition

This card defines a heater or fan controller entity.

KODE, N1, T1, T2, T3

KODE

KODE is the code CONTROLLER (or 140)

N1

N1 is the CONTROLLER card ID.

T1 = NAME

T1 = NAME (or 1) specifies the controller name in T2.

T1 = SENSOR_SELECTION

T1 = SENSOR_SELECTION (or 2) is the element number or group name of the temperature sensor specified in T2. If T2 is a group name, a sensor is placed on all the elements of the group.

T1 = HEATER_SELECTION

T1 = HEATER_SELECTION (or 3) is the element number or group name of the thermostat's heater specified in T2. If T2 is a group name, a heater is placed on all the elements of the group. This option is available only for the HEATER type.

T1 = TYPE

T1 = TYPE (or 4) specifies the controller type in T2.

  • T2 = HEATER: specifies that controller acts as a thermal load.
  • T2 = THERMOSTAT: specifies the thermostat that controls heat input to the elements of the heater. It functions as a binary switch: activates or deactivates the heater based on the sensor temperature.
  • T2 = ACTIVEHEATER: specifies the active heater controller that controls thermal loads based on parameters you define and the temperature of sensor elements. The heater controller can be proportional or PID.
  • T2 = FAN: specifies the active fan controller for the flow boundary conditions. The controller checks the temperature of the sensor each time step and activates the fan when the temperature rises above the cut-in temperature and deactivates it when the temperature falls below the cut-off temperature.
  • T2 = THERMFANCTRL: specifies the controller that is used in flow boundary conditions as a type FAN and a thermal load as THERMOSTAT simultaneously.

T1 = HEAT_DISTRIBUTION

T1 = HEAT_DISTRIBUTION (or 5) specifies the heat input value in T2. This option is available only for the HEATER type.

  • T2 = ABSOLUTE: specifies the heat input value HEAT_MAGNITUDE in T3 for each element.
  • T2 = AREA: specifies the heat input value HEAT_MAGNITUDE*area(HEATER_SELECTION) for each planar, beam, or lump mass element.
  • T2 = VOLUME: specifies the heat input value HEAT_MAGNITUDE*volume(HEATER_SELECTION) for each solid element.
  • T2 = TOTAL: specifies the total heat input HEAT_MAGNITUDE for elements or group in HEATER_SELECTION.

T1 = ACTIVEHEATER_TYPE

T1 = ACTIVEHEATER_TYPE (or 6) specifies the active heater controller type in T2. This option is available only for ACTIVERHEATER.

  • T2 = PROPORTIONAL: thermostat acts as a proportional controller. The heat input Q to the heaters follows the relationship, where QHTR is the heat input to the heaters:
  • T2 = PID: thermostat acts as PID controller defined as a constant value or time-dependent table. The heat input Q to the heaters is computed as follows for 0 ⩽ Q ⩽ QHTR

T1 = SENSOR_METHOD

T1 = SENSOR_METHOD (or 7) specifies the method in T2 how the sensor temperature is computed.

  • T2 = AVERAGE: identifies the arithmetic mean of elemental temperatures within the sensor selection.
  • T2 = MIN: identifies the minimum elemental temperature within the sensor selection.
  • T2 = MAX: identifies the maximum elemental temperature within the sensor selection.

T1 = SET_POINT

T1 = SET_POINT (or 8) specifies the target temperature only for the PID type. This temperature is used to calculate the error e(t)=SET_POINT-T, where T is the temperature of a given element at time t.

  • If the temperature is constant, then its value is specified in T2.
  • If the temperature is table-dependent, then T2 is a table multiplier and T3 has the form Tn, for example, T25 where n is a table number referencing the TABTYPE or FIELDTYPE cards. The dependent variable on the TABTYPE card must be TEMP.

T1 = CUT_IN

T1 = CUT_IN (or 9) is the thermostat's cut-in temperature. This option is available only for THERMOSTAT or proportional type of ACTIVEHEATER.

T1 = CUT_OFF

T1 = CUT_OFF (or 10) is the thermostat's cut-off temperature. This option is available only for THERMOSTAT or proportional type of ACTIVEHEATER.

T1 = HEAT_MAGNITUDE

T1 = HEAT_MAGNITUDE (or 11) specifies the heat input value. This option is available only for the HEATER type

  • If the magnitude is table dependent, then T2 is a table multiplier and T3 has the form Tn, for example, T25 where n is a table number referencing the TABTYPE or FIELDTYPE cards. The dependent variable on the TABTYPE card must be COND.
  • If the magnitude is constant, then its value is specified in T2.
  • If the magnitude is computed using an expression, then T2 is an expression multiplier and T3 has the form En, for example, E25 where n is an expression number referencing the EXPRESSION card.

T1 = GAIN

T1 = GAIN (or 12) specifies the gain parameter for the PID type.

T1 = INTEGRAL

T1 = INTEGRAL (or 13) specifies the integral constant for the PID type.

T1 = DERIVATIVE

T1 = DERIVATIVE (or 14) specifies the derivative constant for the PID type.

T1 = BIAS

T1 = BIAS (or 15) specifies offset for the PID type.

Code example

Example of thermostat


CONTROLLER 1 NAME Thermostat1
CONTROLLER 1 SENSOR_SELECTION Thermo1
CONTROLLER 1 TYPE THERMOSTAT
CONTROLLER 1 CUT_IN  4.000000E+01
CONTROLLER 1 CUT_OFF  5.000000E+01
CONTROLLER 1 SENSOR_METHOD AVERAGE

Example of PID controller


CONTROLLER 1 NAME Active Heater Controller
CONTROLLER 1 SENSOR_SELECTION Active
CONTROLLER 1 TYPE ACTIVEHEATER
CONTROLLER 1 ACTIVEHEATER_TYPE PID
CONTROLLER 1 SET_POINT 1 2.200000E+01
CONTROLLER 1 GAIN  4.000000E+01
CONTROLLER 1 INTEGRAL  5.000000E+01
CONTROLLER 1 DERIVATIVE  1.000000E-03
CONTROLLER 1 BIAS  1.000000E-01
CONTROLLER 1 SENSOR_METHOD AVERAGE