algorithmic modeling for Rhino

DIVA Daylight
DIVA Thermal
Massing Tools
Solar Tools

Viper: DIVA Thermal Analysis for GH

Component Index > DIVA > DIVA Thermal > Viper: DIVA Thermal Analysis for GH

This component performs a single-zone thermal simulation using EnergyPlus, an open-
source software operated by the US Department of Energy (


1) Create one or a number of breps that collectively form a SINGLE CLOSED volume,
representing the physical boundary of the thermal zone. Note: All breps must be
PLANAR or composed of planar faces.
2) Feed each brep through a 'Construction Assembly' (CA) component, which
you must use to assign materials. Multiple breps of the same construction
can be fed into a single CA component. (We'll deal with windows in step 4). The
CA component can be found in the 'DIVA Thermal' group under the 'DIVA' tab.
3) Connect the output from the CA components into the 'Zone' input parameter of the
Viper component.
4) Create windows as additional breps that are 'on top of' -- i.e., coplanar with --
the zone breps
5) Repeat step (2) for window breps, this time using the 'Window Unit' component and
connecting its output to the 'Window' input of the Viper component
6) Create breps to represent any detached shading surfaces (overhangs, other buildings,
fences, trees, etc.). The reflectance of these surfaces can be set using the
'Fixed Shade' component. Or, the breps can be passed directly to the 'Fixed Shade'
input of the Viper component, in which case a default reflectance of 0.35 will be
7) If you want to save the results of the simulation for later reference, provide
a string to the 'Project_Name' input.
8) Set the occypancy type and weather location by clicking on the 'Program' and
'Location' buttons.
9) Set internal gain densities, thermostat set points, lighting controls, air flow rates,
and other variables as desired. (Hover over the input for details.)
10) To launch simulation, set 'Run' to True


Project NameProject NameProject Name (optional)String
People [/m2]People(Number of people)/m2 (optional)Number
Lights [W/m2]LightsLighting load (W/m2) (optional)Number
Equipment [W/m2]EquipEquipment load (W/m2) (optional)Number
Heating Set Point [deg C]HtgSetPHeating Set Point [deg C] (optional)Number
Cooling Set Point [deg C]ClgSetPCooling Set Point [deg C] (optional)Number
Heating COPHtg COPHeating Efficiency (Coefficient of Performance) (optional)Number
Cooling COPClg COPCooling Efficiency (Coefficient of Performance) (optional)Number
InfiltrationInfiltrationInfiltration Rate (air changes per hour) (optional)Number
FreshAirFreshAirMinimum Outside Air Flow per Person {(m3/s)/person} (optional)Number
Lighting Control [lux]Lighting CntrlSet daylighing control level or schedule (optional) If you enter a number, EnergyPlus will use this number as a dimming control value (one sample node will be automatically placed at the centroid of the floor area, 0.8 meters off the ground). Alternatively, you can output a lighting schedule using the DIVA Daylight component (recommended). First, run a climate-based simulation with the desired lighting control type, and request the 'Lighting Control Schedule Path' output from the Outputs tab of the Daylight-component 'Settings' menu. (This path is the intgain.csv file generated by DIVA.) If the input is left blank, no dimming controls will be used, and Viper will assume a default lighting schedule based on occupancy type.String
Zone BrepsZoneConnect outputs of CA components to this node. Note: Do NOT flatten, graft, or otherwise alter the paths or structure of the data tree.Brep
WindowWindowConnect outputs of WU components (optional) to this node. Note: Do NOT flatten, graft, or otherwise alter the paths or structure of the data tree.Brep
ShadeShadeShading objects (optional). Use the 'Shade' component to assign reflectances, glazing materials, and transmittance schedules to shading objects, then connect output here.String
Write OnlyWrite OnlyWhen 'Write Only' AND 'Run' are True, Viper will write the IDF without launching EnergyPlus. (Useful for creating batches.) (optional)Boolean
Run SimulationRunRun SimulationBoolean


Output MessagemessagesMessages, Warnings, and ErrorsString
Metric Heating EHeating EHeating Energy Consumption (load divided by efficiency) [kWh] (Monthly)Goo
Metric Cooling ECooling ECooling Energy Consumption (load divided by efficiency) [kWh] (Monthly)Goo
Metric Elec:LightsElec:LightsInteriorLights:Electricity [kWh] (Monthly)Goo
Metric Elec:EquipElec:EquipInteriorEquipment:Electricity [kWh] (Monthly)Goo

© 2018   Created by Robin Rodricks and Andrew Heumann.   Hosted by

Badges  |  Report an Issue  |  Terms of Service