Merge pull request #23 from gaudi369/docs

update shoebox 1_2

Author: gaudi369

arch134b_workshops/docs/02_1_shoebox_p1.md

@@ -11,7 +11,9 @@ By the end of this tutorial, you will have created a set of visualizations in yo
 ```
 <br/><br/>
 
-## Double click on the Grasshopper canvas to search for components. Type in "Panel". Click and drop the Panel onto the canvas. 
+## Place your first component.
+Double click on the Grasshopper canvas to search for components. Type in "Panel". Click and drop the Panel onto the canvas. 
+
 ```{image} ../_static/shoebox1/shoebox1_2.png
 :width: 100%
 :align: center
@@ -25,7 +27,9 @@ By the end of this tutorial, you will have created a set of visualizations in yo
 ```
 <br/><br/>
 
-## Plugin libraries and functions are loacted on the top bar. Once you are familiar, this is an alternative place to drag and drop components from. 
+## Plugin libraries and functions are located on the top bar. 
+This is an alternative place to drag and drop components from. 
+
 ```{image} ../_static/shoebox1/shoebox1_4.png
 :width: 100%
 :align: center
@@ -52,7 +56,7 @@ Practice double-clicking the canvas, searching for components, selecting and pla
 ```
 <br/><br/>
 
-## Hide Lines in the hourly plot
+## Hide lines in the hourly plot
 Right click the center of the Hourly Plot component and click the option to "Hide Preview". Then connect the indicated outputs to a "Custom Preview" component. Note how this removes the grid lines from the original plot. Custom Previews can be used to modify your plots.
 
 ```{image} ../_static/shoebox1/shoebox1_7.png
@@ -74,7 +78,7 @@ The plot on top (the hourly plot) is called an 8760 model. Each pixel represents
 
 Hover over the center of the other two plot components on your Grasshopper canvas to read about them. 
 
-## Create Wind Rose and Sun Path Visualizations
+## Create Wind Rose and Sun Path visualizations
 The _location input takes values from the _location output of your Inport EPW component. The _wind_direction input takes values from the _wind_direction component. The _data component takes values from the **take better picture for this**.
 
 ```{image} ../_static/shoebox1/shoebox1_9.png
@@ -84,7 +88,7 @@ The _location input takes values from the _location output of your Inport EPW co
 <br/><br/>
 
 ## Check Wind Rose plot (perspective view)
-Investigate the wind rose in relation to your home. Manipulating a "Perspective" Rhino viewport may be useful here to explore the model. This plot will be revisited in a later module.
+Investigate the wind rose in relation to your home. Manipulating a "Perspective" Rhino viewport may be useful here to explore the model. A wind rose visualizes the wind speed and direction at a specific location. This plot will be revisited in a later module.
 
 ```{image} ../_static/shoebox1/shoebox1_10.png
 :width: 100%
@@ -93,7 +97,7 @@ Investigate the wind rose in relation to your home. Manipulating a "Perspective"
 <br/><br/>
 
 ## Check Sun Path (perspective view)
-Investigate the sun path in relation to your home. Manipulating a "Perspective" Rhino viewport may be useful here to explore the model. This plot will be revisited in a later module.
+Investigate the sun path in relation to your home. Manipulating a "Perspective" Rhino viewport may be useful here to explore the model. A sun path diagram shows the sun's path through the sky at a specific loacation. This plot will be revisited in a later module.
 
 ```{image} ../_static/shoebox1/shoebox1_11.png
 :width: 100%

arch134b_workshops/docs/02_2_shoebox_p2.md

@@ -1,92 +1,115 @@
 # Shoebox Model and Basic Visualizations
 
-Layers
+## Opening your shoebox model
+Open your single_family.3dm model (located here on Github: arch134b_workshops/_downloads/single_family.3dm).
+
+Hide the three layers as shown below. Your home should now appear as a simplified box. When we learn to analyze a building, we start with the simplest form first.
+
 ```{image} ../_static/shoebox2/shoebox2_1.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Geometry block
+## Create a "Geometry" component 
+Double-click the canvas, type in "geometry", click to select the component, and click again on the canvas to place the component. 
+
 ```{image} ../_static/shoebox2/shoebox2_2.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Select Layer
+## Select objects
+Locate the "Zones" sub-layer within the SINGLE_ZONE layer. Right click it and click "Select Objects"
+
 ```{image} ../_static/shoebox2/shoebox2_3.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Set one Geometry
+# Set one geometry
+Right click your geometry component and select "Set one Geometry".
 ```{image} ../_static/shoebox2/shoebox2_4.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Check if geometry is set
+## Check if geometry is set
+If your geometry is set properly, clicking your geometry component will highlight your zone in green in Rhino. Clicking elsewhere in th canvas will highlight the zone in red. 
+
 ```{image} ../_static/shoebox2/shoebox2_5.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Rooms Solid
+## Create "Rooms Solid" Component
+Create a "Rooms Solid" component similarly to how you searched an placed the "Geometry" component earlier.
+
 ```{image} ../_static/shoebox2/shoebox2_6.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Set Windows and link to Aperture
+## Set Windows and link to Aperture
+Link your windows layer to a new geomoetry component and connect it to an "Aperture" component. Continue to recreate the block diagram step-by-step by searching for components, placing, and connecting them.
+
 ```{image} ../_static/shoebox2/shoebox2_7.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Add Subface
+## Add Subface
 ```{image} ../_static/shoebox2/shoebox2_8.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Create Model
+## Create Model
 ```{image} ../_static/shoebox2/shoebox2_9.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Visualize Room Attributes
+## Visualize Room Attributes
 ```{image} ../_static/shoebox2/shoebox2_10.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Specify Legend Parameters
+## Specify Legend Parameters
+The yellow box is a "Panel" component. This component can be double clicked and typed into. Alternatively, double click the canvas then type "6 and press enter. This should create the same panel as shown in the image. 
+
 ```{image} ../_static/shoebox2/shoebox2_11.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Check Room Attributes and Group Block
+## Check Room Attributes and Group Block
+Selected components can be grouped into a purple box with CTRL+G. To select compontents, hold SHIFT and click them. Alternatively, hold left-click and drag the generated rectangular box around the components your want to select.
+
+The ColorRoomAttributes component we created should color the floor of your shoebox model and generate a legend indicating the selected attribute and associated value. Click through several attributes in your dropdown menu component in Grasshopper and watch the generated visual change in Rhino . 
+
 ```{image} ../_static/shoebox2/shoebox2_12.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Check Face Attributes
+## Check Face Attributes
+Hide the Room Attribute visualization by right clicking the component and selecting "Hide Preview". The Face Attribute visual shows useful characteristics such as the material type. It can also visualize thermal resistance (called R-values) and thermal conductance (called U values or G values). Read more here: https://en.wikipedia.org/wiki/Thermal_conductance_and_resistance
+
 ```{image} ../_static/shoebox2/shoebox2_13.png
 :width: 100%
 :align: center
-```
+```e
 <br/><br/>