Grasshopper

algorithmic modeling for Rhino

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

IES Luminaire

Component Index > Honeybee > 02 | Daylight | Light Source > IES Luminaire

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
_iesFilePath_iesFilePathSpecify the file path for .ies photometry file.Goo
_luminaireZone_luminaireZoneList of (3-d coordinate, Aiming Angle) combinations that are generated through the IES Luminaire Array component.Goo
_lightLossFactor__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
_candelaMultiplier__candelaMultiplier_Assign a scaling value for the candela tables. This value gets multiplied by the _lightLossFactor_ value. Default is set to 1.0.Goo
_customLumName__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
customLamp_customLamp_Specify a custom lamp using the IES Custom Lamp componentGoo
----------------------------------------------Script variable Ies2RadGoo
_drawLuminaireWeb__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
_drawLuminaireAxes__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
_drawLuminairePoly__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
extendLumAxesToPt_extendLumAxesToPt_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
_radDir__radDir_Custom location for the luminaire rad file. The default location is inside the Ladybug folder on your system.Goo
_writeRad_writeRadSet to True to create the file for electric lighting simulation.Goo

Outputs

NameIDDescriptionType
luminaireDetailsluminaireDetailsA description of the luminaire generated after parsing the IES file.Goo
luminaireGeoluminaireGeoThe geometry created in the Rhino viewport for visualizing the luminaire. Can be used for generating previews.Goo
luminaireListluminaireListList of luminaires and their locations and mounting angles.Goo
elecLightingDataelecLightingDataDetails about the luminaire, locations and lamps used in the simulation. Connect this output to the _elecLightingData input of the Honeybee_IES Project component.Goo
radFilePathradFilePathLocation 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

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

Badges  |  Report an Issue  |  Terms of Service