Skip to content

Commit 8f08f9f

Browse files
authored
Update 02_1_shoebox_p1.md
1 parent beb5e8e commit 8f08f9f

File tree

1 file changed

+14
-102
lines changed

1 file changed

+14
-102
lines changed

arch134b_workshops/docs/02_1_shoebox_p1.md

Lines changed: 14 additions & 102 deletions
Original file line numberDiff line numberDiff line change
@@ -4,135 +4,47 @@ This tutorial demonstrates how to use the Ladybug plugin in Grasshopper to creat
44

55
!(create panel)[https://github.com/gaudi369/buildingenergymodeling_workshops/blob/main/arch134b_workshops/_static/shoebox1/shoe1_1.png]
66

7-
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 wind rose, a monthly data chart, and a psychrometric chart for Van Nuys, California.
7+
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.
88

9+
Panel
910
```{image} arch134b_workshops/_static/shoebox1/shoebox1_1.png
1011
:width: 100%
1112
:align: center
1213
```
13-
1414
<br/><br/>
1515

16-
Step 1: Prepare Sun Path and Wind Rose Visualizations
17-
18-
The Sunpath and WindRose are two key components for site analysis. The Sunpath diagram helps visualize the sun's position throughout the year, crucial for daylighting and shading studies. The WindRose shows the direction, frequency, and speed of wind, which informs natural ventilation strategies.
19-
20-
Place the Ladybug_Sunpath and Ladybug_WindRose components on the Grasshopper canvas. We will connect data to their inputs later. Notice the various inputs that allow for customization of the graphics.
21-
22-
Generated {image} arch134b_workshops/_static/shoebox1/weather_2.png
16+
```{image} arch134b_workshops/_static/shoebox1/shoebox1_2.png
2317
:width: 100%
2418
:align: center
25-
IGNORE_WHEN_COPYING_START
26-
content_copy
27-
download
28-
Use code with caution.
29-
{image} arch134b_workshops/_static/shoebox1/weather_2.png
30-
IGNORE_WHEN_COPYING_END
31-
19+
```
3220
<br/><br/>
3321

34-
Step 2: Set Up an Hourly Data Plot
35-
36-
Ladybug allows you to visualize any hourly data stream from the weather file. A common choice is the dry-bulb temperature, which shows the temperature fluctuations throughout the days and seasons.
37-
38-
Add the Ladybug_Hourly Plot component to the canvas.
39-
40-
To control where the plot appears in the Rhino viewport, connect a coordinate point to the _base_pt_ input. In this example, we use a panel with the coordinates -500, -80, 0. This will place the chart's bottom-left corner at that location.
41-
42-
Generated {image} arch134b_workshops/_static/shoebox1/weather_3.png
22+
```{image} arch134b_workshops/_static/shoebox1/shoebox1_3.png
4323
:width: 100%
4424
:align: center
45-
IGNORE_WHEN_COPYING_START
46-
content_copy
47-
download
48-
Use code with caution.
49-
{image} arch134b_workshops/_static/shoebox1/weather_3.png
50-
IGNORE_WHEN_COPYING_END
51-
25+
```
5226
<br/><br/>
5327

54-
Step 3: Use Panels for Text Input
55-
56-
In Grasshopper, Panel components are essential for adding custom text, notes, or numerical data. We will use them to input file paths and coordinates.
57-
58-
To create a Panel, double-click on an empty part of the Grasshopper canvas.
59-
60-
A search bar will appear. Type "Panel" and press Enter, or select it from the list. An empty yellow panel will be created. You can then double-click the panel to edit its content.
61-
62-
Generated {image} arch134b_workshops/_static/shoebox1/weather_4.png
28+
```{image} arch134b_workshops/_static/shoebox1/shoebox1_4.png
6329
:width: 100%
6430
:align: center
65-
IGNORE_WHEN_COPYING_START
66-
content_copy
67-
download
68-
Use code with caution.
69-
{image} arch134b_workshops/_static/shoebox1/weather_4.png
70-
IGNORE_WHEN_COPYING_END
71-
31+
```
7232
<br/><br/>
7333

74-
Step 4: Assemble the Core Visualization Script
75-
76-
Now, let's assemble the main part of our script. The entire process starts with importing the weather data.
77-
78-
The central component is Ladybug_Import EPW. The outputs of this component provide all the raw hourly data from the weather file.
79-
80-
Connect the desired data outputs from Import EPW to the _data inputs of the various charting components (HourlyPlot, MonthlyChart, PsychrometricChart). For example, connect dry_bulb_temperature to the HourlyPlot's _data input.
81-
82-
Use Panel components with different coordinates for each chart's _base_pt_ input to arrange them neatly in the Rhino viewport.
83-
84-
Generated {image} arch134b_workshops/_static/shoebox1/weather_5.png
34+
```{image} arch134b_workshops/_static/shoebox1/shoebox1_5.png
8535
:width: 100%
8636
:align: center
87-
IGNORE_WHEN_COPYING_START
88-
content_copy
89-
download
90-
Use code with caution.
91-
{image} arch134b_workshops/_static/shoebox1/weather_5.png
92-
IGNORE_WHEN_COPYING_END
93-
37+
```
9438
<br/><br/>
9539

96-
Step 5: Locate and Copy the Weather File Path
97-
98-
Before the Import EPW component can work, it needs to know where to find the weather file on your computer. EPW files can be downloaded for free from sources like the DOE EnergyPlus website.
99-
100-
Using your computer's file explorer, navigate to the location where you saved your EPW file (e.g., USA_CA_Van.Nuys.AP.722886_TMYx.epw).
101-
102-
Right-click on the file and select "Copy as path". This copies the full file location to your clipboard.
103-
104-
Generated {image} arch134b_workshops/_static/shoebox1/weather_6.png
40+
```{image} arch134b_workshops/_static/shoebox1/shoebox1_6.png
10541
:width: 100%
10642
:align: center
107-
IGNORE_WHEN_COPYING_START
108-
content_copy
109-
download
110-
Use code with caution.
111-
{image} arch134b_workshops/_static/shoebox1/weather_6.png
112-
IGNORE_WHEN_COPYING_END
113-
43+
```
11444
<br/><br/>
11545

116-
Step 6: Import the Weather Data into Grasshopper
117-
118-
The final step is to feed the copied file path into our Grasshopper script.
119-
120-
Add a Panel component to your canvas (as shown in Step 3).
121-
122-
Double-click the panel and paste (Ctrl+V) the file path you copied in the previous step. The panel should now contain the full path to your EPW file.
123-
124-
Connect the output of this Panel to the _epw_file input of the Ladybug_Import EPW component.
125-
126-
Once this connection is made, Ladybug will read the file, and all the connected visualization components will update to display the data, generating the complete dashboard in your Rhino viewport.
127-
128-
Generated {image} arch134b_workshops/_static/shoebox1/weather_7.png
46+
```{image} arch134b_workshops/_static/shoebox1/shoebox1_7.png
12947
:width: 100%
13048
:align: center
131-
IGNORE_WHEN_COPYING_START
132-
content_copy
133-
download
134-
Use code with caution.
135-
{image} arch134b_workshops/_static/shoebox1/weather_7.png
136-
IGNORE_WHEN_COPYING_END
137-
49+
```
13850
<br/><br/>

0 commit comments

Comments
 (0)