Question-and-Answer Resource for the Building Energy Modeling Community
Get started with the Help page
Ask Your Question

Add custom fan to VRF terminal with openstudio sdk

asked 2023-03-22 20:48:44 -0500

Kunyu's avatar

updated 2023-03-28 10:17:01 -0500


How do I edit or add a custom fan component to a VRF terminal through openstudio sdk?

I noticed that under "ZoneHVACTerminalUnitVariableRefrigerantFlow", there are member functions "setCoolingCoil" and "setHeatingCoil", which allows me to add my own coils to the terminal. However I don't see any functions for adding a fan.

Only function relevant I found is "supplyAirFan" (to get the fan object).


edit retag flag offensive close merge delete

1 Answer

Sort by ยป oldest newest most voted

answered 2023-03-23 10:16:09 -0500

The fan object is passed as an argument to the ZoneHVACTerminalUnitVariableRefrigerantFlow constructor:

So if you wanted to create a terminal unit with a Fan:SystemModel, you would first create your fan (and coils) and pass them into the constructor for the terminal unit, like:

fan =
ccoil =
hcoil  =
tu = ZoneHVACTerminalUnitVariableRefrigerantFlow(model, ccoil, hcoil, fan)

Also note how the EneryPlus input data dictionary limits the fan types for this terminal (which OpenStudio should enforce):

  A7 ,  \field Supply Air Fan Object Type
        \type choice
        \key Fan:SystemModel
        \key Fan:OnOff
        \key Fan:ConstantVolume
        \key Fan:VariableVolume
        \default Fan:ConstantVolume
        \note Supply Air Fan Object Type must be Fan:SystemModel, Fan:OnOff, or Fan:ConstantVolume
        \note if AirConditioner:VariableRefrigerantFlow is used to model VRF outdoor unit
        \note Supply Air Fan Object Type must be Fan:SystemModel or Fan:VariableVolume if
        \note AirConditioner:VariableRefrigerantFlow:FluidTemperatureControl or
        \note AirConditioner:VariableRefrigerantFlow:FluidTemperatureControl:HR
        \note is used to model VRF outdoor unit
        \note Required for zone equipment. Leave blank if terminal unit is used in AirLoopHVAC:OutdoorAirSystem:EquipmentList.
        \note Also leave blank if terminal unit is used on main AirloopHVAC branch and terminal unit has no fan.
edit flag offensive delete link more


I see. Thank you Eric!

Kunyu's avatar Kunyu  ( 2023-03-23 20:14:12 -0500 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer

Training Workshops


Question Tools

1 follower


Asked: 2023-03-22 20:48:44 -0500

Seen: 64 times

Last updated: Mar 24 '23