Merge pull request #22 from gaudi369/docs

Update 02_1_shoebox_p1.md

Author: gaudi369

arch134b_workshops/docs/02_1_shoebox_p1.md

@@ -1,80 +1,100 @@
-## Weather Data Visualization with Ladybug Tools
+# Weather Data Visualization with Ladybug Tools
 
 This tutorial demonstrates how to use the Ladybug plugin in Grasshopper to create a dashboard of climate analysis graphics from an EPW weather file. This process is fundamental for understanding the local climate and informing early-stage design decisions.
 
-By the end of this tutorial, you will have created a set of visualizations in your Rhino viewport similar to the one below, which includes an hourly temperature plot, a monthly data chart, a psychrometric chart, a wind rose, and a sun path diagram for Van Nuys, California.
+By the end of this tutorial, you will have created a set of visualizations in your Rhino viewport, which includes an hourly temperature plot, a monthly data chart, a psychrometric chart, a wind rose, and a sun path diagram for Van Nuys, California.
 
-Open Grasshopper from Rhino
+## Open Grasshopper from Rhino by clicking the circled green icon.
 ```{image} ../_static/shoebox1/shoebox1_1.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Double click on canvas to search for components. Type in "Panel". Click and drop the Panle onto the canvas. 
+## 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
 ```
 <br/><br/>
 
-Copy EnergyPlus Weather (epw) File Path
+## Locate your EnergyPlus Weather (epw) file in your file explorer and copy the file path as shown.
 ```{image} ../_static/shoebox1/shoebox1_3.png
 :width: 100%
 :align: center
 ```
 <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 loacted on the top bar. Once you are familiar, this is an alternative place to drag and drop components from. 
 ```{image} ../_static/shoebox1/shoebox1_4.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Import EPW
+## Import EPW
+Double-click the canvas and type "Import EPW". Select and place the Import EPW component onto the canvas. Click and hold the right side of the panel where the small connection tab is located to create a connection. Drag and release onto the Import EPW component connection tab to connect the components. This is the standard process of connecting components and will be referenced often throughout the modules.
+
 ```{image} ../_static/shoebox1/shoebox1_5.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Create Temperature and Psychometric Charts
+Notice the compontent name is located in the center of the "Import EPW" component. To the left are inputs and to the right are outputs. Required inputs are denoted by a leading underscore (example: "_epw_file"). Connections determine the "flow" of data and operations. You can right click to inspect components. This can be useful for finding "runtime errors" and figuring out the next steps to solve them.
+
+## Create Temperature and Psychometric Charts.
+Practice double-clicking the canvas, searching for components, selecting and placing them, and connecting them together to replicate the Grasshopper canvas shown below. Hover over the "_base_pt _" input and read the description to understand it's purpose. The following modules will require you to replcate block diagrams in this way.
+
 ```{image} ../_static/shoebox1/shoebox1_6.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Hide Lines in 8760 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
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Check Plots
+## Checking and understanding plots
+Once your components are properly connected, they will generate plots on your Rhino Canvas. It may be helpful to open a "Top" Rhino viewport and zoom out a bit to examine your plots. Double check that your three generated plots look like the plots below. If they are overlapping, revise your "_base_pt_input _"
+
 ```{image} ../_static/shoebox1/shoebox1_8.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Create Wind Rose and Sun Path Visualizations
+The plot on top (the hourly plot) is called an 8760 model. Each pixel represents one hour of the year. The legend on the right of the plot tells us that redder colors mean warmer temperatures and bluer colors mean colder temperatures. If we read the plot, we can see that it is generally colder at night, and the hottest temperatures are in the summer afternoons. This aligns with our real-life intuition.
+
+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
+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
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Check Wind Rose
+## 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.
+
 ```{image} ../_static/shoebox1/shoebox1_10.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-Check Sun Path (perspective view)
+## 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.
+
 ```{image} ../_static/shoebox1/shoebox1_11.png
 :width: 100%
 :align: center