Question-and-Answer Resource for the Building Energy Modeling Community
 | 1 | initial version |
@drnnjhnsn There isn't a way to manually DaylightingDeviceShelf objects in the SketchUp Plugin or OpenStudio application but there is a surface method applyViewAndDaylightingGlassRatios that takes view and daylight window ratios and constructions, as well as an exterior shading projection factor and and interior shelf projection factor as arguments. In a measure it would look like this.
surface.applyViewAndDaylightingGlassRatios(viewWwrNS_s,daylightWwrS_s,sill,header,shadingProjectionFactor,lightShelfProjectionFactor,viewConstructionSouth.to_ConstructionBase,daylightConstructionSouth.to_ConstructionBase)
It is used in the School and Office AEDG Fenestration and Daylighting Controls Measures on BCL.
Once a DaylightingDeviceShelf has been added by a measure, you can see the interior partition surface that is used as the light shelf in the SketchUp Plugin, and you can the DaylightingDeviceShelf object in the Subsurfaces sub-tab in the OpenStudio application. You can re-assign a different interior partition surface to the light shelf object, or you can manually alter the existing surface or the construction assigned to it.
View of interior partition surface assigned to DaylightingDeviceShelf after running applyViewAndDaylightingGlassRatios
View of OpenStudio application subsurfaces sub-tab after DaylightingDeviceShelf has been added.
As a note, the "Library" has template objects that can be dragged into a model for Shading Controls and Frame and Divider, but not for DaylightingDevice Shelf.
It is a bit in the weeds, but the reason DaylightingDeviceShelf wasn't added to the Library is that the object can't exist without also having a SubSurface, and the SubSurface can't be re-assigned later on. It is possible this functionality could be added on the future, but I'm not aware of any plans. It would be pretty easy to write a simple measure to use in "Apply Measures Now" that takes a specific sub-surface, or construction, or maybe string search for the sub-surface name, to batch add light shelfs to the model for a subset of existing windows.
