We need your help! 🔥
Please consider disabling your ad-blocker to support this website! 🔑
We are a free, community-supported website! 🥰
We only display small unobtrusive ads which help us stay online! 💯
Thank you in advance! ❤️
We are a free, community-supported website! 🥰
We only display small unobtrusive ads which help us stay online! 💯
Thank you in advance! ❤️
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
| Name | ID | Description | Type |
|---|---|---|---|
| Ies File Path | _iesFilePath | Specify the file path for .ies photometry file. | Goo |
| Luminaire Zone | _luminaireZone | List 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 Lamp | customLamp_ | Specify a custom lamp using the IES Custom Lamp component | Goo |
| ----------------------- | ----------------------- | Script variable Ies2Rad | Goo |
| 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 Pt | 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 Ies2Rad | Goo |
| Rad Dir | _radDir_ | Custom location for the luminaire rad file. The default location is inside the Ladybug folder on your system. | Goo |
| Write Rad | _writeRad | Set to True to create the file for electric lighting simulation. | Goo |
Outputs
| Name | ID | Description | Type |
|---|---|---|---|
| Luminaire Details | luminaireDetails | A description of the luminaire generated after parsing the IES file. | Goo |
| Luminaire Geo | luminaireGeo | The geometry created in the Rhino viewport for visualizing the luminaire. Can be used for generating previews. | Goo |
| Luminaire List | luminaireList | List of luminaires and their locations and mounting angles. | Goo |
| Elec Lighting Data | elecLightingData | Details 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 Path | radFilePath | Location 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 |
Site design © Robin Rodricks.
Site co-created by Andrew Heumann.
Honeybee and associated data © 2024 Ladybug Tools.
Rhinoceros and Grasshopper are registered trademarks of Robert McNeel & Associates.
Hosted by GitHub