Grasshopper Docs

Community documentation for Grasshopper add-ons & plugins

00 | Honeybee
01 | Daylight | Material
02 | Daylight | Light Source
03 | Daylight | Recipes
04 | Daylight | Daylight
05 | Energy | Building Program
06 | Energy | Material | Construction
07 | Energy | Schedule
08 | Energy | Set Zone Properties
09 | Energy | HVACSystems
10 | Energy | Energy
11 | THERM
12 | Developers
13 | WIP

Use this component to assemble an adaptive comfort recipe for the "Honeybee_Annual Indoor Comfort Analysis" component.

Inputs

NameIDDescriptionType
View Factor Mesh_viewFactorMeshThe data tree of view factor meshes that comes out of the "Honeybee_Indoor View Factor Calculator".Goo
View Factor Info_viewFactorInfoThe python list that comes out of the "Honeybee_Indoor View Factor Calculator".Goo
Epw File_epwFileThe epw file that was used to run the EnergyPlus model. This will be used to generate sun vectors and get radiation data for estimating the temperature delta for sun falling on occupants.Goo
==============================...Goo
Srf Indoor Temp_srfIndoorTempA list surfaceIndoorTemp data out of the "Honeybee_Read EP Surface Result" component.Goo
Srf Outdoor TempsrfOutdoorTemp_A list surfaceOutdoorTemp data out of the "Honeybee_Read EP Surface Result" component.Goo
Zone Air Temp_zoneAirTempThe airTemperature output of the "Honeybee_Read EP Result" component.Goo
Zone Rel Humid_zoneRelHumidThe relativeHumidity output of the "Honeybee_Read EP Result" component.Goo
Zone Air Flow Vol_zoneAirFlowVolThe airFlowVolume output of the "Honeybee_Read EP Result" component.Goo
Zone Air Heat Gain_zoneAirHeatGainThe airHeatGainRate output of the "Honeybee_Read EP Result" component.Goo
Metabolic RatemetabolicRate_A number representing the metabolic rate of the human subject in met. If no value is input here, the component will assume a metabolic rate of 1 met, which is the metabolic rate of a seated human being. This input can also accept a list of 8760 metabolic rates to represent how an occuant's metabolic rate might change from hour to hour.Goo
Clothing LevelclothingLevel_A number representing the clothing level of the human subject in clo. If no value is input here, the component will assume a clothing level of 1 clo, which is roughly the insulation provided by a 3-piece suit. A person dressed in shorts and a T-shirt has a clothing level of roughly 0.5 clo and a person in a thick winter jacket can have a clothing level as high as 2 to 4 clo. This input can also accept a list of 8760 clothing levels to represent how an occuant's clothing might change from hour to hour.Goo
==============================Script variable AdaptComfRecipeGoo
Comfort ParcomfortPar_Optional comfort parameters from the "Ladybug_PMV Comfort Parameters" component. Use this to adjust maximum and minimum acceptable humidity ratios. These comfortPar can also change whether comfort is defined by eighty or ninety percent of people comfortable. By default, comfort is defined as 90% of the occupants comfortable and there are no limits on humidity when there is no thermal stress.Goo
Well Mixed Air OverridewellMixedAirOverride_Set to "True" if you know that your building will have a forced air system with diffusers meant to mix the air as well as possilbe. This will prevent the calculation from running the air stratification function and instead assume well mixed conditions. This input can also be a list of 8760 boolean values that represent the hours of the year when a forced air system or ceiling fans are run to mix the air. The default is set to 'False' to run the stratification calculation for every hour of the year, assuming no forced air heating/cooling system.Goo
Inlet Height OverrideinletHeightOverride_An optional list of float values that match the data tree of view factor meshes and represent the height, in meters, from the bottom of the view factor mesh to the window inlet height. This will override the default value used in the air stratification calculation, which sets the inlet height in the bottom half of the average glazing height.Goo
Window Shade TransmisswindowShadeTransmiss_A decimal value between 0 and 1 that represents the transmissivity of the shades on the windows of a zone (1 is no shade and 0 is fully shaded). This input can also be a list of 8760 values between 0 and 1 that represents a list of hourly window shade transmissivities to be applied to all windows of the model. Finally and most importantly, this can be the 'windowTransmissivity' output of the 'Read EP Surface Result' component for an energy model that has been run with window shades. This final option ensures that the energy model and the confort map results are always aligned although it is the most computationally expensive of the options. The default is set to 0, which assumes no additional shading to windows. Goo
Clo AbsorptivitycloAbsorptivity_An optional decimal value between 0 and 1 that represents the fraction of solar radiation absorbed by the human body. The default is set to 0.7 for (average/brown) skin and average clothing. You may want to increase this value for darker skin or darker clothing.Goo
Wind SpeedwindSpeed_A value in m/s to set the wind speed of the comfort calculation. Use this input to account for objects like ceiling fans that might increase the interior wind speed or input custom wind speed values from a CFD simulation. _ This input can also be a list of 8760 additional wind speed values that represent the hours of the year. Alternatively, this input can be a data tree of values with branches that are each 8760 values long and correspond to the branches of the input viewFactorMesh_. This can also be a data tree of values with one branch for each point in the input viewFactorMesh_. Finally, this input can be the file path to a .csv file that is organized with 8760 values in each column and a number of columns that correspond to the number of test points. This last option is recommended if trying to synchronize CFD results with the microclimate maps. _ If no value is input here, the comfort map components will compute a minimum indoor air speed from the zone volume and hourly flow volume and will use the EPW wind speed for outdoor conditions.Goo
Outdoor TerrainoutdoorTerrain_An interger or text string that sets the terrain class associated with the wind speed used in outdoor wind calculations. Interger values represent the following terrain classes: 0 = City: large city centres, 50% of buildings above 21m over a distance of at least 2000m upwind. 1 = Suburban: suburbs, wooded areas. 2 = Country: open, with scattered objects generally less than 10m high. 3 = Water: Flat, unobstructed areas exposed to wind flowing over a large water body (no more than 500m inland).Goo
Northnorth_Input a vector to be used as a true North direction for the comfort analysis or a number between 0 and 360 that represents the degrees off from the y-axis to make North. The default North direction is set to the Y-axis (0 degrees).Goo

Outputs

NameIDDescriptionType
Comf RecipecomfRecipeAn analysis recipe for the "Honeybee_Annual Indoor Comfort Analysis" component.Goo

Video Tutorials

Site design © Robin Rodricks.   Co-created by Andrew Heumann.   Honeybee and associated data © 2020 Ladybug Tools.  
Rhinoceros and Grasshopper are registered trademarks of Robert McNeel & Associates.  Hosted by GitHub

Report an Issue  |  Terms of Service