The Grasshopper Daylight component can be used to run several DIVA-for-Rhino simulations on its own or in conjunction with a Rhino model already simulated using the DIVA-for-Rhino toolbar in Rhino. You will need the Material component and the DIVA Daylight component to run a simulation. The data produced by the DIVA Daylight component can be used directly in your model or visualized using a number of other grasshopper components. The legend component creates a simple legend which is oriented to the current Rhino viewport for screen capture.
GM: Geometry and Material output: Meshes of the input geometry with the selected Material reference. To be passed to the GM input of the Daylight Analysis component.
Material Menu left click pull down. The materials in the current material library. Any new materials added to the library file will show up in this list. Add custom radiance materials to the text file located at C:\DIVA\Daylight\material.rad to customize this list.
Project Name Optional. Name to store the simulation files and results. If a slider is being used to generate a series of variations, incorporating that slider value into the project name will store the project files and results of each simulation. For example,use the concatenate component to join a string like "DIVA_test" with the slider output to get something like 'DIVA_test0.25'. Running a solar irradiation simulation with this as the project name will create the following folder for the project files: 'C:\DIVA\Daylight\Grasshopper\Projects\test0.25-solrad'
GM Optional. Attach the ouput of the Material component described above. If no geometry with a material reference is provided the simulation will run on an empty scene.
Nodes Optional. Input a list or tree of points here and they will become the new analysis nodes for the simulation. Below is an example where the vertices and normals of three mesh objects are used for the analysis nodes and analysis direction (Vectors) respectively. This allows the vertices and faces of the mesh to be used to create visualization meshes for the analysis data.
Vectors Optional. Input a list or tree of vectors (which matches the Nodes input) for the direction of the analysis. If no vector (analysis direction) are specified, the default is to have the node analysis direction of up (+z). If only one direction is specified for a list or tree of points (analysis nodes), then that vector will be applied to all the points (analysis nodes).
Run Boolean. Attach a boolean toggle component. Keep this set to false until you are ready to run the simulation. If set to true, any change to the input parameters will trigger another simulation. Data on previous simulations can be retrieved through the component with 'Run' set to false as long as the project name and simulation type exactly matches the previously run simulation.
Write Only Boolean. Attach a boolean toggle component. If this is set to 'true' and the Run boolean is set to 'false' then the component will write all the necessary simulation files to the Project Name folder. The simulation can then be run by clicking the batch file within the folder. The simulation result files should appear in the same folder when the simulation finishes. This facilitates generation of many project files and uploading them to run on other computers or the cloud.
Settings menu button. Left click to access the setting menu.
Run Boolean. This is a trigger to update the legend to the current Rhino view port.
LB: Lower Bound number of legend.
UB: Upper Bound number of legend.
S: Optional Text string to include with the legend. Useful for post processing the data from the analysis component for an average or threshold, etc...
G: Legend Geometry output, Eight legend panels oriented to the current viewport. Any update of the component will align with the current viewport. Attach to G of a preview component.
(t): Values to attach to the false color gradient which will divide the gradient between the upper and lower bounds over the 8 panels. Attach the output of the color gradient component to the S of the preview component.
L: Location of text tag, attach to L of a text tag component.
T: Legend Text, attach to T of the text tag component.