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. 

Material Component

G: Geometry input: Meshes or Breps which are created or referenced in Grasshopper.

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.

DIVA Daylight Component

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.

• Under 'Location' you can choose a weather file location from the weather files loaded with the DIVA installation or by adding your own to 'C:\DIVA\WeatherData'.
• Under 'Simulation Parameters' you can choose the simulation type and paramters. Checking the box 'Include Rhino Scene' will add the rhino geometry used in the current rhino file (after a completed DIVA-for-Rhino simulation) to the grasshopper geometry passed through the Material Component. In this way, a very complex scene with various materials could be simulated in Rhino using the toolbar, and parametric geometry created in grasshopper could be added to the simulation. If all the geometry for a simulation is referenced or created in grasshopper, leave this box unchecked.
• Under 'Outputs' you can choose what data to send to the output side of the component. For images this can be the file location. For node based simulations, this can be an ordered list of data which correspond to the list of points (analysis nodes) which were used.

Legend Component

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.

Home           Next Topic > Thermal Components