Merge pull request #101 from CooperUnion/develop

amber289 · web-flow · commit 8459b888f5c3 · 2025-08-11T20:28:23.000-04:00
clarify module content
diff --git a/arch134b_workshops/docs/02_1_shoebox_p1.md b/arch134b_workshops/docs/02_1_shoebox_p1.md
@@ -81,7 +81,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
-The _location input of "LB SunPath" component takes values from the _location output of your ImportEPW component. The _wind_direction input of "LB Wind Rose" takes values from the _wind_direction output of the ImportEPW component. The _data component takes values from the **take better picture for this**.
+The _location input of "LB SunPath" component takes values from the _location output of your ImportEPW component. The _wind_direction input of "LB Wind Rose" takes values from the _wind_direction output of the ImportEPW component. The _data component takes values from the _wind_speed_ output of ImportEPW. **take better picture for this**
 
 ```{image} ../_static/shoebox1/shoebox1_9.png
 :width: 100%
@@ -99,7 +99,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. 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.
+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 location. This plot will be revisited in a later module.
 
 ```{image} ../_static/shoebox1/shoebox1_11.png
 :width: 100%
diff --git a/arch134b_workshops/docs/03_1_simulation_p1.md b/arch134b_workshops/docs/03_1_simulation_p1.md
@@ -36,7 +36,7 @@ Connect the model output of "HB Model" to _rooms_model input of "HB Thermal Load
 <br/><br/>
 
 ## Legend Parameters
-Insert a Legend Parameter component whose input colors are dictated by "LB Color Range" which creates gradient visualizations.
+Insert a "LB Legend Parameter" component whose input colors are dictated by "LB Color Range" which creates gradient visualizations.
 ```{image} ../_static/sim1/sim1_5.png
 :width: 100%
 :align: center
@@ -64,7 +64,7 @@ The "TimeOp" component takes both heating and cooling data from EnergyResult as
 <br/><br/>
 
 ## Dry Bulb Temp Visualization
-Create a new monthly chart with an appropriate base_pt _. Connect the dry_bulb_temperature output of your ImportEPW component to the _data input of your new monthly chart. Another view of this configuration is shown in the next image.
+Create a new monthly chart with an appropriate base_pt _. Connect the dry_bulb_temperature output of your ImportEPW component to the _data input of your new monthly chart. This creates a monthly chart that shows the temperature readings using a standard thermometer that is not affected by the moisture in the air, aka a dry bulb. Knowing dry bulb temperature is important in building design when considering [thermal comfort](https://cooperunion.github.io/buildingenergymodeling_workshops/docs/01_1_climate_p1.html#temperature-and-humidity), implementing HVAC systems, and assessing heat stress. Another view of this configuration is shown in the next image.
 
 ```{image} ../_static/sim1/sim1_8.png
 :width: 100%
@@ -82,7 +82,7 @@ This is what your plot generation logic should look like.
 <br/><br/>
 
 ## Monthly Heating and Cooling Loads Plot with Temperature
-This is what your second and third generated plots should look like. The top shows average daily temperatures by month. The bottom shows heating and cooling loads for each month. We have higher heating loads in the winter and higher cooling loads in the summer. 
+This is what your second and third generated plots should look like. The [top](https://cooperunion.github.io/buildingenergymodeling_workshops/docs/03_1_simulation_p1.html#dry-bulb-temp-visualization) shows average daily temperatures by month. The [bottom](https://cooperunion.github.io/buildingenergymodeling_workshops/docs/03_1_simulation_p1.html#heating-and-cooling-loads-visualization) shows heating and cooling loads for each month. We have higher heating loads in the winter and higher cooling loads in the summer. 
 
 Consider the results. Does this align with what you would expect?
 
diff --git a/arch134b_workshops/docs/05_1_passive_design_p1.md b/arch134b_workshops/docs/05_1_passive_design_p1.md
@@ -8,7 +8,7 @@
 ```
 <br/><br/>
 
-2. At the top bar, you have various function as described below.
+2. At the top bar, you have various functions as described below.
 - ASHRAE-55: thermal comfort standard by ASHRAE (American Society of Heating Refrigerating and Air-Conditioning Engineers)
 - EN-16798: thermal comfort standard by CEN (Comité Européen de Normalisation (European Committee for Standardization))
 - Compare: allows you to key in up to 3 different conditions and compare them 
@@ -22,14 +22,14 @@
 ```
 <br/><br/>
 
-3. We will use the ASHRAE-55 Predicted Mean Vote (PMV) method for this tutorial. On the left bar you only see 5 factors: Operative temperature, Air speed, Relative humidity, Metabolic rate and clothing level. Air temperature and Mean Radiant Temperature (MRT) are missing and replaced by operative temperature. Operative temperature is a metric that combines both the air temperature and MRT, at its simplest form it is expressed as the average of air temperature and MRT. Read more about it on its <a href="https://en.wikipedia.org/wiki/Operative_temperature" target="_blank">wikipedia entry</a>.
+3. We will use the ASHRAE-55 Predicted Mean Vote (PMV) method for this tutorial. On the left bar, you only see 5 factors: Operative temperature, Air speed, Relative humidity, Metabolic rate and clothing level. Air temperature and Mean Radiant Temperature (MRT) are missing and replaced by operative temperature. Operative temperature is a metric that combines both the air temperature and MRT, at its simplest form it is expressed as the average of air temperature and MRT. Read more about it on its <a href="https://en.wikipedia.org/wiki/Operative_temperature" target="_blank">wikipedia entry</a>.
 ```{image} ../_static/cmf1/cmf1_3.png
 :width: 100%
 :align: center
 ```
 <br/><br/>
 
-4. If we change the Psychrometric (operative temperature) to Psychrometric (air temperature) and untick the Use operative temperature we can separate operative temperature into Air temperature and Mean radiant temperature.
+4. If we change the Psychrometric (operative temperature) to Psychrometric (air temperature) and untick the Use operative temperature, we can separate operative temperature into Air temperature and Mean radiant temperature.
 ```{image} ../_static/cmf1/cmf1_4.png
 :width: 100%
 :align: center
@@ -46,7 +46,7 @@ Metabolic rate = 1 met, seated quiet
 Clothing level = 1, Typical winter indoor clothing
 ```
 
-6. It complies with the ASHRAE Standard 55. For winter, based on the model an air temperature of 22 degC (71.6 degF) setpoint shld be sufficient to keep a person comfortable, if the other conditions as specified are met. The PMV vote is -0.49 (0 being neutral not hot and not cold) with Percentage of People Dissatisfied (PPD) = 10% that means 10% of the people in the room might be unsatisfied with the thermal condition.
+6. It complies with the ASHRAE Standard 55. For winter, based on the model an air temperature of 22 degC (71.6 degF) setpoint should be sufficient to keep a person comfortable, if the other conditions as specified are met. The PMV vote is -0.49 (0 being neutral not hot and not cold) with Percentage of People Dissatisfied (PPD) = 10% that means 10% of the people in the room might be unsatisfied with the thermal condition.
 ```{image} ../_static/cmf1/cmf1_5.png
 :width: 100%
 :align: center
@@ -63,7 +63,7 @@ Metabolic rate = 1 met, seated quiet
 Clothing level = 0.5, Typical summer indoor clothing
 ```
 
-8. It complies with the ASHRAE Standard 55. For summer, based on the model an air temperature of 28 degC (82.4 degF) setpoint shld be sufficient to keep a person comfortable, if the other conditions as specified are met. The PMV vote is 0.02 with Percentage of People Dissatisfied (PPD) = 5%.
+8. It complies with the ASHRAE Standard 55. For summer, based on the model an air temperature of 28 degC (82.4 degF) setpoint should be sufficient to keep a person comfortable, if the other conditions as specified are met. The PMV vote is 0.02 with Percentage of People Dissatisfied (PPD) = 5%.
 ```{image} ../_static/cmf1/cmf1_6.png
 :width: 100%
 :align: center
diff --git a/arch134b_workshops/docs/05_2_passive_design_p2.md b/arch134b_workshops/docs/05_2_passive_design_p2.md
@@ -90,6 +90,7 @@ This shows how much sunlight hits each part of the model's surface. Use a perspe
 <br/><br/>
 
 ## Create Radiation Dome Visualization
+Using LB Radiation Dome, create a visualization of the solar energy or radiation received by the area from all directions.
 ```{image} ../_static/psvdgn1/psvdgn1_12.png
 :width: 100%
 :align: center
