Daylighting Help Guides

Introduction

For a two-minute overview of the software, check out this video:

Tutorial Videos

LightStanza provides tutorial videos containing instructions on basic tasks

 

Support Forums

LightStanza has a community support forum, where users can ask and answer questions.

You can also find information at Unmet Hours, a question-and-answer resource for the building energy and performance modeling community. To ask a new question about LightStanza, click here. To look for existing answers, click here.

 

Reference Guides

You can also visit LightStanza’s website for Daylight Terms & Metrics or the sDA Series for a complete rundown on daylight terms, metrics, and news.

 

Still Have Questions?

If you are unable find the answers you are looking for, feel free to contact us directly.

LightStanza Office: (720) 722-0771 (during business hours M-F 8-5pm MT)
Email: support@lightstanza.com (24 hours, 7 days a week!)

 

Modeling Concepts for LightStanza

This guide is meant to help you organize your 3D models and streamline your workflow to make it easy to work with your product later. In order to ensure an efficient and organized modeling process, you will also need to be familiar with how to build your model flexibly with materials and layers.

We recommend organizing your model by layer or material to allow for more flexibility later in app.lightstanza.com. For example, you will have windows in your project, but they may not all perform the same function. In the illustration below, there is a row of windows with an accompanying row of daylight windows. The bottom windows will be standard, but you want the daylight windows to have a special type of daylight glazing. Putting the daylight windows on their own layer will make it easy to assign each window type its specific properties.

Materials

One way to organize your model is through material assignment. Material assignments should be used when you want to change the lighting characteristics of a polygon. For example, you can change something from glass to opaque or vice versa, convert a polygon to a BSDF file, convert to a translucent plastic, etc.

Each part of the model that will have different light behavior should be a unique material. Initial settings are taken into account during the upload process (materials with less than 100% opacity are assumed to be glass), but it does not matter which material you assign when you are working in SketchUp since everything can and should be changed later on LightStanza.com. See the illustrations below for details.

* Note on SketchUp Textures: LightStanza initially analyzes materials based on RGB values and opacity. SketchUp Textures are not supported by LightStanza since they are not physically accurate descriptions of materials (like .bsdf files are). If you have SketchUp Textures in your model, be sure to assign a different material either in SketchUp or on app.lightstanza.com.

If you are using Revit, your glass and opaque materials will go through a conversion when uploaded to LightStanza. Below are the conversion formats for the two material types:

  • Glass Materials:
    LightStanza reads the red, green, and blue transmission values (tr, tg, tb) directly from the Revit material, and converts them to a simple VT value (note that the tr, tg, and tb values are passed directly to Radiance):
    T = tr * 0.2126 + tg * 0.7152 + tb * 0.0722
    VT = (100 * 0.5 * (-√(2.45 × 10104 * T2) + 6.57 × 1097) – 1.57 × 1052 * T) / (3.10 × 1049 * T2 – 1.71 × 1052)
  • Opaque Materials:
    LightStanza reads the red, green, and blue reflectance values (R, G, B) directly from the Revit material, and converts them to a simple, combined reflectance value:
    Reflectance = 100 * (R * 0.2126 + G * 0.7152 + B * 0.0722)
 
 

Layers

Another strategy you should use for model organization is layers. Layers should be used to organize and control geometry. Things like furniture, window blinds, and overhangs will typically be on their own layers. When furniture is all on a separate “Furniture” layer, you can turn the layer on and off on app.lightstanza.com. This is useful because it is interesting to see the furniture in renderings, but it should be turned off if you are only interested in getting quick quantitative results.

* In SketchUp, if you have any “components” in your model, you must “explode” them before saving your model in order for layers to be assigned correctly after uploading your model to LightStanza.

* Please note, layers are created as “layers” in SketchUp, “categories” in Revit, and “layers” in Rhino (Rhino layers are also imported to LightStanza as materials). More information on layers in Rhino coming soon.

Layers and Materials, Illustrated

The next three illustrations show how to use layers and materials.

Elevation A Shows a set of daylight windows with daylight film and a set of view windows. In this elevation we see three unique materials. The facade is assigned material “Wall”, the windows with daylight film are assigned material “Daylight Window”, and the view windows are assigned material “View Window”. Name the materials something that you can easily identify on LightStanza.com when you assign them specific properties.

Elevation A

In Elevation B we see two layers and two materials. The facade and windows represent Layer 1, and the overhang is Layer 2. The facade and overhang are the material “wall” and the windows are material “View Window”. The overhang should be modeled on its own layer, which can be turned on or off on LightStanza.com. That way, you will be able to see how the room is lit with and without the overhang and assess its effectiveness. You can also add other overhang layers to account for vertical fins and turn them on individually or in conjunction with the horizontal overhang layer.


Elevation B

In Elevation C there are two layers and three materials. There is one set of daylight windows with daylight film and an overhang. The two sets of windows will have different material properties assigned to them.


Elevation C

You can also assign material properties to the glazing and blinds or shades, as well as define the covering (blind/shade) behavior after you upload your model to app.lightstanza.com.

 
 

Modeling the Ground Plane

It is essential to always model your ground plane. Without modeling a ground plane, your simulations will not accurately depict light bouncing from the ground into your space. Below are ground plane guidelines to follow.

 
 

Wall Thickness and Detail

The thickness of walls in buildings affects the way light enters the space. For accuracy in light analysis as required by LEED and WELL standards, construct your SketchUp model with accurate wall thickness, but windows as only a single pane. You will assign all complex lighting functions and characteristics for the window on LightStanza.com. Multi-plane glass, blinds, and daylight film are all examples of complex lighting functions that you will assign on LightStanza.com. For example, even if the window will be triple-pane glass, model it in SketchUp as single plane.

  SketchUp Model   Rendered Model (by LightStanza)
Modeling wall thickness and other fenestration details like mullions increase realism in images and accuracy in calculations. Note the two different glass materials in the SketchUp model allow for flexible and independent assignment of the daylight and view window properties.

This is an example of how details like wall thickness have significant impacts on daylight quality.
 
 

Model Units/Scale

Make sure to double check the units (e.g. sizes/lengths) within your model before uploading. This will ensure that the model is scaled correctly. If the model is not scaled properly in your modeling software (i.e. too big/small), daylighting results may be incorrect.

 

Floors

Floors in LightStanza are for display purposes only and do not impact simulation results. They are intended merely as a convenience for organizing and viewing data. Floors are generated automatically and currently cannot be changed after they are created. Please note that the floor assignments when viewing grids in the Illuminance Grids Panel and when viewing simulation results may not always correspond exactly.

The floors displayed in the Illuminance Grids panel are assigned based on grid height and take both user-defined and automatically-generated grids into account. Grids are sorted by height, and the lowest grid is assigned to Floor 1. The next-highest grid is then checked, and if its height is within 1m of the first grid on Floor 1, this grid is also assigned to Floor 1. Otherwise, a new floor (Floor 2) is created to which the grid is assigned. This process is repeated until all grids have been assigned to a floor.

The floors displayed on a simulation report only take grids that are active for that simulation into account. During simulation, groups of coplanar grids are created and then sorted by the height of the center point of the group to create floors. If grids are coplanar but point in opposite directions (e.g. some face upward while others face downward), they will be assigned to separate floors. Grids that are not horizontal (e.g. grids measuring vertical illuminance on a wall) will be assigned to floors named e.g. “Section 1”, “Section 2”, etc.

 

Preparing your Model for Generating Results in LightStanza

 

This section will teach you how to use your 3D modeling tool to prepare for generating results in LightStanza. Then it will explain how to kick off simulations from the activity bar using the left toolbar simulation settings.

 

Current Caveats of Different 3D Modeling Software

  1. To ensure model translation accuracy, uploading Revit and SketchUp files requires the use of our free LightStanza Plugins. For SketchUp models, you can also first export in Collada format and then drag-and-drop into LightStanza.
  2. There are different steps for manually uploading illuminance grids from SketchUp, Revit, and Rhino. To learn these different workflows, visit the Create an Illuminance Grid section below.
  3. There are different steps for uploading windows from SketchUp, Revit, and Rhino. To learn these different workflows, visit the Create Windows section below.
  4. LightStanza does not support different materials applied to the front and back sides of SketchUp objects. For best performance, apply the same material to both sides of an object.
  5. Rhino materials are not uploaded to LightStanza. Instead, materials are differentiated display color or layer name. Glass materials have a blue display color (or be on a layer with “glass”, “window” or “glazing” in the name), and opaque materials may be any other color. For more details see 4.iii.c.
  6. LightStanza does not currently support importing textures from external modeling software. Materials with textures applied will have these textures removed when importing into LightStanza.
 

How to Create an Illuminance Grid
An Illuminance Grid is a planar system of points that collects light for analysis in your model. These can be horizontal or vertical. To create an Illuminance Grid in your modeling program, you can name a material “LSGrid” (SketchUp), use the LightStanza plugin (Revit), or change the color of a material to yellow (Rhino). Below are detailed instructions for each modeling program.

Please note that LightStanza automatically creates Illuminance grids when you upload your 3D model. These will be placed 30 inches (762 mm) above the floor. You still have the option to manually create user-defined illuminance grids, which are helpful for precise separation of spaces and for measuring light vertically.

Above is Illuminance Grid output in the LightStanza 3D viewer. In this section, you will learn how to generate results like these.
 
 

In SketchUp

    1. Draw a polygon where you want your Illuminance Grid to be. A helpful tip is to make a copy of the floor and move it up to workplane height (30″ or 760mm above the floor), or to the height at which you wish to measure light. Illuminance grids can be standard horizontal, vertical, or diagonal.
    2. Choose the planes in your model that you would like to measure daylight on and rename the corresponding material to include the text “LSGrid” (this is not case sensitive).
      * It is recommended that you assign the grid material to both sides of the polygon. Assigning only the back face material will not create an Illuminance Grid in SketchUp if the front face is not also assigned.
      1. For example, if your material is “Office 323” and you rename it to “LSGrid Office 323”, the polygon will be added to your list of grids. Additional text beyond “LSGrid” will be used as its name online, such as naming ‘Office 323’ and ‘Office 345’ the following material names can be used:
        1. LSGrid Office 323
        2. lsGRID Office 345
        3. LSGrid Kitchen

This screenshot shows “LSGrid Workplane” added to a material name in SketchUp 2018 for Windows. After saving this model and uploading it to LightStanza, the polygon with this material will appear in the “Illuminance Grids” panel for you to begin measuring light.

This screenshot shows “LSGrid” added to a material name in SketchUp 2017 for Mac. Both horizontal and vertical polygons will work as illuminance grids with “LSGrid” added to the material name.
  1. Once the desired materials have been renamed, save your model by clicking “save As” > “SketchUp (*.skp)”.
  2. Export your model to LightStanza using the LightStanza Extension. If you are unable to use extensions with your version of SketchUp, first export it as a Collada file (File -> Export -> 3D model) and then drag-and-drop the .dae file or use the “+” button in the top menu.
 

In Revit
There are multiple ways to make illuminance grids in Revit. Each method is broken down below:

 
  1. LightStanza Plugin for Revit allows you to transform your Revit rooms into LightStanza illuminance grids (required for LEED credit). Here’s how to use it:
      1. Download the LightStanza plugin for Revit, and follow the download instructions provided by the Autodesk App Store.
      2. Make Revit rooms that you would like to be tagged as illuminance grids in LightStanza. To learn how to create rooms in Revit, click here.
      3. If your model has any linked files, remove the links or bind them into a single .rvt file in order to avoid errors. To learn how to work with linked files, click here.
      4. Once you have made a room to represent each illuminance grid, make sure you are in the default “{3D}” view.
      5. Make sure your model is in the correct project phase before bringing it into LightStanza. For more information on project phases, click here.
      6. Click the “Export to LightStanza” button on the LightStanza plugin for Revit.
      7. A popup will appear before your model exports, where you can choose export settings.
        1. Automatically remove all furniture from your model: If this is checked, LightStanza will automatically remove furniture from your model that is not necessary for daylight analysis. This will improve the performance of your model during export and inside of LightStanza.
        2. Choose a height for your illuminance grids: Here you can choose between United States and European standards for workplane height, which is the distance your illuminance grids are from the floor.

      8. If any of your rooms do not translate to illuminance grids, you will get a warning message that includes the names of problematic rooms. If you get this warning, you can click “Cancel” to ignore those rooms and export to LightStanza without them, or see the workarounds section.
      9. If your model has linked files, you will get a warning message because LightStanza will only upload what is in the main file, and not what is linked. You will need to remove the links or bind them into a single .rvt file in order to avoid errors. To learn how to work with linked files, click here.
      10. Then you will be required to enter your LightStanza username and password.
      11. When export is complete, your model will automatically open in LightStanza, where you can begin simulating results. Your Revit rooms will automatically be listed as illuminance grids in the left Illuminance Grids panel in LightStanza, where you can turn them on, off, flip them, rename them, and measure annual and point-in-time illuminance from them.
     
  2. Workarounds to the LightStanza Plugin for Revit are listed below:
     
      1. Some Rooms Are Not Converted Into Illuminance Grids: Please note that sometimes special characters (e.g. square brackets) in room names can prevent them from being converted into illuminance grids. If you receive a warning about rooms not being converted properly, but do not see any room names listed, this is likely the case and you should check your room schedule and adjust names as needed.Revit occasionally defines the boundries of rooms in ways that prevent them from being properly converted into illuminance grids. One common case is to have distinct spaces that are part of the same room, as shown below (the highlighted areas show a “single” room):

        In this situation, you should split this space into two rooms (or one, if part of the space Revit defined is not desired). To do this, click on the “Architecture” tab at the top, and find the “Room & Area” section:

        Use the “Room Separator” tool to draw lines that split the main room off from the second piece. If you would also like the separate piece to receive an illuminance grid, you can use the “Tag Room” tool to create another room for it.If there are additional rooms that are not converted to illuminance grids, you may have to create grids for these spaces manually. Once these are defined, you can export with the plugin as usual — grids that are both manually-defined and defined by rooms will be recognized by LightStanza.
     
      1. The Legacy LSGrid Plugin for Revit lets you assign your Revit “rooms” as illuminance grids for use in LightStanza. Here’s how to use it:
        1. Download the LSGrid plugin for Revit, and follow the download instructions provided by the Autodesk App Store.
        2. Make Revit rooms that you would like to tag as illuminance grids for LightStanza. To learn how to create rooms in Revit, click here.
        3. Once you have made a room to represent each illuminance grid, make sure you are in the default “{3D}” view.
        4. Click the “Create Grids” button on the LSGrid plugin. A popup will appear to tell you how many illuminance grids you have created. You can also delete your illuminance grids by clicking the “Delete Grids” button on the LSGrid plugin.

        5. After you have created your illuminance grids, save your model and upload it to a design in LightStanza. Inside of your LightStanza design, your illuminance grids will be listed in the left Illuminance Grids panel. From there, you can turn them on, off, flip them, rename them, and measure annual and point-in-time illuminance from them.
        6. Please be sure to check this list of caveats when using the LSGrid Plugin:
          1. The number of illuminance grids on export should be the same as the number of rooms in your model. If you experience issues with Revit rooms being translated into illuminance grids in LightStanza, please try to manually create illuminance grids in Revit and re-upload your model to LightStanza without the plugin. Click here to learn how.
          2. If you delete a room “tag” it will not make a grid when clicking “Create Grids”
          3. The LSGrid plugin filters out rooms that are under 1 square foot.
          4. When you create a grid with the plugin, it makes an extra plane in the model so you might want to go back and delete it from your Revit model after uploading it to LightStanza.
     
      1. Automatic Full-Floor Grids: LightStanza will automatically generate illuminance grids based on a Revit model’s “Floor” objects. Each floor object will have an illuminance grid placed on top, raised to the workplane height. To upload space-by-space illuminance grids (needed for LEED v4), just separate out the floors in your model into individual spaces (this would result in multiple floors on one level to indicate different spaces).
     
      1. Manual Grids by Color: This is useful when you would like to make vertical illuminance grids and/or as a manual workaround for the LightStanza Plugin for Revit. Here’s how to do it:
        1. Create a new material in Revit by going to the Manage tab, then clicking on Materials.
        2. Next, click the gray circle with a plus on it which is located at the bottom of the materials list and then click “Create New Material”.
        3. Once the material is made, change the “shading” and the “surface pattern” colors to yellow RGB(255,255,0) and then the “surface pattern” to “” on the right panel.
        4. Click on the Appearance tab and change the generic color to yellow as well. Make sure there is no image selected as well.
        5. Rename the new material to “LSGrid” + whatever you want the grid name to be in LightStanza (i.e. “LSGrid Grid 1”) by right clicking it in the “Project Materials” list, and clicking “Rename”. Then click OK.
        6. If you are creating a horizontal grid, create a new “level” by going to an elevation view. For a vertical grid, use the floor plan view where you want to make the grid.
        7. Make sure you are not in Modify mode for this step. Click on a level and then type “cs” for the keyboard shortcut to “create similar” this will create a new level. Set the new level to 30” above the actual floor for workplane measurements.
        8. Next, go to your newly created level by clicking on its floor plan view.
        9. Next, create a new floor or wall by going to the architecture tab and clicking on floor or wall. Under the properties section on the left, click “Edit Type”. This will bring up a new menu.
        10. To create a new type of floor or wall click “duplicate’ and give the object a new name. Click OK.
        11. Now click on “edit” to the right of the structure parameter.
        12. Set the structure of this object/grid to just one layer and set that layer material to the one you created in step 1. Make sure to set the layer to as thin as possible (the minimum thickness in Revit is 31/256″). This will essentially make the object a 2D plane in Revit (0 thickness). Click OK, and then OK again on the Type Properties Menu.
        13. Make sure the type is set to the grid floor that you created in the left properties tab.
        14. Draw the floor (which will upload as your illuminance grid in LightStanza) in any shape you want using the drawing tools. If you would like to separate out your illuminance grids into spaces, draw multiple shapes to represent each of your spaces. When you are done, click the green checkmark.
        15. Next, upload your model to LightStanza. You can either save your model as a .rvt file and upload directly to LightStanza, upload through the LightStanza Plugin for Revit, or upload through the Legacy LSGrid Plugin for Revit.
          * On LightStanza that the object will turn into an illuminance grid and will no longer be the object that it was in Revit so it will not interfere with your lighting calculations.
 

In Rhino

  1. Draw a planar surface where you want your Illuminance Grid to be. A helpful tip is to make a copy of the floor and move it up to workplane height (30″ or 760mm above the floor), or to the height at which you wish to measure light.
    1. Illuminance grids can be standard horizontal, vertical, or diagonal.
  2. Choose the planar surfaces in your model that you would like to measure daylight on and put them on a new layer. Change the color of this new layer to yellow; which is RGB(255,255,0).
  3. Save your model and upload it to a LightStanza design. The illuminance grids you made will appear under User-Defined Grids inside of the Illuminance Grids tab in the left toolbar.



 

How to Create Windows

In SketchUp – Windows are recognized as glass materials (less than 100% Opacity).

In Revit – Windows are recognized as glass materials (less than 100% Opacity).

In Rhino – There are two methods to import objects as windows from Rhino —by layer name or by display color.

The first method is to place all windows in Rhino on a layer named “windows,” “glass,” “glazing”, or “glazing”, or any name that includes these keywords (all case-insensitive). LightStanza will automatically recognize this and create windows accordingly, overriding any display color settings (see below):



The second method is to set the display color of glass objects to a blue hue (red and green components set to 0, blue set to any non-zero value). Note that this is based on the display color, not the material color:

If an objects display color is set to “By layer” and the layer display color is blue, that object will also be recognized as glass.

If you plan on having different materials for different window sets in LightStanza, you can apply different hues of blue (RGB(0,0,1-255)) to different window groups in Rhino. For example, if 20 windows have double pane glass, and 20 windows have dynamic glass, you could apply RGB(0,0,254) to the 20 double pane glass windows, and RGB(0,0,253) to the 20 dynamic glass windows. Once you upload this model to LightStanza, you can change all of your same-colored windows to a new material at once.

Modeling Unit Skylights

In SketchUp – Skylights are recognized as glass materials (less than 100% Opacity).

In Revit – Skylights are recognized as glass materials (less than 100% Opacity).

In Rhino – While skylights are recognized as glass materials in SketchUp and Revit, in Rhino you must set the display colors of the skylights to a shade of opaque blue ((RGB(0,0,1-255)); see above), or include the words “glass”, “window”, or “glazing” in the layer name in order for it to be recognized in LightStanza.


When applying materials to your skylights in LightStanza, you can use regular glass or translucent materials, or you can use complex glazing materials (BSDF’s). It is important to remember that Acuity Brands’ complex glazing materials require specific skylight dimensions, which are outlined here: Acuity Brands’ Sunoptics® Signature Series Skylights:

  1. Sunoptics® 4040 Signature Series Double-Glazed Acrylic Prismatic Skylight – 5114” x 5114” openings
  2. Sunoptics® 4040 Signature Series Double-Glazed Polycarbonate Prismatic Skylight – 5114” x 5114” openings
  3. Sunoptics® 4080 Signature Series Double-Glazed Acrylic Prismatic Skylight – 5214” x 10014” openings
  4. Sunoptics® 4080 Signature Series Double-Glazed Polycarbonate Prismatic Skylight – 5214” x 10014” openings
  5. Sunoptics® 5060 Signature Series Double-Glazed Acrylic Prismatic Skylight – 6358” x 6358” openings
  6. Sunoptics® 5060 Signature Series Double-Glazed Polycarbonate Prismatic Skylight – 6358” x 6358” openings

Modeling SageGlass

The SageGlass product implemented in LightStanza is typically (but doesn’t have to be!) used in a multi-zone configuration, separated into multiple horizontal zones that can be independently tinted.  

To utilize multi-zone tinting, in your 3D modeling software split your facades into distinct panes of glass (rather than one solid piece) so that LightStanza knows where you would like transitions between tint zones to occur. 

SageGlass typically defines three zones using the following criteria:

Lower Zone: The top of the pane/zone is less than or equal to 2.5 feet from the floor
Upper Zone: The bottom of the pane/zone is greater than or equal to 6 feet from the floor
Middle Zone: Any pane not meeting the criteria for upper or lower zones.
Once your model is loaded into LightStanza, you are ready to apply SageGlass to your design.

  • Click on the material panel in the left-hand toolbar
  • Click on the product library tab
  • Select “SageGlass”
  • To have LightStanza automatically classify your windows into zones, select “Automatic Zones” (recommended). This will add SageGlass to the list of materials to be used in this design.
    • Advanced users may classify their zones manually using the three separate materials in the “Advanced” drop-down menu
  • After selecting the material, you will automatically be placed in “paint-by-group” mode (note the yellow, active paint bucket icon with a “G” under the SageGlass material ). This mode allows you to paint all windows in a “window group” (automatically assigned using LightStanza’s grouping algorithm on model import) with a single click.  Note that when using SageGlass, all windows in a group *must* be the same SageGlass material.
  • Using your mouse cursor (now a paint bucket icon), click on the group you would like to assign as SageGlass.

    • Advanced option: To change all windows of an initial material to SageGlass, you can first use the “Select All” button (insert icon here) on the original material – this will highlight all windows with that material a pink color. Then click the paint bucket under the SageGlass material, and paint it on any of the selected windows. This will apply SageGlass to all selected windows.

And that’s it! SageGlass provides intelligent, well-tested defaults for all parameters controlling tint states. However, you may also edit these parameters to suit your needs and performance goals. Note that all SageGlass in a design must use the same settings; if you have multiple SageGlass materials in your design, editing one will update any others. To edit the parameters controlling SageGlass tints:

  • Click the “Edit Material” icon () under the SageGlass material.
  • Click the container for one of the algorithm control groups to adjust parameters:
      • Glare Control: This controls where
        Control panel

        LightStanza will test for solar glare and set the SageGlass tint accordingly.

        • Test Points: LightStanza will place glare test-points inside the design at the specified horizontal distance from the facade and height above the floor.  You may specify up to 3 points.
      • Daylight Control: For zones where glare is not a concern, the vertical illuminance immediately exterior to the zone is used to determine the appropriate tint state.
          • Set Points: This single value is scaled automatically into appropriate values for lower, middle, and upper zones. Larger set points mean exterior illuminance values will need to be higher to increase the tint amount.  Vice-versa for lower set points.
        • Heating and Cooling Periods: If this toggle is selected, you can set date ranges that use distinct set points to optimize daylight in conjunction with solar heat gain.
    • Color Rendering: While there are no inputs for these controls, note that in order to provide balanced color within a space, LightStanza and SageGlass will not allow all zones on a facade to be tinted simultaneously (unless the facade only has one zone).  

 

 

Now you are ready to start simulating SageGlass!  Simply kick off any new simulation type in the activity panel on the right, and LightStanza will do the rest! 

If running a point-in-time rendering or an annual grid calculation, you can opt to include a SageGlass tint schedule in your report data.  Simply click the checkbox labeled “Downloadable SageGlass tint schedule in .csv format” in the simulation options dialog.

Settings for running a point-in-time rendering simulation

Once your simulation is finished, open the 2D report (insert clipboard icon here), and click the “Download report data” button at the top-right. This will download a zip file that includes all of your report data and the SageGlass tint schedule for each zone!

 

Modeling Tubular Daylight Devices

Modeling tubular daylight devices (TDDs) for accurate daylighting simulations is a unique, possibly unintuitive process. Here are some general guidlines to keep in mind:

  1. Some modeling software (e.g. Revit) includes pre-built TDD assemblies. We do not recommend using these. While visually appealing, they contain complex geometry that will slow simulations and are not necessary. If they are not set up specifically for simulations they can lead to inaccurate results. See below if your model includes these.
  2. The BSDF files used to simulate TDDs include information on how light is transmitted through the entire TDD assembly, from the light-collecting dome, through the tube, and out the diffuser. The BSDF material is only applied to the diffuser (see Figure 1) in your model, and LightStanza does the rest. Therefore, the other components of the TDD assembly in your model are actually not important. You can accurately simulate a TDD with just a diffuser below the ceiling in your model.
  3. It is critical that all components of the TDD assembly except the diffuser are opaque, since light does not need to actually transmit through them in simulations. If they are not opaque, extra light will enter your space and interfere with accurate simulation of the TDD.

We recommend modeling your TDDs as simply as you can. Placing a glass rectangle to represent the diffuser slightly below the ceiling, for a closed ceiling with no tube, is sufficient. If the TDD is inserted in an open-ceiling application, then its diffuser should be lowered to the point that it will exist in this application (e.g. this can be several feet). If you would like to include more of the assembly for visualizations, we recommend a simple cylinder representing the tube. See below for guidelines specific to different modeling software.


Figure 1: Apply the BSDF material only to the diffuser, not any other part of the TDD assembly.

In SketchUp

  1. In your 3D model, place the diffusing polygons inside BELOW the ceiling at least 1/2 inch. Make sure that there are no openings on the roof above the TDD polygons so that they are fully excluded from the sun. Please see Figure 1 above. It does not matter what type of material (e.g. transparent, opaque) you assign the the diffusing polygon before importing.
    1. Make sure that the TDD polygons are the dimensions specified by the manufacturer. For Acuity Brands’ Sunoptics® LightFlex™ Tubular Daylighting Systems, please use 24″x24″ openings that are fully excluded from the sun.
  2. After you have saved your model and uploaded it to LightStanza, you can apply TDD materials to your TDD polygons. Click the Materials tab in the left toolbar, then click on either “Product Library” to use one of our manufacturing partners’ TDDs, or click “Uploaded BSDF Library” to upload your own TDD BSDF file. Apply the desired material(s) to the TDD polygons using the paint bucket. Paint ONLY the (outer) diffusing polygon with the TDD material. Only 1 polygon should be painted the TDD material. Please see Figure 1 above.
  3. Do not paint any other part of the TDD, including the inside or outside of its tube, or any part of the collector on the roof. LightStanza applies an accurate BSDF to the diffuser (step 2) only. Please see Figure 1 above.

In Revit

  1. In your 3D model, place the diffusing polygons inside BELOW the ceiling at least 1/2 inch (see below for instructions on modeling TDD diffusers as simple panes). The diffusing polygons must be a transparent material in Revit so that LightStanza recognizes it as glass when importing. Make sure that there are no openings on the roof above the TDD polygons so that they are fully excluded from the sun. Please see Figure 1 above.
    1. Make sure that the TDD polygons are the dimensions specified by the manufacturer. For Acuity Brands’ Sunoptics® LightFlex™ Tubular Daylighting Systems, please use 24″x24″ openings that are fully excluded from the sun.
  2. After you have saved your model and uploaded it to LightStanza, you can apply TDD materials to your TDD polygons. Click the Materials tab in the left toolbar, then click on either “Product Library” to use one of our manufacturing partners’ TDDs, or click “Uploaded BSDF Library” to upload your own TDD BSDF file. Apply the desired material(s) to the TDD polygons using the paint bucket. Paint ONLY the (outer) diffusing polygon with the TDD material. Only 1 polygon should be painted the TDD material. Please see Figure 1 above.
  3. Do not paint any other part of the TDD, including the inside or outside of its tube, or any part of the collector on the roof. LightStanza applies an accurate BSDF to the diffuser (step 2) only. Please see Figure 1 above.

Revit Simple Diffuser Panes
Since the diffuser is the only necessary piece to simulate TDDs, we recommend modeling only the diffuser in Revit for simplicity. Here are the steps to achieve this.

  1. First, create a new material to use for the diffusers. This material must be transparent to be properly modeled by LightStanza. Go to the “Manage” tab, then click on “Materials.” Below the material list on the left, click the “+” button to create a new material. Rename it to something easy to find (e.g. “TDD Diffuser”), and then adjust the “transparency” property to a non-zero value. Keep all other defaults:
  2. Next, create a new level offset from the ceiling by at least 1/2″ where the diffusers will be placed. In the project browser on the left, double click on any of the “Elevations” views. Click on an existing level to select it, and type “cs” (short for “create similar”) to make a new level. Set the level to the desired diffuser height. Here is an example of an existing ceiling level at 10′, with a TDD diffuser level 6″ below:
  3. Now go to your newly created level by double clicking its name in the project browser floor plan views. To create the polygon representing the TDD diffuser, click on the “Architecture” tab at the top of the window, click the dropdown menu for “Component”, then click “Model In-Place”:
  4. You can select a family to associate the new components with (“Windows” is a good default choice, but not required).
  5. Then, click on “Extrusion” to create a new extrusion geometry:
  6. You can now draw the border of the TDD diffuser in the floor plan view, using the desired dimensions (these are typically specified with the BSDF file you are using), and click the green check mark in the top menu to finish the drawing. In the properties box on the left side, change the “Extrusion End” to 0′ 2″ (leave the “Extrusion Start” at 0). Also click the “…” box in the material row, and select the TDD Diffuser material you created in step one:
  7. If necessary, select the extrusion you just created in the floor plan, and copy and paste more diffusers and move them to their desired locations. Then click on the green check mark labeled “Finish Model” in the top toolbar.
  8. That’s it! Now you can export your model to LightStanza, and paint the desired TDD BSDF materials onto the newly-created diffusers.

Revit TDD Assembly Families
If you are using pre-defined Revit families to model your TDDs (not recommended), some editing of the family properties is likely necessary for accurate simulations. In particular, the diffuser must be a glass/transparent material and all other components must be opaque. It is also recommended that you edit the thickness of the diffusing polygon. Follow the steps below to edit a Revit TDD family.

  1. Double-click on any TDD in your model to open the Revit family editor. A 3D representation of the TDD assembly will open in a new tab. Click on any part of the TDD to see its properties in the left panel:
  2. To edit properties of each component of the TDD assembly, you will first need to un-associate the family parameters. First click on the “=” button next to each material in the left panel, then select “none” in the window that opens:
  3. Set each component of the TDD, except for the diffuser, to a material with no transparency. To edit a material, click on the current material in the left panel, and then open the material editor by clicking the “…” button:
    This will open the material editor, where you can select from current materials or create new ones. The key parameter to watch out for is the transparency — the diffuser must have some transparency, and all other parts must have 0 transparency:
  4. You will also need to edit some additional parameters of just the diffuser. Select just the diffuser (not the whole TDD assembly) by zooming in and clicking on its outer edge (see image below). Edit the material of the diffuser here to a transparent one as well, in the same way as described in the previous steps.Generally the diffuser polygon is too thin for LightStanza to import correctly. Adjust the thickness by clicking the down arrow at its center — in our tests, two clicks is usually sufficient:
  5. Finally, you can load your changes into your model by clicking “Load into Project and Close” in the Family Editor section of the top menu:
    You will be given the option to save the changes you made as a new Revit family file. The last step is to overwrite the TDDs currently in your model. Click the second option, to overwrite both the existing family version and its parameter values:
  6. Repeat the steps above for any other TDD families in your model. When you import into LightStanza, you can paint just the diffuser polygons with the TDD BSDF of your choice.

In Rhino

  1. In your 3D model, place the diffusing polygons inside BELOW the ceiling at least 1/2 inch. Make sure that there are no openings on the roof above the TDD polygons so that they are fully excluded from the sun. Please see Figure 1 above.
    1. Model the diffusing polygons so that they will be recognized by lightstanza as glass — see the Rhino windows section above.
    2. Make sure that the TDD polygons are the dimensions specified by the manufacturer. For Acuity Brands’ Sunoptics® LightFlex™ Tubular Daylighting Systems, please use 24″x24″ openings that are fully excluded from the sun.
  2. After you have saved your model and uploaded it to LightStanza, you can apply TDD materials to your TDD polygons. Click the Materials tab in the left toolbar, then click on either “Product Library” to use one of our manufacturing partners’ TDDs, or click “Uploaded BSDF Library” to upload your own TDD BSDF file. Apply the desired material(s) to the TDD polygons using the paint bucket. Paint ONLY the (outer) diffusing polygon with the TDD material. Only 1 polygon should be painted the TDD material. Please see Figure 1 above.
  3. Do not paint any other part of the TDD, including the inside or outside of its tube, or any part of the collector on the roof. LightStanza applies an accurate BSDF to the diffuser (step 2) only. Please see Figure 1 above.
 tallowing 

Using LightStanza on an iPad


If you are using LightStanza on an iPad, make sure to “Request Desktop Site” for easier-to-use 3D controls. You can do this in both Safari and Google Chrome:

  1. Using Safari, hold your finger/cursor down on the “Refresh” button next to the address bar. The option to “Request Desktop Site” will pop up below for you to click on.
  2. Using Google Chrome, click on the top right menu button and select “Request Desktop Site” from the dropdown menu options.

 

 

 

Editing your Model in LightStanza

This section will cover the different elements of the left toolbar in the LightStanza 3D viewer. Making changes in this panel will affect your model settings. Model settings have to do with the physical components of the 3D model.

 

Viewpoints
Viewpoints List – In the Viewpoints tab, there may be a list of viewpoints that were uploaded from your CAD tool. You can also create new viewpoints in LightStanza by navigating the 3D viewer to the desired location and angle and clicking the ‘+’ sign next to Viewpoints. Clicking on the viewpoints in the list will move you to the corresponding camera location and angle in the 3D viewer. These are not necessary to make renderings (renderings can be made in LightStanza from on-the-fly viewpoints. In other words, if you start a new rendering, it basically takes a snapshot at the current location and angle of your 3D viewer).

 

Illuminance Grids
Illuminance Grids List – Your Illuminance Grids tab is split into two sections: User-defined Grids and Automatic Grids. User-defined Grids are a list of illuminance grids that were assigned in your 3D modeling program. To learn how to populate this list, see the Illuminance Grids Section below. Automatic grids are automatically added to your model when you upload it to LightStanza. LightStanza does its best to put these at the workplane on each floor of your model, but if you need space-by-space or custom grid measurements, it is best to create them in your 3D modeling tool (explained in the Illuminance Grids section below). You can do a few things with the grids listed on this panel:

  1. Hovering over individual grids will highlight them in the 3D viewer for reference.
  2. Selecting and deselecting the checkboxes on each illuminance grid will turn them on and off for viewint and for simulations (for example, if you would like to exclude unoccupied spaces from your LEED v4 Daylight Credit Report, deselect those spaces in the Illuminance Grids tab so that they will not be included in the calculation).
  3. Clicking the “Flip Grid” button next to each grid will change the side that light is measure on. Here is how to do this:
    1. First you will need to determine the direction your Illuminance Grids are facing. In the LightStanza 3D viewer, locate the illuminance grids in your model. The orange side of the illuminance grid is the side that will measure light. The black and yellow striped side will not measure light.
    2. If any of your Illuminance Grids are facing the wrong direction (i.e. the orange side of the polygon is not facing the side you want to measure light on), you will need to flip them in LightStanza. To do this, find the grid that needs flipped in the left toolbar Illuminance Grids panel. When hovering over the individual grids, you will see a “Flip Grid” icon. Click this icon and it will change which side of your Illuminance Grid daylight gets measured on.



 

Materials
The Materials panel allows you to edit the materials in your model, along with their properties. This panel is separated into three categories – materials that are in your design, manufactured products (Product Library), and the generic materials.

  1.  

    In Design – This list will show the materials that are in your design. From here, you can edit properties, select all, apply materials in your 3D model using the paint bucket tool, delete unwanted materials from your design, and save materials to your material library.

      1. Edit Properties – You can edit properties of your materials in two different formats – simple or “Radiance Format”. To turn Radiance Format on, click “View” at the top right of the material toolbar, and then click “Radiance Format”. Repeat this step to go back to simple mode. Each mode has different customizable properties.
     
      1. Please note that Dynamic Glass does not have editable properties since it has multiple tint states. Below is a list of these tint states.
      1. 3-tint:
          1. <15,000 lx: 0.6VT
          2. 15,000 lx – 50,000 lx: 0.15VT
          3. >50,000 lx: 0.01VT

      4-tint:

        1. <15,000 lx: 0.58VT
        2. 15,000 lx – 30,000 lx: 0.4VT
        3. 30,000 lx – 50,000 lx: 0.06VT
        4. >50,000 lx: 0.01VT

    * These are the illuminance levels measured at the center of each window group with dynamic glass.

  2.  

    Product Library – This is a list of manufactured products separated by manufacturer name. To use these in your design, click on the desired product and it will be moved into the “In Design” library where you can use the paint bucket to apply it to polygons in your model. Information about modeling skylights can be found here, and information about modeling tubular daylight devices can be found here.

  3.  

    Generic Materials – This is a list of generic materials. To edit or use these in your model, simply click on a material, and it will move into the “In Design” library where you can use the paint bucket to apply it to polygons in your model.

Generating Results in LightStanza

The Activity Bar (on the right side of your design screen) is where new activities are started, previous activities are referenced, model edits are listed, and comparison reports are kicked off..

    1. Renderings/Animations – These come in the form of individual point-in-time renderings and animations. To play a rendering animation, click the Play button in the top menu.
      1. Camera Tools – You can customize the way you view your renderings in the 3D viewer with Camera Tools.
        1. Exposure – You can manually adjust the exposure of your renderings in order to increase or decrease the amount of light per unit area. LightStanza uses Reinhard tone mapping for adjusting exposure.
        2. Contrast – Adjusting the contrast of your image will increase or decrease the difference between light and dark in your renderings.
        3. False Color – In the 3D viewer, you have the option to view your renderings in False Color mode for a more quantitative view of your images.
          1. Luminance Bounds – Changing your luminance sets what luminance values each color in your image represents. Adjust this to focus on very bright or very dark areas.
          2. Log Scale – Adjusting your log scale sets scaling of your false color heat map.
        4. Contour Lines – This is another way to look at your false color rendering. Contour lines trace the different luminance thresholds in your rendering, using the false color legend.
          1. Line Spacing – Changing your line spacing sets the density of the contour lines in your image.
      2. Daylight Glare Probability scores will appear in the top bar with your hemispheric lens renderings. Daylight Glare Probability (DGP) is the “percentage of people disturbed” due to the level of vertical eye illuminance at the viewpoint being simulated. These are some guidelines to follow when analyzing DGP values:
        1. 0-35% Imperceptible, 35-40% Perceptible, 40-45% Disturbing, 45-100% Intolerable
    2. Illuminance Grids – These come in the form of Point-in-time Illuminance Grids and animations. Clicking one of these activity cards will place the results inside of your 3D model.
    3. Annual Illuminance Grids – These come in the form of Annual Sunlight Exposure (ASE), Spatial Daylight Autonomy (sDA), Continuous Daylight Autonomy (cDA), Daylight Autonomy (DA), Useful Daylight Illuminance (UDI), and Average Illuminance. Clicking one of these activity cards will place the results inside of your 3D model.
    4. LEED Scorecard – These come in the form of LEED v4 and LEED 2009 Scorecards. Clicking on one of these activity cards will place select results in the 3D viewer.
      1. Clicking on a LEED v4 Option 1 & 2 Scorecard will automatically place your ASE scores in the 3D viewer. Click “View Report” to see all analysis types (Option 1 ASE & sDA; Option 2 9am & 3pm).
      2. Clicking on a LEED v4 Option 1 will automatically place your ASE scores in the 3D viewer. Click “View Report” to see all analysis types (Option 1 ASE & sDA).
      3. Clicking on a LEED v4 Option 2 Scorecard will automatically place your 9am scores in the 3D viewer. Click “View Report” to see all analysis types (Option 2 9am & 3pm).
      4. Clicking on LEED 2009 Scorecard will automatically place your September 21st 9am scores in the 3D viewer. Click “View Report” to see all analysis types (September 21st 9am & 3pm).
  1. Viewing model edits – By clicking the “Show model edits” button at the top of the Activity Bar, you can see any edits you’ve made to your model in the left toolbar. You can also revert to previous model states using the revert button on a history card, and you can save any state of your design to a new design using the save button on a history card.
  2. Starting a comparison – By clicking the “Compare activities” button at the top of the Activity Bar, you can compare two different simulations at once by selecting two activities from the list of simulations below.Starting a new activity – At the top of the Activity Bar, there is a “New” dropdown menu with the following options:
      1. Rendering/Animation – Renderings can be made on the fly or from your list of viewpoints in the left Viewpoints panel. To make renderings on the fly, simply move your 3D viewer screen to the angle and location that you want, and when you start a new rendering it will make an image at that exact spot. After clicking “Rendering/Animation” in the dropdown menu, you will be presented with a new set of simulation options:
        1. Date and Time – Renderings will be created at each combination of the hours, months, and days selected here:
          1. Switch between measuring a single point-in-time or multiple by checking the “Multiple Times” box at the top of the “Date and Time” dropdown settings.
          2. Use the bar slider to select the time(s) that will be calculated during the render. You have the option to select single or multiple months/days to test during your render.
          3. You also have the option to use Preset Date options: 1, 3, 4, 12. These Presets will choose either the month(s) of September, June/September/December, March/June/September/December, or all 12 Months. When using the preset options for Date and Time, you still have full control of the days within these months to test.
        2. Sky Conditions – You can choose between 3 different sky types:
          1. Clear uses a sky without clouds.
          2. Climate uses weather data dependent on your settings in the “site” tab on the left-hand side of the 3D viewer.
          3. Overcast uses a sky with full cloud coverage.
        3. Use Blinds – Selecting “Use Blinds” means that you would like to see blinds operating in your rendering images. You can set more advanced blind settings/options in the blinds tab in the left Model Settings toolbar.
        4. Simulation Quality depends on a list of Radiance settings. These settings will be shown as a tooltip next to the Simulation Quality setting header.
          1. “Draft” quality is good for faster simulation in early design stages
          2. “High” and “Very High” quality renderings will be more accurate for things like reports.
          3. You also have the option to set “Custom” quality settings. Simply click “Show Quality Details” and edit your Radiance parameters directly. You can hide these details by clicking “Hide Quality Details.” To go back to a default quality setting, click between “Draft,” “High,” or “Very High” from the “Quality” list. For more information on these details, visit Rendering Options (outdated Version 2.4) and Rpict documentation.
        5. Camera Settings – Adjust Camera settings to determine quality of renderings.
          1. Lens
            1. Perspective lens – Renderings that resemble the way the human eye would see a space.
            2. Hemispheric lens – Renderings with a wide angle (similar to a fisheye lens). Hemispheric lenses are recommended for viewing accurate Daylight Glare Probability scores, and will automatically display your DGP score on the top toolbar in the 3D viewer.
            3. Cylindrical lens – Renderings with a panoramic look.
          2. Field of View – Adjusting field of view will change X and Y lens angles. Different lenses (above) will have different default angles. The maximun value for X or Y is 180 degrees for hemispheric and cylindrical lenses, and 175 degrees for perspective lenses.
          3. Super Sampling – Super Sampling has to do with the original size of your renderings before scaling to your target resolution. The larger this percentage, the crisper your images will be. For speed, please choose smaller percentages.
          4. Resolution changes the quality, in pixels, of your rendering.
            These images show the differences that a viewpoint’s settings can make for overall quality and accuracy. On the left is a rendering simulated at Draft quality with 1 ambient bounce, 100% super sampling, and 512x512px resolution. In comparison, the image on the right was simulated at Very High quality, 7 ambient bounces, 500% super sampling, and 4000x4000px resolution.
          5. Section Cut – By simulating with a section cut, you can cut into your 3D model to easily view daylight performance in your building. Although walls will appear to be missing, lighting levels will stay the same as if there was no section cut. You have the option to adjust Fore and Aft section cut distances; Fore is the near plane and Aft is the far plane in your section cut. An Aft plane can cut out the bright light of the sky or ground.
          6. Analysis Viewpoint – Choose which viewpoints to analyze during the rendering.
            1. Current – This is render an analysis in the current viewpoint in the 3D model viewer.
            2. All Active – All Active will perform an analysis on all viewpoints that are checked “on” in th eleft panel within the 3D model space.
      2. Grid Illuminance – After clicking “Grid Illuminance” in the “New” dropdown menu, you will be presented with a list of simulation options:
        1. Date and Time – Results will be created at each combination of the hours, months, and days selected here:
          1. Switch between measuring a single point-in-time or multiple by checking the “Multiple Times” box at the top of the “Date and Time” dropdown settings.
          2. Use the bar slider to select the time(s) that will be calculated during the render. You have the option to select single or multiple months/days to test during your render.
          3. You also have the option to use Preset Date options: 1, 3, 4, 12. These Presets will choose either the month(s) of September, June/September/December, March/June/September/December, or all 12 Months. When using the preset options for Date and Time, you still have full control of the days within these months to simulate.
        2. Sky Conditions – You can choose between 3 different sky types:
          1. Clear uses a sky without clouds.
          2. Climate uses weather data dependent on your settings in the “site” tab on the left-hand side of the 3D viewer.
          3. Overcast uses a sky with full cloud coverage.
        3. Use Blinds – Selecting “Use Blinds” means that you would like to see the effect of blinds operating in your results. You can set more advanced blind settings/options in the blinds tab in the left Model Settings toolbar.
        4. Grid Settings
          1. Point Spacing – Point spacing is the density of your illuminance grid points. Smaller grid spacing will give more detail, but take longer to compute.
          2. Scale – You have the option to select one of two scales to measure your illuminance grid.
            1. 0 – 3,000+ lux
            2. 0 – 5,000+ lux
        5. Simulation Quality – Quality depends on a list of radiance settings. These settings will be shown as tooltip text next to the Quality setting header.
          1. “Draft” quality is good for faster simulations in early design stages.
          2. “High” and “Very High” quality illuminance grids will be more accurate for things like reports.
          3. You also have the option to set “Custom” quality settings. Simply click “Show Quality Details” and edit your Radiance parameters directly. You can hide these details by clicking “Hide Quality Details.” To go back to a default quality setting, click between “Draft,” “High,” or “Very High” from the “Quality” list. For more information on these details, visit Rtrace Documentation.

            The images above show the same illuminance grid simulated at draft quality (left), high quality (middle), and very high quality (right). Higher quality results show more light (ambient bounces) entering the space with increased uniformity among grid points.
      3. Annual Grid Illuminance allows you to generate illuminance grids throughout the entire year. Your simulation options include the following:
        1. Metrics – Annual Analysis types (multiple types can be calculated simultaneously):
          1. Annual Sunlight Exposure (ASE)
          2. Spatial Daylight Autonomy (sDA)
          3. Spatial Daylight Saturation (sDS)
          4. Average Illuminance
          5. Continuous Daylight Autonomy (cDA)
          6. Daylight Autonomy (DA)
          7. Useful Daylight Illuminance (UDI)For more information about each type, click here. For more information about Spatial Daylight Autonomy specifically, check out the sDA series.
        2. Period and Occupancy – Period and Occupancy determine the date range over which the simulations will be performed as well as the daily time range for your calculatinos. You can choose to either use a settable daily range (i.e. 8am – 6pm every day), or you can choose “European Standard EN17037”. “European Standard EN17037” uses the 50% of the daylight hours in a year with the highest horizontal illuminance values (base on climate data) for occupancy. Choosing “European Standard EN17037” is required for European Standard EN17037 compliance.
        3. Sky Conditions – You can choose between 3 different sky types:
          1. Climate uses weather data dependent on your settings in the “site” tab on the left-hand side of the 3D viewer.
          2. Clear uses a sky without clouds.
          3. Overcast uses a sky with full cloud coverage.
        4. Use Blinds – Selecting “Use Blinds” means that you would like to see the effect of blinds operating in your results. You can set more advanced blind settings/options in the blinds tab in the left Model Settings toolbar.
        5. Grid Settings – These settings allow you to adjust the setting according to the illuminance grid(s) that are to be measured.
          1. Point Spacing is the density of your illuminance grid points. Smaller point spacing will give more detail, but take longer to compute, and vice versa.
          2. Color Scheme: By default, annual results will have a different color shceme for each metric, typically shades of a single color. If “Heat Map” is selected, all metrics will use a blue-to-red gradient. When time thresholds are used, values below the threshold will appear in grayscale (except for ASE).
        6. Thresholds
          1. Illuminance Target should be adjusted depending on the type of space you are analyzing.
          2. sDA/sDS/UDI Time Threshold represents of the minimum percentage of time your space should meet or exceed the target illuminance (above). THis number should be 50% for LEEDv4 credit.
        7. Simulation Quality depends on a list of radiance settings. These settings will be shown as tooltip text next to the Quality setting header.
          1. “Draft” quality is good for faster simulations in early design stages.
          2. “High” and “Very High” quality illuminance grids will be more accurate for things like reports.
          3. You also have the option to set “Custom” quality settings. Simply click “Show Quality Details” and edit your Radiance parameters directly. You can hide these details by clicking “Hide Quality Details.” To go back to a default quality setting, click between “Draft,” “High,” or “Very High” from the “Quality” list.
        8. Downloadable annual illumination/blinds schedule in csv format. This option allows you to generate downloadable csv files for your annual simulation. Once your simulation is complete, you can access these csv. files by opening the report and clicking the download button. Please note that annual csv. files are very larger
      4. Glare Analysis – After selecting “Glare Analysis” in the “New” dropdown menu, you will be presented with 3 different glare analysis types, with their associated settings:
        1. DGP Rendering – This option will create a rendering/animation as well as calculate Daylight Glare Probalities
          1. Date and Time – Renderings will be created at each combination of the hours, months, and days selected here:
            1. Switch between measuring a single point-in-time or multiple by checking the “Multiple Times” box at the top of the “Date and Time” dropdown settings.
            2. Use the bar slider to select the time(s) that will be calculated during the render. You have the option to select single or multiple months/days to test during your render.
            3. You also have the option to use Preset Date options: 1, 3, 4, 12. These Presets will choose either the month(s) of September, June/September/December, March/June/September/December, or all 12 Months. When using the preset options for Date and Time, you still have full control of the dates within these months to test.
          2. Sky Conditions – You can choose between 3 different sky types:
            1. Climate uses weather data dependent on your settings in the “site” tab on the left-hand side of the 3D viewer.
            2. Clear uses a sky without clouds.
            3. Overcast uses a sky with full cloud coverage.
          3. Blinds – Selecting “Use Blinds” means that you would like to make blinds operate for your analysis. You can set more advanced blind settings/options in the blinds tab in the left Model Settings toolbar.
          4. Simulation Quality – Quality depends on a list of radiance settings. These settings will be shown as tooltip text next to the Quality setting header.
            1. “Draft” quality is good for faster simulations in early design stages.
            2. “High” and “Very High” quality illuminance grids will be more accurate for things like reports.
            3. You also have the option to set “Custom” quality settings. Simply click “Show Quality Details” and edit your Radiance parameters directly. You can hide these details by clicking “Hide Quality Details.” To go back to a default quality setting, click between “Draft,” “High,” or “Very High” from the “Quality” list.
          5. Camera Settings – These settings allow you to adjust several options for your rendering/animation.
            1. Field of View – Adjusting these settings will change the X and Y lens angles. Both the X and Y default angles are 180.
            2. Super Sampling – Setting this percentage determines the original size before scaling to your target resolution. The larger this percentage, the crispier your images will be.
            3. Resolution – Adjusting the resolution will change the quality, in pixels, of your renderings.
            4. Section Cut – By simulating with a section cut, you can cut into your 3D model to easily view daylight perfomance in your building.
            5. Analysis Viewpoint – The analysis will be performed at the selected viewpoint.
        2. Glare Chart – This simulation will create a chart showing the daylight glare probability at the selected times from the selected analysis viewpoint. This analysis is typically meant to be performed from a viewpoint inside your design.
          1. Period and Occupancy – Adjust dates and time interval of when to run simulation. Choose custom start/end times or use the “Sunrise – Sunset” option. To adjust Day and Hour intervals to measure, change Glare Method from DGPs to DGP.
          2. Glare Method – There are two types of Total Glare analyses:
            1. Daylight Glare Probability (DGP) makes a rendering at every time step and then analyzes that rendering for glare. This takes longer than the Simplified Daylight Glare Probability (DGPs) but will account for more detail.
            2. Simplified Daylight Glare Probability (DGPs) measures vertical illuminance at every time step using annual data, and then estimates glare based on that value. This is significantly faster than DGP, but it is less accurate and not as sensitive to small sources of glare.
          3. Sky Conditions – You can choose between 3 different sky types:
            1. Climate uses weather data dependent on your settings in the “site” tab on the left-hand side of the 3D viewer.
            2. Clear uses a sky without clouds.
            3. Overcast uses a sky with full cloud coverage.
          4. Blinds – Selecting “Use Blinds” means that you would like to see the effect of blinds on your results. You can set more advanced blind settings/options in the blinds tab in the left Model Settings toolbar.
        3. Glare Finder – Glare Finder measures entire spaces in your model for “glare hotspots” using annual calculations and sDGP estimations. Your results will include a rendering filmstrip at the glare hotspot. The filmstrip will show the direction and DGP of the worst glare throughout the most problematic day within the period and occupancy of interest.
          1. Finder Settings – Choose the space (defined by an illuminance grid) to analyze, as well as the height above the floor and the point spacing to search for glare.
          2. Period and Occupancy – Adjust the dates and time intervals to search for glare. Choose custom start/end times or use the “Sunrise – Sunset” option.
          3. Sky Conditions – You can choose between 3 different sky types:
            1. Climate uses weather data dependent on your settings in the “site” tab on the left-hand side of the 3D viewer.
            2. Clear uses a sky without clouds.
            3. Overcast uses a sky with full cloud coverage.
          4. Blinds – Selecting “Use Blinds” means that you would like see the effect of blinds operating in your results. You can set more advanced blind settings/options in the blinds tab in the left Model Settings toolbar.
      5. LEED Scorecard
        1. LEED Scorecard Type
          1. LEED v4 Options 1 & 2 – Lightstanza generates a full LEED v4 NC EQc7 Daylight Credit Report with both Options 1 & 2 for you to choose the option that achieves the most daylight credit points. This scorecard is kept up-to-date with the latest USGBC addendum. When viewing your scorecard, you will have the option to display scores for both v4.0 and v4.1. It is important to utilize the small black info icons (  ) throughout, which give detailed explanations of the different elements of the report when hovering over them. To learn more about the different elements of the LightStanza LEED v4 report card, click here. You can also simulate the two options separately in order to focus on a specific option and save simulation time.
          2. LEED 2009 – This version of LEED is still accepted for specific projects. For more information about the LEED 2009 Daylight Credit, click here. You can also find information about the different LEED daylight credit options at the LightStanza References page.
        2. Grid Settings – Point Spacing is the density of your illuminance grid points. Smaller point spacing will give you more detail, but will take longer to compute. Point spacing that is larger than 2ft is not accepted by the USGBC for LEED credit.
        3. Location: This is where your 3D model is located. You can modify location in the ‘Site’ tab in the left toolbar. You can modify default location in your Account Preferences
        4. Climate Station: This is the weather data that will be used for your simulation. You can modify weather in data in the ‘Site’ tab in the left toolbar.
        5. Downloadable annual illumination/blinds schedule in csv format. This option allows you to generate downloadable csv files for your annual simulation. Once your simulation is complete, you can access these csv files by opening the report and clicking the download button. Please note that annual csv files are very large.
      6. Daylight Factor – Daylight Factor grid point percentages represent the ratio of indoor to outdoor illuminance levels on an overcast day.
        1. Grid Settings – Point spacing is the density of your illuminance grid points. Smaller point spacing will give more detail, but take longer to compute, and vice versa.
        2. Quality depends on a list of radiance settings. These settings will be shown as tooltip text next to the Quality setting header.
          1. “Draft” quality is good for faster simulations in early design stages.
          2. “High” and “Very High” quality illuminance grids will be more accurate for things like reports.
          3. You also have the option to set “Custom” quality settings. Simply click “Show Quality Details” and edit your Radiance parameters directly. You can hide these details by clicking “Hide Quality Details.” To go back to a default quality setting, click between “Draft,” “High,” or “Very High” from the “Quality” list. For more information on these details, visit Rtrace Documentation.
        3. Threshold – Turn “Use DF Threshold” on to enter the target Daylight Factor score for each grid point, and color-code the results to easily see where the target is met.
        4. Location: This is where your 3D model is located. You can modify location in the ‘Site’ tab in the left toolbar. You can modify default location in your Account Preferences
      7. Total Energy Map – A Total Energy Map uses a cumulative (total) sky to generate a false color image that shows how much solar energy falls on your model within a specified period. After clicking “Total Energy Map” in the dropdown menu, you will be presented with a new set of simulation options:
        1. Period and Occupancy – Period is the length of time that the energy map will represent. Adjust the sliders or click on the dates and use the calendar widgets to set the date range you would like your total energy map to represent. Occupancy is the daily time range that your energy map represents.
        2. Sky Conditions – You can choose between 3 different sky types:
          1. Climate uses weather data dependent on your settings in the “site” tab on the left-hand side of the 3D viewer.
          2. Clear uses a sky without clouds.
          3. Overcast uses a sky with full cloud coverage.
        3. Simulation Quality – Quality depends on a list of radiance settings. These settings will be shown as tooltip text next to the Quality setting header.
          1. “Draft” quality is good for faster simulations in early design stages.
          2. “High” and “Very High” quality illuminance grids will be more accurate for things like reports.
          3. You also have the option to set “Custom” quality settings. Simply click “Show Quality Details” and edit your Radiance parameters directly. You can hide these details by clicking “Hide Quality Details.” To go back to a default quality setting, click between “Draft,” “High,” or “Very High” from the “Quality” list. For more information on these details, visit Rtrace Documentation.
        4. Camera Settings
          1. Lens
            1. Perspective lens resembles the way the human eye would see a space.
            2. Hemispheric lens uses a wide angle similar to a fisheye lens.
            3. Cylindrical lens has a panoramic look.
          2. Field of View – Adjusting field of view will change X and Y lens angles. Different lenses (above) will have different default angles. The minimum value for X or Y is 1°. The maximum value for X or Y is 180° for hemispheric and cylindrical lenses, and 175° for perspective lens.
          3. Super Sampling has to do with the original size of your images before scaling to your target resolution. The larger this percentage, the crisper your images will be. For speed, please choose smaller percentages.
          4. Resolution changes the quality, in pixels, of your total energy map.
        5. Advanced Settings – Opaque Glass – By checking “Opaque Glass” you can simulate total energy performance on the exterior side of your model’s windows or any other transparent surface, but you will not be able to measure total energy on the inside of your model. By unchecking “Opaque Glass” you will not be able to see total energy performance on the surface of your windows or glass, but you will be able to measure total energy on the inside of your model.
        6. Analysis Viewpoint is the viewpoint that your total energy map will be generated from. An exterior viewpoint is recommended.
          1. To make an Total Energy Map from your current viewpoint (“Current” from the dropdown list), simply move your 3D viewer screen to the angle and location that you want, and when you start a new simulation it will make an image at that exact spot.
        7. Climate Station: This is the weather data that will be used for your simulation. You can modify weather in data in the ‘Site’ tab in the left toolbar.
        8. Location: This is where your 3D model is located. You can modify location in the ‘Site’ tab in the left toolbar. You can modify default location in your Account Preferences
      8. Navigating Activity Panel Tools – The top of the Activity panel holds several buttons to compare, view, and edit your model.

        1. Compare Activities – This button allows you to compare two seperate 2D reports of simulations that have been run.
        2. Intelligent Perspective/Section Cut – This button will allow you to toggle Smart Camera Position and Smart Section Cut on and off for easily viewing grid-based simulation results within your 3D model.
        3. Revert Model to Previous State – When selecting this button you will be prompted to select a model state to revert to represented by history cards in the Activity Panel. Once you revert to a previous model state, this action cannot be undone.
        4. Make a Copy of Your Design – This button will create a new copy of your model in its current state in the 3D viewer (so if you are viewing a previous state in the model history, the copy will have the properties of that previous state). After selecting this button you will be prompted to name your new design before continuing.
        5. Show/Hide Simulation Results or Model Edits – Here you can show/hide cards in the Activity Panel that represent Simulation Results and/or Model Edits.
        6. Filter Activites – This button will allow you to filter cards in the Activity Panel strictly by the Simulation Type.
      1. Viewing previous activities – Each card in the activity bar is an individual activity. The cards consist of a few basic navigational elements.

Navigating the 3D Viewer

This section will teach you how to navigate the 3D viewer in LightStanza. The controls mentioned here are in the top toolbar. Buttons and references will hide and show depending on the type of data that is showing in the 3D viewer.

 

    1. Go to parent folder – This button will bring you to the folder that contains the design you are in.
    2. Design Name – This is the name of your design, which can be edited when clicking on it.
    3. Download your Model – After uploading your model, a download button will appear. This will allow you to download the model that you originally uploaded to LightStanza as a file on your computer.
    4. Share your design – This button allows you to share your design in the exact state that it is in with team members and non-LightStanza users.
    5. Add a Model – This button allows you to add a model to your design. If there is already a 3D model in your design, this will replace it. You have the option to upload a SketchUp, Revit, or Rhino file. If you do not want to upload your own model, you can choose a sample model from the sample model library.

    1. Viewer Navigation (click to drop down all options)
      1. Orbit – This button will allow you to rotate the 3D canvas around a point.
      2. Pan – This button moves the 3D viewer without any rotation.
      3. Zoom – This button will allow you to zoom in and out on the 3D viewer.
      4. Look Around – In this mode, you can turn the camera at a fixed point.
    2. Zoom to Fit – Pushing this button will bring your model into view and fit it to the screen width.
    3. Look in direction
      1. Look North – Clicking this button will adjust the camera to be looking in the North direction.
      2. Look East – Clicking this button will adjust the camera to be looking in the East direction.
      3. Look South – Clicking this button will adjust the camera to be looking in the South direction.
      4. Look West – Clicking this button will adjust the camera to be looking in the West direction.
      5. Look Up – Clicking this button will adjust the camera to be looking directly up.
      6. Look Down – Clicking this button will adjust the camera to be looking directly down.

    4. Wireframe Mode – When clicking this button, you are able to make all opaque surfaces clear in your 3D model. This allows you to clearly view your results in the 3D viewer without any polygons in the way.
    5. Show/Hide World Elements – Click this button to show/hide elements in the viewer that are not part of the model (the sky, ground, Sun Path, and compass rose). This is particularly useful when taking screenshots for reports and presentations.
    6. Section Cut – By clicking this icon you can cut into your model to view results more easily. When you click the “Section Cut” icon, you can adjust the cut location using the text input box to the right. You can also change where the section cut begins (ground or camera). Ground is the default, but can be changed by selecting ground to the right of the text input box.
    7. Show/Hide Sensors – These two options allow you to turn sensors for dymanic glass and blinds as well as illuminance sensors on/off. The amount of daylight that hits these sensors controls the way the blinds and dynamic glass operate.

    1. Animate Results – Animation controls include play, stop, back, next, and the date/time for reference. These will only appear when an animation is open in the 3D viewer.
    2. Date/Time – When renderings or point-in-time illuminance grids are in the 3D viewer, there should always be a date and time for reference in the top toolbar. This is the date and time that the rendering or illuminance grid data represents. When viewing LEED v4 Option 2 or LEED 2009 results in the 3D viewer, this is section will either say 09:00 AM or 03:00 PM.

    1. Average/Compliance/Annual Score – When Point-in-time Illuminance Grids, Annual Illuminance Grids, or LEED Scorecard results are in the 3D viewer, this section will show a value and a corresponding legend. These numbers represent all of the grids that are currently showing data in the 3D viewer.

  1. Rendering Controls – When opening a rendering, a new set of rendering-specific elements are added to the top toolbar:
    1. Daylight Glare Probability (DGP) – This reference will only appear when you have opened a hemispheric rendering. This percentage represents the probability that a person is disturbed by glare at this specific viewpoint.
    2. Camera Tools – These three buttons allow you to switch between basic rendering mode, false color mode, and contour lines mode. The rightmost slider controls will change depending on which mode you are in.
      1. Exposure – You can manually adjust the exposure of your renderings in order to increase or decrease the amount of light per unit area. LightStanza uses Reinhard tone mapping for adjusting exposure.
      2. Contrast – Adjusting the contrast of your image will increase or decrease the difference between light and dark in your renderings.
      3. False Color – In the 3D viewer, you have the option to view your renderings in False Color mode for a more quantitative view of your images.
        1. Luminance Bounds – Changing your luminance sets what luminance values each color in your image represents. Adjust this to focus on very bright or very dark areas.
        2. Log Scale – Adjusting your log scale sets scaling of your false color heat map.
      4. Contour Lines – This is another way to look at your false color rendering. Contour lines trace the different luminance thresholds in your rendering, using the false color legend.
        1. Line Spacing – Changing your line spacing sets the density of the contour lines in your image.