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

This is the core component for adding photometric data into a lighting simulation.
It parses an IES photometric file to create a geometric representation of the photometric data on the Rhino viewport.
It also calls xform and ies2rad, two programs within RADIANCE, to create a RADIANCE representation of the photometric data.
In case _writeRad is set to True and all the other input requirements are satisfied a .rad file containing photometric information will be created.
This file, accessible through radFilePath should be connected to the additionalRadFiles_ input in the Honeybee Run Daylight Simulation component.
.
.
Technical Notes:
----------------------
The parsing of IES files is based on IES LM-63-2002.
.
This component is only compatible with Type C photometry.
However, if Type B photometry is to be used, external programs such as the Photometric Toolbox can be used to convert Type B photometry to Type C.
.
The luminous shapes, as defined by LM-63-2002 currently compatible with this component are rectangular, circular and rectangular with luminous openings.
.
The curves drawn for creating the luminaire web is not based on interpolation. So it is possible that the curve may look irregular in case the number of vertical angles are less.
.
Suggested practices/workflow:
------------------------------------------
The _writeRad option should only be set to True once the amiming and positioning of luminaires has been confirmed.
.
In case the photometric distribution of the luminaire is not quadrilaterally symmetric, the _drawLuminaireWeb_ option should be set to True.
This will help in aiming and locating the luminaire properly.
.
In case the customLamp_ option is being used, the lumen depreciation factor of the custom lamp should be properly set for illuminance or luminance calculations.

Inputs

NameIDDescriptionType
Ies File Path_iesFilePathSpecify the file path for .ies photometry file.Goo
Luminaire Zone_luminaireZoneList of (3-d coordinate, Aiming Angle) combinations that are generated through the IES Luminaire Array component.Goo
Light Loss Factor_lightLossFactor_An optional number that will be multiplied by the luminosity of the light. This can be used to account for different light bulb luminosities or light loss from additional fixture obstructions around the light. The default is set to 1.0.Goo
Candela Multiplier_candelaMultiplier_Assign a scaling value for the candela tables. This value gets multiplied by the _lightLossFactor_ value. Default is set to 1.0.Goo
Custom Lum Name_customLumName_Specify a custom name for the luminaire. This input should only be used in case the manufacturer hasn't provided a value for [LUMCAT] in the photometric data.Goo
Custom LampcustomLamp_Specify a custom lamp using the IES Custom Lamp componentGoo
----------------------------------------------Script variable Ies2RadGoo
Draw Luminaire Web_drawLuminaireWeb_Draw a geometric representation of the candela distribution of the luminaire on the Rhino viewport. If set to True then geometry normalized to unit dimensions will be drawn. If a number is provided, then geometry will be drawn and scaled to that value.Goo
Draw Luminaire Axes_drawLuminaireAxes_Draw the C0-G0 axes of the luminaire on the Rhino viewport. If set to True then axes normalized to 1.5 times the unit dimensions will be drawn. If a number is provided, then geometry will be drawn and scaled to that value.Goo
Draw Luminaire Poly_drawLuminairePoly_Draw the polygon, circle or box representing the luminous opening of the luminaire on the Rhino viewport. If set to True then geometry normalized to unit dimensions will be drawn. If a number is provided, then geometry will be drawn and scaled to that value.Goo
Extend Lum Axes To PtextendLumAxesToPt_Specify a point to which the luminaire axes should be extended to. Please note that if the aiming of the luminaire is very far way from this point then some abnormal results might be seen.Goo
----------------------------------------------Script variable Ies2RadGoo
Rad Dir_radDir_Custom location for the luminaire rad file. The default location is inside the Ladybug folder on your system.Goo
Write Rad_writeRadSet to True to create the file for electric lighting simulation.Goo

Outputs

NameIDDescriptionType
Luminaire DetailsluminaireDetailsA description of the luminaire generated after parsing the IES file.Goo
Luminaire GeoluminaireGeoThe geometry created in the Rhino viewport for visualizing the luminaire. Can be used for generating previews.Goo
Luminaire ListluminaireListList of luminaires and their locations and mounting angles.Goo
Elec Lighting DataelecLightingDataDetails about the luminaire, locations and lamps used in the simulation. Connect this output to the _elecLightingData input of the Honeybee_IES Project component.Goo
Rad File PathradFilePathLocation of the RAD file that should be included in the project. Connect this output to the _additionalRadFiles_ input in the Honeybee_Run_DaylightSimulation module. This output will soon be deprecated. It is recommended that you use the elecLightingData output instead.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