openstudio-model-articulation 0.4.0 → 0.5.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.rubocop.yml +3 -1
- data/CHANGELOG.md +13 -0
- data/Gemfile +2 -2
- data/README.md +14 -0
- data/lib/measures/SetWindowToWallRatioByFacade/measure.rb +10 -3
- data/lib/measures/SetWindowToWallRatioByFacade/measure.xml +10 -4
- data/lib/measures/add_empd_material_properties/LICENSE.md +27 -0
- data/lib/measures/add_empd_material_properties/README.md +116 -0
- data/lib/measures/add_empd_material_properties/README.md.erb +42 -0
- data/lib/measures/add_empd_material_properties/docs/.gitkeep +0 -0
- data/lib/measures/add_empd_material_properties/measure.rb +247 -0
- data/lib/measures/add_empd_material_properties/measure.xml +201 -0
- data/lib/measures/create_DOE_prototype_building/measure.xml +2 -2
- data/lib/measures/create_bar_from_building_type_ratios/README.md +109 -35
- data/lib/measures/create_bar_from_building_type_ratios/README.md.erb +54 -35
- data/lib/measures/create_bar_from_building_type_ratios/measure.rb +5 -0
- data/lib/measures/create_bar_from_building_type_ratios/measure.xml +16 -16
- data/lib/measures/create_bar_from_deer_building_type_ratios/README.md +301 -79
- data/lib/measures/create_bar_from_deer_building_type_ratios/README.md.erb +62 -79
- data/lib/measures/create_bar_from_deer_building_type_ratios/measure.rb +6 -1
- data/lib/measures/create_bar_from_deer_building_type_ratios/measure.xml +19 -63
- data/lib/measures/create_bar_from_doe_building_type_ratios/README.md +298 -57
- data/lib/measures/create_bar_from_doe_building_type_ratios/README.md.erb +54 -57
- data/lib/measures/create_bar_from_doe_building_type_ratios/measure.rb +6 -1
- data/lib/measures/create_bar_from_doe_building_type_ratios/measure.xml +16 -20
- data/lib/measures/create_bar_from_space_type_ratios/README.md +94 -42
- data/lib/measures/create_bar_from_space_type_ratios/README.md.erb +60 -42
- data/lib/measures/create_bar_from_space_type_ratios/measure.rb +5 -0
- data/lib/measures/create_bar_from_space_type_ratios/measure.xml +19 -19
- data/lib/measures/create_baseline_building/measure.xml +2 -2
- data/lib/measures/create_deer_prototype_building/measure.xml +2 -2
- data/lib/measures/create_typical_building_from_model/README.md +81 -16
- data/lib/measures/create_typical_building_from_model/README.md.erb +36 -16
- data/lib/measures/create_typical_building_from_model/measure.rb +5 -0
- data/lib/measures/create_typical_building_from_model/measure.xml +19 -19
- data/lib/measures/create_typical_deer_building_from_model/README.md +173 -53
- data/lib/measures/create_typical_deer_building_from_model/README.md.erb +57 -53
- data/lib/measures/create_typical_deer_building_from_model/measure.rb +6 -1
- data/lib/measures/create_typical_deer_building_from_model/measure.xml +25 -25
- data/lib/measures/create_typical_doe_building_from_model/README.md +182 -44
- data/lib/measures/create_typical_doe_building_from_model/README.md.erb +58 -44
- data/lib/measures/create_typical_doe_building_from_model/measure.rb +6 -1
- data/lib/measures/create_typical_doe_building_from_model/measure.xml +25 -25
- data/lib/measures/radiant_slab_with_doas/measure.rb +5 -1
- data/lib/measures/radiant_slab_with_doas/measure.xml +9 -9
- data/lib/openstudio/model_articulation/version.rb +1 -1
- data/openstudio-model-articulation.gemspec +2 -2
- metadata +13 -7
@@ -12,86 +12,261 @@ The building floor area can be described as a footprint size or as a total build
|
|
12
12
|
## Measure Type
|
13
13
|
ModelMeasure
|
14
14
|
|
15
|
-
[//]: # (
|
16
|
-
|
17
|
-
|
15
|
+
[//]: # (Only finds value if taxonomy method is added to measure.rb, won't read out of measure.xml)
|
16
|
+
## Taxonomy
|
17
|
+
Envelope.Form
|
18
18
|
|
19
19
|
___
|
20
20
|
## Table of Contents
|
21
21
|
- [Measure Overview](#measure-overview)<br/>
|
22
22
|
- [DEER Template and Building Type Mapping](#deer-template-and-building-type-mapping)<br/>
|
23
|
-
- [
|
24
|
-
- [
|
25
|
-
- [
|
26
|
-
- [
|
27
|
-
- [
|
28
|
-
- [
|
29
|
-
- [
|
23
|
+
- [Functionality and Input Overview](#functionality-and-input-overview)<br/>
|
24
|
+
- [Building Type Mix](#building-type-mix)<br/>
|
25
|
+
- [Floor Area](#floor-area)<br/>
|
26
|
+
- [Height, Stories, and Orientation](#height-stories-and-orientation)<br/>
|
27
|
+
- [Template](#template)<br/>
|
28
|
+
- [Building Shape](#building-shape)<br/>
|
29
|
+
- [Window to Wall Ratio](#window-to-wall-ratio)<br/>
|
30
|
+
- [Party Walls and Exposure of Top and Bottom Stories](#party-walls-and-exposure-of-top-and-bottom-stories)<br/>
|
31
|
+
- [Calculation Methods and Articulation Logic](#calculation-methods-and-articulation-logic)<br/>
|
30
32
|
- [Development Comments](#development-comments)<br/>
|
31
33
|
- [Automatically Generated Argument List](#arguments)<br/>
|
32
34
|
|
33
35
|
## Measure Overview
|
34
36
|
|
35
|
-
The intent of this measure is to create basic geometry given a mix of building types and high level characteristics about the building envelope like the number of stories, aspect ratio, orientation etc. This will result in one or more rectangular building elements. The spaces will have stub space type assignments but will not have any internal loads or and the surfaces will not have constructions. The stub space type ratios are based on DEER prototype buildings, depending on the building type you select. The typical workflow is to run other measures after this measure that populate the stub space types and other model elements. This measure has
|
37
|
+
The intent of this measure is to create basic geometry given a mix of building types and high level characteristics about the building envelope like the number of stories, aspect ratio, orientation etc. This will result in one or more rectangular building elements. The spaces will have stub space type assignments but will not have any internal loads or and the surfaces will not have constructions. The stub space type ratios are based on DEER prototype buildings, depending on the building type you select. The typical workflow is to run other measures after this measure that populate the stub space types and other model elements. This measure has more than 30 arguments and can look intimidating, but all of them have defaults, so it will run properly without you changing any arguments; however at a minimum you will typically want to at least choose the primary building type, building floor area, and number of stories above grade. Make use of additional arguments as you have a need to.
|
36
38
|
|
37
|
-
This is generally meant to run on an empty model, but it does not
|
39
|
+
This is generally meant to run on an empty model, but it does not actively delete any geometry or objects that may already be in the model.
|
38
40
|
|
39
41
|
## DEER Template and Building Type Mapping
|
40
42
|
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
|
43
|
+
#### Templates:
|
44
|
+
|
45
|
+
|
46
|
+
|
47
|
+
|
48
|
+
|
49
|
+
|
50
|
+
|
51
|
+
|
52
|
+
|
53
|
+
|
54
|
+
|
55
|
+
|
56
|
+
|
57
|
+
|
58
|
+
|
59
|
+
|
60
|
+
|
61
|
+
|
62
|
+
|
63
|
+
|
64
|
+
|
65
|
+
|
66
|
+
|
67
|
+
|
68
|
+
|
69
|
+
|
70
|
+
|
71
|
+
|
72
|
+
|
73
|
+
|
74
|
+
|
75
|
+
- DEER Pre-1975<br/>
|
76
|
+
|
77
|
+
- DEER 1985<br/>
|
78
|
+
|
79
|
+
- DEER 1996<br/>
|
80
|
+
|
81
|
+
- DEER 2003<br/>
|
82
|
+
|
83
|
+
- DEER 2007<br/>
|
84
|
+
|
85
|
+
- DEER 2011<br/>
|
86
|
+
|
87
|
+
- DEER 2014<br/>
|
88
|
+
|
89
|
+
- DEER 2015<br/>
|
90
|
+
|
91
|
+
- DEER 2017<br/>
|
92
|
+
|
93
|
+
- DEER 2020<br/>
|
94
|
+
|
95
|
+
|
96
|
+
|
97
|
+
|
98
|
+
|
99
|
+
|
100
|
+
|
101
|
+
|
102
|
+
|
103
|
+
|
104
|
+
|
105
|
+
|
106
|
+
|
107
|
+
|
108
|
+
|
109
|
+
|
110
|
+
|
111
|
+
|
112
|
+
|
113
|
+
|
114
|
+
|
115
|
+
|
116
|
+
|
117
|
+
|
118
|
+
|
119
|
+
|
120
|
+
|
121
|
+
|
122
|
+
|
123
|
+
|
124
|
+
|
125
|
+
|
126
|
+
|
127
|
+
|
128
|
+
|
129
|
+
|
130
|
+
|
131
|
+
|
132
|
+
#### Building Types::
|
133
|
+
|
134
|
+
|
135
|
+
|
136
|
+
- Asm<br/>
|
137
|
+
|
138
|
+
- DMo<br/>
|
139
|
+
|
140
|
+
- ECC<br/>
|
141
|
+
|
142
|
+
- EPr<br/>
|
143
|
+
|
144
|
+
- ERC<br/>
|
145
|
+
|
146
|
+
- ESe<br/>
|
147
|
+
|
148
|
+
- EUn<br/>
|
149
|
+
|
150
|
+
- GHs<br/>
|
151
|
+
|
152
|
+
- Gro<br/>
|
153
|
+
|
154
|
+
- Hsp<br/>
|
155
|
+
|
156
|
+
- Htl<br/>
|
157
|
+
|
158
|
+
- MBT<br/>
|
159
|
+
|
160
|
+
- MFm<br/>
|
161
|
+
|
162
|
+
- MLI<br/>
|
163
|
+
|
164
|
+
- Mtl<br/>
|
165
|
+
|
166
|
+
- Nrs<br/>
|
167
|
+
|
168
|
+
- OfL<br/>
|
169
|
+
|
170
|
+
- OfS<br/>
|
171
|
+
|
172
|
+
- RFF<br/>
|
173
|
+
|
174
|
+
- RSD<br/>
|
175
|
+
|
176
|
+
- Rt3<br/>
|
177
|
+
|
178
|
+
- RtL<br/>
|
179
|
+
|
180
|
+
- RtS<br/>
|
181
|
+
|
182
|
+
- SCn<br/>
|
183
|
+
|
184
|
+
- SFm<br/>
|
185
|
+
|
186
|
+
- SUn<br/>
|
187
|
+
|
188
|
+
- WRf<br/>
|
189
|
+
|
190
|
+
|
191
|
+
|
192
|
+
|
193
|
+
|
194
|
+
|
195
|
+
|
196
|
+
|
197
|
+
|
198
|
+
|
199
|
+
|
200
|
+
|
201
|
+
|
202
|
+
|
203
|
+
|
204
|
+
|
205
|
+
|
206
|
+
|
207
|
+
|
208
|
+
|
209
|
+
|
210
|
+
|
211
|
+
|
212
|
+
|
213
|
+
|
214
|
+
|
215
|
+
|
216
|
+
|
217
|
+
|
218
|
+
|
219
|
+
|
220
|
+
|
221
|
+
|
222
|
+
|
223
|
+
|
224
|
+
|
225
|
+
|
226
|
+
|
227
|
+
|
228
|
+
|
229
|
+
|
230
|
+
|
231
|
+
|
232
|
+
|
233
|
+
|
234
|
+
|
235
|
+
|
236
|
+
|
237
|
+
|
238
|
+
|
239
|
+
|
240
|
+
|
241
|
+
|
242
|
+
|
243
|
+
|
244
|
+
|
245
|
+
|
246
|
+
|
247
|
+
|
248
|
+
|
249
|
+
|
250
|
+
|
251
|
+
|
252
|
+
|
253
|
+
|
254
|
+
|
255
|
+
[//]: # (argument values for template and bldg_type_a are dynamically generated from current version of the measure.)
|
80
256
|
|
81
257
|
[//]: # (Provide link to map DEER abbreviation to full building type name)
|
82
|
-
[//]: # (Would be nice to make these lists dynamic from the measure to they don't become outdated)
|
83
258
|
|
84
259
|
## Functionality and Input Overview
|
85
260
|
|
86
261
|
#### Building Type Mix
|
87
262
|
|
88
|
-
One to four building types can be combined into the building generated by this measure. For each of the four possible building types there are
|
263
|
+
One to four building types can be combined into the building generated by this measure. For each of the four possible building types there are two arguments. One to define the building type `Building Type B` and another to describe the fraction of the building this building type accounts for 'bldg_type_b_fract_bldg_area'. If the value of a specific building type's fraction is 0, then it doesn't matter what building type is selected, as it will not be added ot the model.
|
89
264
|
|
90
265
|
Building Type A is an exception from the others in that it doesn't have an argument for the fraction of building floor area, instead the remainder left after the other three is used. If the sum of fractions for building types b,c and d are greater than 1.0 an error will be thrown.
|
91
266
|
|
92
267
|
#### Floor Area
|
93
268
|
|
94
|
-
The typical use case for this measure is to set the total building floor area using the `Total Building Floor Area` argument. With this approach you can maintain a set building floor area while changing the number of stories. An alternate workflow is to set a static footprint area. This alternate workflow is enabled by
|
269
|
+
The typical use case for this measure is to set the total building floor area using the `Total Building Floor Area` argument. With this approach you can maintain a set building floor area while changing the number of stories. An alternate workflow is to set a static footprint area. This alternate workflow is enabled by setting a non-zero value for the `Single Floor Area` argument.
|
95
270
|
|
96
271
|
[//]: # (todo - add screenshot of same floor area on different num stories and shapes)
|
97
272
|
|
@@ -99,7 +274,7 @@ The typical use case for this measure is to set the total building floor area us
|
|
99
274
|
|
100
275
|
The Floor to floor height for the building is controlled through the `Typical Floor to FLoor Height` argument. It is the first of a number of arguments where a value of 0 represents a **smart default**. If leave the default value of zero in place it will pick a building specific floor to floor height. For example 9' would be picked for a small hotel and 14' for a hospital.
|
101
276
|
|
102
|
-
Some building types have space type specific definitions for height that can be enabled with the `Enable Custom Height Bar Application` argument. If I building doesn't have any custom heights defined the value of this argument will not matter. One example of where this argument would have an impact is for the gym and
|
277
|
+
Some building types have space type specific definitions for height that can be enabled with the `Enable Custom Height Bar Application` argument. If I building doesn't have any custom heights defined the value of this argument will not matter. One example of where this argument would have an impact is for the gym and auditorium in the SecondarySchool which would have a height 26' instead of the default school height of 13'. This is accomplished by pulling space types with a custom height into a separate rectangular building that sits away from the main structure. If this argument is set to false then all of the space types will have the same height, which for the school would be the default of 13'
|
103
278
|
|
104
279
|
![No Custom Height Space Types](./docs/custom_height_false.png?raw=true)
|
105
280
|
*Secondary school without custom space type heights enabled*
|
@@ -112,11 +287,11 @@ There are two arguments that control the number of stories the building has. `Nu
|
|
112
287
|
![Baesment](./docs/basement.png?raw=true)
|
113
288
|
*Secondary school with 1 below grade story*
|
114
289
|
|
115
|
-
The `Building Rotation` argument will rotate the building after the geometry is created. So if you for example make a bar oriented east/west and then rotate it 80 degrees, the end result will be a bar just off of being north/south orientation. A positive value rotates clockwise. If you had a party wall assigned to the south facade, after the 80 degree rotation, those party walls would not be 10
|
290
|
+
The `Building Rotation` argument will rotate the building after the geometry is created. So if you for example make a bar oriented east/west and then rotate it 80 degrees, the end result will be a bar just off of being north/south orientation. A positive value rotates clockwise. If you had a party wall assigned to the south facade, after the 80 degree rotation, those party walls would not be 10 degrees south of due west.
|
116
291
|
|
117
292
|
#### Template
|
118
293
|
|
119
|
-
The `Template` is
|
294
|
+
The `Template` is used in OpenStudio measures and the OpenStudio standards gem to refer to a specific target building code standard or vintage. For example ASHRAE 90.1 2004 or the DOE Ref Pre-1980 vintage used for the DOE reference buildings. Template is used here along with the building types selected to define the list and ratios of space types in the model. While generally the space type ratio is the same across different templates there are exceptions to this such as the inclusion of data centers in newer LargeOffice buildings.
|
120
295
|
|
121
296
|
#### Building Shape
|
122
297
|
|
@@ -126,12 +301,12 @@ While the floor area and number of stories arguments determine the size of the b
|
|
126
301
|
*Aspect Ratio of 2.0*
|
127
302
|
|
128
303
|
![Aspect Ratio 1.0](./docs/ar_1.png?raw=true)
|
129
|
-
*Aspect Ratio of
|
304
|
+
*Aspect Ratio of 1.0*
|
130
305
|
|
131
306
|
![Aspect Ratio 0.5](./docs/ar_05.png?raw=true)
|
132
307
|
*Aspect Ratio of 0.5*
|
133
308
|
|
134
|
-
The `Perimeter Multiplier` provides a mechanism to maintain your target footprint floor area and your target aspect ratio while increasing the total exterior perimeter exposure. The intent here is to support, in a simplified way, the impacts of non-rectangular buildings. This is accomplished by adding a second bar when necessary that is turned 90 degrees relative ot the primary bar but maintains the same width. These two building elements are separate from each other and from the custom height bar, if it exists. If you keep the default value of 0.0 the measure will lookup a value inferred from the prototype
|
309
|
+
The `Perimeter Multiplier` provides a mechanism to maintain your target footprint floor area and your target aspect ratio while increasing the total exterior perimeter exposure. The intent here is to support, in a simplified way, the impacts of non-rectangular buildings. This is accomplished by adding a second bar when necessary that is turned 90 degrees relative ot the primary bar but maintains the same width. These two building elements are separate from each other and from the custom height bar, if it exists. If you keep the default value of 0.0 the measure will lookup a value inferred from the prototype building. For most prototype building types this will result in a value of 1.0, because the buildings are rectangular, but for PrimarySchool, SecondarySchool, and Outpatient a value larger than 1.0 will be used. If you use or a smart default of 1.0 applied for this argument you get a single bar. As you increase the multiplier higher than 1.0 it will add a second bar to increase the building perimeter while maintaining both the floor area and the north south to east west aspect ratio. Below is an example of the calculation method. If you use a very small multiplier such as 1.05, a situation may exist that would have too small of a secondary bar to properly model. In this case the single bar will just be extended a bit to achieve the target total perimeter, but will sacrifice meeting the requested north/south versus east/west aspect ratio. In some cases with when the multiplier is not high enough above 1 the ends of the secondary bar may be made adiabatic to achieve target values.
|
135
310
|
|
136
311
|
![Perim Mult b](./docs/perim_mult_2012.png?raw=true)
|
137
312
|
*Aspect Ratio of 2.0 with a Perimeter Multiplier of 1.2. Able to add second bar but needs to have adiabatic ends. See earlier screenshot for Aspect Ratio of 2.0 with Perimeter Multiplier of 1.0*
|
@@ -140,15 +315,15 @@ The `Perimeter Multiplier` provides a mechanism to maintain your target footprin
|
|
140
315
|
*Aspect Ratio of 2.0 with a Perimeter Multiplier of 2.0.*
|
141
316
|
|
142
317
|
`Perimeter Multiplier` example use case:
|
143
|
-
|
144
|
-
|
145
|
-
|
318
|
+
- inputs are for a 10,000 ft^2 2 story building with an aspect ratio of
|
319
|
+
- With a `Perimeter Multiplier` of one this would result in a single bar that is 50' by 100'. This would have a total perimeter of 300'
|
320
|
+
- With a `Perimeter Multiplier` of 1.5 the target perimeter value will be increased to 450'. This would result in two bar elements that have a combined footprint area of 5000 ft^2 (per story) and a combined perimeter of 450'.
|
146
321
|
|
147
|
-
|
322
|
+
Representing for example a U shaped footprint (which might have a "Perimeter Multiplier" of 3 or higher) with a single bar would either under-estimate the perimeter if a reduced bounding box was fit around it to match the area, or over skew the orientation if a single long skinny bar was created with almost all of the exposure in only two opposing cardinal directions. A more common term that could have been used for an argument would have been a 1building perimeter to floor area ratio(P/A)`. That was considered but there could have been incompatible inputs passed in where the target P/A isn't possible for the given footprint area and aspect ratio. A 100' square has a P/A of 0.04 while a 1000' square has a ratio 0.004. In addition to changing with size it would also change with the shape of the rectangle. This measure in uses the multiplier to increase the perimeter of the foorprint(s) given a specified area and aspect ratio above the minim possible rectangular perimeter value. If you just want to make a single bar, you can leave the value at 1.0 and not worry about it. As a last note, if you also are using a custom height bar, that excluded from the calculation of the primary bar(s)
|
148
323
|
|
149
|
-
`Bar Width` can be specified. If you know due to the layout of your building or other factors that you have a specific building width you would like to have you can enter that in the `Bar Width` argument. `Perimeter Multiplier` will be
|
324
|
+
`Bar Width` can be specified. If you know due to the layout of your building or other factors that you have a specific building width you would like to have you can enter that in the `Bar Width` argument. `Perimeter Multiplier` will be ignored when a non-zero `Bar Width` is used. If you leave this argument value at the default value of 0 then it will not impact the model. A non-zero value here will also bypass the `Perimeter Multiplier` argument.
|
150
325
|
|
151
|
-
`Bar Separation Distance Multiplier` is used when there is more than one bar, to specify the distance between the bars as a multiple of the building height. The default value is 10 x the height of the building, but that can be customized here. Currently 0 is not a valid multiplier, since all the intersection, matching, and fenestration occur in the
|
326
|
+
`Bar Separation Distance Multiplier` is used when there is more than one bar, to specify the distance between the bars as a multiple of the building height. The default value is 10 x the height of the building, but that can be customized here. Currently 0 is not a valid multiplier, since all the intersection, matching, and fenestration occur in the individual bar elements. When two bars are required to meet the `Perimeter Multiplier` target they are in configuration of an with the vertical leg to the right of the horizontal leg, like a backwards "L". If a custom height bar was used that will be positioned to the left of the other bars.
|
152
327
|
|
153
328
|
![Sept Dist 0.5](./docs/sep_05.png?raw=true)
|
154
329
|
*Bar Separation Distance Multiplier of 0.5*
|
@@ -168,7 +343,7 @@ There is just a single `Window to Wall Ratio` argument for this measure. It has
|
|
168
343
|
![Custom WWR](./docs/wwr_custom.png?raw=true)
|
169
344
|
*Example of space type specific WWR for warehouse model, shown with custom space type height enabled*
|
170
345
|
|
171
|
-
Orientation specific characteristics and/or overhangs may be added to this in the future, but are
|
346
|
+
Orientation specific characteristics and/or overhangs may be added to this in the future, but are currently possible by adding existing measure to the workflow after this measure. Currently skylights are not directly supported either, but can be added outside of this measure.
|
172
347
|
|
173
348
|
#### Party Walls and Exposure of Top and Bottom Stories
|
174
349
|
|
@@ -178,7 +353,7 @@ There are two approaches for the party walls. One approach is a single fraction
|
|
178
353
|
|
179
354
|
The second approach is ideal when you know more about the conditions of a specific condition and allows you to enter an integer for reach cardinal direction with arguments named `Number of North facing stories with party wall` etc. You can for example have a 5 story building that has a 1 story building to the west, a 3 story building to the east, a 2 story building to the north, and exterior exposure to the south. If you are using this as part of a parametric study where number of stories is changeling and you want all of a specific facade to be adjacent to a building that is taller, You can enter an large value such as 99 for the value; the overly large value relative to number of stories in the building will not create any issues.
|
180
355
|
|
181
|
-
The ability to model what is essence party floor/ceilings in your model are controlled through two bool arguments named `Is the Bottom Story Exposed to Ground` and `Is the Top Story an Exterior Roof`
|
356
|
+
The ability to model what is in essence party floor/ceilings in your model are controlled through two bool arguments named `Is the Bottom Story Exposed to Ground` and `Is the Top Story an Exterior Roof`
|
182
357
|
|
183
358
|
![Party Wall](./docs/party.png?raw=true)
|
184
359
|
*1 story Party wall on south, 2 story on east, story multipliers not enabled*
|
@@ -191,11 +366,11 @@ The ability to model what is essence party floor/ceilings in your model are cont
|
|
191
366
|
|
192
367
|
#### Calculation Methods and Articulation Logic
|
193
368
|
|
194
|
-
- `Calculation Method for Story Multiplier` is used to determine if zone multipliers should be used as story multipliers on taller buildings. This reduces the
|
369
|
+
- `Calculation Method for Story Multiplier` is used to determine if zone multipliers should be used as story multipliers on taller buildings. This reduces the number of zones and should speed up simulations, but may not be appropriate in all cases. If you select a value of `None` then no (non 1) zone multipliers will be used and zones will be modeled for all building stories. The other choice currently available is `Basements Ground Mid Top` which for a building without party walls will never have more than 4 modeled stories regardless of the number of stories. The measure will evaluate uniqueness of stories taking into account party walls and may add additional stories to accommodate this. Note that while the size of space types on a story with a multiplier greater than 1 may appear smaller, they may be larger once the multiplier is applied. More options may be added in the future, specifically vacations of something like `Basements Ground Midx5 Top` that for very tall buildings would and multiple mid-stories vs. a single mid-story.
|
195
370
|
|
196
371
|
- `Make Mid Story Floor Surfaces Adiabatic` determines of surface intersection and surface matching should be applied between stories (when they are adjacent and capable of being matched e.g. story multiplier not used). Setting this to true can reduce the number of surfaces in the model
|
197
372
|
|
198
|
-
- `Division Method for Bar Space Types` is used to determine how the internal zoning and space type division of the bar(s) is approached. The default
|
373
|
+
- `Division Method for Bar Space Types` is used to determine how the internal zoning and space type division of the bar(s) is approached. The default value of `Multiple Space Types - Individual Stories Sliced` is the primary method that should be used. It creates what looks like a core and perimeter model, but slices it up by space type, with large space types moving towards the upper stories. There is some basic logic to minimize small slivers of a space type being created that would create thermal zones with small volumes that may not simulate well. The two largest space types will be at the ends of the bars to minimize having excessive exterior exposure on a zone with a small floor area. `Multiple Space Types - Simple Sliced` is an earlier method that pre-dates the individual sliced stories. The logic is similar but it puts all space types on every building story and creates multiple stories with the exact same slicing logic. `Single Space Type - Core and Perimeter` is not sliced up by space type and isn't relevant for building types with multiple space types. If you do have a building type with only a single space type, like small or medium office, the multiple space type methods will still work. The single space type method will eventually be deprecated.
|
199
374
|
|
200
375
|
![Individualy Sliced](./docs/bar_sliced_indiv.png?raw=true)
|
201
376
|
*Multiple Space Types - Individual Stories Slice method that has been used through the examples above*
|
@@ -206,27 +381,26 @@ The ability to model what is essence party floor/ceilings in your model are cont
|
|
206
381
|
![Single Core Perimeter](./docs/bar_single_core_perim.png?raw=true)
|
207
382
|
*Single Space Type - Core and Perimeter, should not be a reason to use this*
|
208
383
|
|
209
|
-
- The `Double Loaded Corridor`
|
384
|
+
- The `Double Loaded Corridor` argument when enabled, take a circulation space type, when it exists, and pair it with the default space type, and will create a double loaded corridor for the space division and thermal zoning, instead of the typical sliced core and perimeter zoning. This not only alters the geometry of the internal division, but creates a hybrid slice that instead of being a single space type, contains a circulation space type running down the center of the bar, surrounded by spaces of another space type. For an example, with a primary school the corridor will be paired with the classrooms. The width of the corridor is determined to achieve the proper space type ratios of the two space types.
|
385
|
+
- Not enabled for the DEER Building Types as of OpenStudio 3.2.
|
210
386
|
|
211
387
|
![Double Loaded Corridor](./docs/bar_double_loaded.png?raw=true)
|
212
388
|
*Double Loaded Corridor with classroom and corridor for secondary school.*
|
213
389
|
|
214
|
-
- The `Choose Space Type Sorting Method` only comes into play when you are modeling a building with more than one building type. With `Size` selected the space types are organized by size, independent of the building type, with smaller space types on lower stories and larger space types on higher stories. `Building Type > Size` is a newer method that first sorts by
|
390
|
+
- The `Choose Space Type Sorting Method` only comes into play when you are modeling a building with more than one building type. With `Size` selected the space types are organized by size, independent of the building type, with smaller space types on lower stories and larger space types on higher stories. `Building Type > Size` is a newer method that first sorts by building type, putting smaller building types on lower stories, and then within a building type will sort by size. An example use case for this method is when modeling a 4 story building with 25% office and 75% large hotel. With the `Building Type > Size` value the first story will be entirely office, with the rest of the stories large hotel. If the `Size` value is selected, building types wll be mixed together.
|
215
391
|
|
216
392
|
![Sort Space Types by Building Types](./docs/story_sort.png?raw=true)
|
217
393
|
*Building Type > Size used to sort by buiding types, and then by space types.*
|
218
394
|
|
219
|
-
- `Use Upstream Argument Values` can be left at the default value of true for most cases. This argument shows up in a number of measures, and then intent is to enable the synchronization of arguments that may be used as a variable in a parametric study across multiple measures. Generally
|
220
|
-
|
221
|
-
- `Climate Zone` is not used at all by this measure but is necessary for an obscure reason
|
395
|
+
- `Use Upstream Argument Values` can be left at the default value of true for most cases. This argument shows up in a number of measures, and then intent is to enable the synchronization of arguments that may be used as a variable in a parametric study across multiple measures. Generally a measures has unique argument names that don't exist in other measures, but some such ase `template` are used frequently. This argument, when set to true, will use the value of `template` from an earlier measure in the workflow, if found, in place of what is entered as the argument value for this measure.
|
222
396
|
|
223
397
|
## Development Comments
|
224
398
|
|
225
|
-
This measure relies on the openstudio-standards gem which is included in the OpenStudio CLI as well as a number of resources files listed below that are contained in the
|
226
|
-
|
227
|
-
|
228
|
-
|
229
|
-
|
399
|
+
This measure relies on the openstudio-standards gem which is included in the OpenStudio CLI as well as a number of resources files listed below that are contained in the openstudio-extension gem which is also included in the OpenStudio CLI. Other than the arguments almost none of the measure code is in the measure.rb file. The resource files are used by a number of measures and should be updated from the shared library and not within this measure.
|
400
|
+
- os_lib_model_generation.rb
|
401
|
+
- os_lib_model_simplification.rb
|
402
|
+
- os_lib_geometry.rb
|
403
|
+
- os_lib_helper_methods.rb
|
230
404
|
|
231
405
|
___
|
232
406
|
|
@@ -243,6 +417,9 @@ ___
|
|
243
417
|
**Required:** true,
|
244
418
|
**Model Dependent:** false
|
245
419
|
|
420
|
+
**Choice Display Names** ["Asm", "DMo", "ECC", "EPr", "ERC", "ESe", "EUn", "GHs", "Gro", "Hsp", "Htl", "MBT", "MFm", "MLI", "Mtl", "Nrs", "OfL", "OfS", "RFF", "RSD", "Rt3", "RtL", "RtS", "SCn", "SFm", "SUn", "WRf"]
|
421
|
+
|
422
|
+
|
246
423
|
### Building Type B
|
247
424
|
|
248
425
|
**Name:** bldg_type_b,
|
@@ -251,6 +428,9 @@ ___
|
|
251
428
|
**Required:** true,
|
252
429
|
**Model Dependent:** false
|
253
430
|
|
431
|
+
**Choice Display Names** ["Asm", "DMo", "ECC", "EPr", "ERC", "ESe", "EUn", "GHs", "Gro", "Hsp", "Htl", "MBT", "MFm", "MLI", "Mtl", "Nrs", "OfL", "OfS", "RFF", "RSD", "Rt3", "RtL", "RtS", "SCn", "SFm", "SUn", "WRf"]
|
432
|
+
|
433
|
+
|
254
434
|
### Building Type B Fraction of Building Floor Area
|
255
435
|
|
256
436
|
**Name:** bldg_type_b_fract_bldg_area,
|
@@ -259,6 +439,7 @@ ___
|
|
259
439
|
**Required:** true,
|
260
440
|
**Model Dependent:** false
|
261
441
|
|
442
|
+
|
262
443
|
### Building Type C
|
263
444
|
|
264
445
|
**Name:** bldg_type_c,
|
@@ -267,6 +448,9 @@ ___
|
|
267
448
|
**Required:** true,
|
268
449
|
**Model Dependent:** false
|
269
450
|
|
451
|
+
**Choice Display Names** ["Asm", "DMo", "ECC", "EPr", "ERC", "ESe", "EUn", "GHs", "Gro", "Hsp", "Htl", "MBT", "MFm", "MLI", "Mtl", "Nrs", "OfL", "OfS", "RFF", "RSD", "Rt3", "RtL", "RtS", "SCn", "SFm", "SUn", "WRf"]
|
452
|
+
|
453
|
+
|
270
454
|
### Building Type C Fraction of Building Floor Area
|
271
455
|
|
272
456
|
**Name:** bldg_type_c_fract_bldg_area,
|
@@ -275,6 +459,7 @@ ___
|
|
275
459
|
**Required:** true,
|
276
460
|
**Model Dependent:** false
|
277
461
|
|
462
|
+
|
278
463
|
### Building Type D
|
279
464
|
|
280
465
|
**Name:** bldg_type_d,
|
@@ -283,6 +468,9 @@ ___
|
|
283
468
|
**Required:** true,
|
284
469
|
**Model Dependent:** false
|
285
470
|
|
471
|
+
**Choice Display Names** ["Asm", "DMo", "ECC", "EPr", "ERC", "ESe", "EUn", "GHs", "Gro", "Hsp", "Htl", "MBT", "MFm", "MLI", "Mtl", "Nrs", "OfL", "OfS", "RFF", "RSD", "Rt3", "RtL", "RtS", "SCn", "SFm", "SUn", "WRf"]
|
472
|
+
|
473
|
+
|
286
474
|
### Building Type D Fraction of Building Floor Area
|
287
475
|
|
288
476
|
**Name:** bldg_type_d_fract_bldg_area,
|
@@ -291,6 +479,7 @@ ___
|
|
291
479
|
**Required:** true,
|
292
480
|
**Model Dependent:** false
|
293
481
|
|
482
|
+
|
294
483
|
### Total Building Floor Area
|
295
484
|
|
296
485
|
**Name:** total_bldg_floor_area,
|
@@ -299,6 +488,7 @@ ___
|
|
299
488
|
**Required:** true,
|
300
489
|
**Model Dependent:** false
|
301
490
|
|
491
|
+
|
302
492
|
### Single Floor Area
|
303
493
|
Non-zero value will fix the single floor area, overriding a user entry for Total Building Floor Area
|
304
494
|
**Name:** single_floor_area,
|
@@ -307,6 +497,7 @@ Non-zero value will fix the single floor area, overriding a user entry for Total
|
|
307
497
|
**Required:** true,
|
308
498
|
**Model Dependent:** false
|
309
499
|
|
500
|
+
|
310
501
|
### Typical Floor to FLoor Height
|
311
502
|
Selecting a typical floor height of 0 will trigger a smart building type default.
|
312
503
|
**Name:** floor_height,
|
@@ -315,6 +506,7 @@ Selecting a typical floor height of 0 will trigger a smart building type default
|
|
315
506
|
**Required:** true,
|
316
507
|
**Model Dependent:** false
|
317
508
|
|
509
|
+
|
318
510
|
### Enable Custom Height Bar Application
|
319
511
|
This is argument value is only relevant when smart default floor to floor height is used for a building type that has spaces with custom heights.
|
320
512
|
**Name:** custom_height_bar,
|
@@ -323,6 +515,7 @@ This is argument value is only relevant when smart default floor to floor height
|
|
323
515
|
**Required:** true,
|
324
516
|
**Model Dependent:** false
|
325
517
|
|
518
|
+
|
326
519
|
### Number of Stories Above Grade
|
327
520
|
|
328
521
|
**Name:** num_stories_above_grade,
|
@@ -331,6 +524,7 @@ This is argument value is only relevant when smart default floor to floor height
|
|
331
524
|
**Required:** true,
|
332
525
|
**Model Dependent:** false
|
333
526
|
|
527
|
+
|
334
528
|
### Number of Stories Below Grade
|
335
529
|
|
336
530
|
**Name:** num_stories_below_grade,
|
@@ -339,6 +533,7 @@ This is argument value is only relevant when smart default floor to floor height
|
|
339
533
|
**Required:** true,
|
340
534
|
**Model Dependent:** false
|
341
535
|
|
536
|
+
|
342
537
|
### Building Rotation
|
343
538
|
Set Building Rotation off of North (positive value is clockwise). Rotation applied after geometry generation. Values greater than +/- 45 will result in aspect ratio and party wall orientations that do not match cardinal directions of the inputs.
|
344
539
|
**Name:** building_rotation,
|
@@ -347,6 +542,7 @@ Set Building Rotation off of North (positive value is clockwise). Rotation appli
|
|
347
542
|
**Required:** true,
|
348
543
|
**Model Dependent:** false
|
349
544
|
|
545
|
+
|
350
546
|
### Target Standard
|
351
547
|
|
352
548
|
**Name:** template,
|
@@ -355,6 +551,9 @@ Set Building Rotation off of North (positive value is clockwise). Rotation appli
|
|
355
551
|
**Required:** true,
|
356
552
|
**Model Dependent:** false
|
357
553
|
|
554
|
+
**Choice Display Names** ["DEER Pre-1975", "DEER 1985", "DEER 1996", "DEER 2003", "DEER 2007", "DEER 2011", "DEER 2014", "DEER 2015", "DEER 2017", "DEER 2020"]
|
555
|
+
|
556
|
+
|
358
557
|
### Ratio of North/South Facade Length Relative to East/West Facade Length
|
359
558
|
Selecting an aspect ratio of 0 will trigger a smart building type default. Aspect ratios less than one are not recommended for sliced bar geometry, instead rotate building and use a greater than 1 aspect ratio.
|
360
559
|
**Name:** ns_to_ew_ratio,
|
@@ -363,6 +562,7 @@ Selecting an aspect ratio of 0 will trigger a smart building type default. Aspec
|
|
363
562
|
**Required:** true,
|
364
563
|
**Model Dependent:** false
|
365
564
|
|
565
|
+
|
366
566
|
### Perimeter Multiplier
|
367
567
|
Selecting a value of 0 will trigger a smart building type default. This represents a multiplier for the building perimeter relative to the perimeter of a rectangular building that meets the area and aspect ratio inputs. Other than the smart default of 0.0 this argument should have a value of 1.0 or higher and is only applicable Multiple Space Types - Individual Stories Sliced division method.
|
368
568
|
**Name:** perim_mult,
|
@@ -371,6 +571,7 @@ Selecting a value of 0 will trigger a smart building type default. This represen
|
|
371
571
|
**Required:** true,
|
372
572
|
**Model Dependent:** false
|
373
573
|
|
574
|
+
|
374
575
|
### Bar Width
|
375
576
|
Non-zero value will fix the building width, overriding user entry for Perimeter Multiplier. NS/EW Aspect Ratio may be limited based on target width.
|
376
577
|
**Name:** bar_width,
|
@@ -379,6 +580,7 @@ Non-zero value will fix the building width, overriding user entry for Perimeter
|
|
379
580
|
**Required:** true,
|
380
581
|
**Model Dependent:** false
|
381
582
|
|
583
|
+
|
382
584
|
### Bar Separation Distance Multiplier
|
383
585
|
Multiplier of separation between bar elements relative to building height.
|
384
586
|
**Name:** bar_sep_dist_mult,
|
@@ -387,6 +589,7 @@ Multiplier of separation between bar elements relative to building height.
|
|
387
589
|
**Required:** true,
|
388
590
|
**Model Dependent:** false
|
389
591
|
|
592
|
+
|
390
593
|
### Window to Wall Ratio
|
391
594
|
Selecting a window to wall ratio of 0 will trigger a smart building type default.
|
392
595
|
**Name:** wwr,
|
@@ -395,6 +598,7 @@ Selecting a window to wall ratio of 0 will trigger a smart building type default
|
|
395
598
|
**Required:** true,
|
396
599
|
**Model Dependent:** false
|
397
600
|
|
601
|
+
|
398
602
|
### Fraction of Exterior Wall Area with Adjacent Structure
|
399
603
|
This will impact how many above grade exterior walls are modeled with adiabatic boundary condition.
|
400
604
|
**Name:** party_wall_fraction,
|
@@ -403,6 +607,7 @@ This will impact how many above grade exterior walls are modeled with adiabatic
|
|
403
607
|
**Required:** true,
|
404
608
|
**Model Dependent:** false
|
405
609
|
|
610
|
+
|
406
611
|
### Number of North facing stories with party wall
|
407
612
|
This will impact how many above grade exterior north walls are modeled with adiabatic boundary condition. If this is less than the number of above grade stoes, upper flor will reamin exterior
|
408
613
|
**Name:** party_wall_stories_north,
|
@@ -411,6 +616,7 @@ This will impact how many above grade exterior north walls are modeled with adia
|
|
411
616
|
**Required:** true,
|
412
617
|
**Model Dependent:** false
|
413
618
|
|
619
|
+
|
414
620
|
### Number of South facing stories with party wall
|
415
621
|
This will impact how many above grade exterior south walls are modeled with adiabatic boundary condition. If this is less than the number of above grade stoes, upper flor will reamin exterior
|
416
622
|
**Name:** party_wall_stories_south,
|
@@ -419,6 +625,7 @@ This will impact how many above grade exterior south walls are modeled with adia
|
|
419
625
|
**Required:** true,
|
420
626
|
**Model Dependent:** false
|
421
627
|
|
628
|
+
|
422
629
|
### Number of East facing stories with party wall
|
423
630
|
This will impact how many above grade exterior east walls are modeled with adiabatic boundary condition. If this is less than the number of above grade stoes, upper flor will reamin exterior
|
424
631
|
**Name:** party_wall_stories_east,
|
@@ -427,6 +634,7 @@ This will impact how many above grade exterior east walls are modeled with adiab
|
|
427
634
|
**Required:** true,
|
428
635
|
**Model Dependent:** false
|
429
636
|
|
637
|
+
|
430
638
|
### Number of West facing stories with party wall
|
431
639
|
This will impact how many above grade exterior west walls are modeled with adiabatic boundary condition. If this is less than the number of above grade stoes, upper flor will reamin exterior
|
432
640
|
**Name:** party_wall_stories_west,
|
@@ -435,6 +643,7 @@ This will impact how many above grade exterior west walls are modeled with adiab
|
|
435
643
|
**Required:** true,
|
436
644
|
**Model Dependent:** false
|
437
645
|
|
646
|
+
|
438
647
|
### Is the Bottom Story Exposed to Ground
|
439
648
|
This should be true unless you are modeling a partial building which doesn't include the lowest story. The bottom story floor will have an adiabatic boundary condition when false.
|
440
649
|
**Name:** bottom_story_ground_exposed_floor,
|
@@ -443,6 +652,7 @@ This should be true unless you are modeling a partial building which doesn't inc
|
|
443
652
|
**Required:** true,
|
444
653
|
**Model Dependent:** false
|
445
654
|
|
655
|
+
|
446
656
|
### Is the Top Story an Exterior Roof
|
447
657
|
This should be true unless you are modeling a partial building which doesn't include the highest story. The top story ceiling will have an adiabatic boundary condition when false.
|
448
658
|
**Name:** top_story_exterior_exposed_roof,
|
@@ -451,6 +661,7 @@ This should be true unless you are modeling a partial building which doesn't inc
|
|
451
661
|
**Required:** true,
|
452
662
|
**Model Dependent:** false
|
453
663
|
|
664
|
+
|
454
665
|
### Calculation Method for Story Multiplier
|
455
666
|
|
456
667
|
**Name:** story_multiplier,
|
@@ -459,6 +670,9 @@ This should be true unless you are modeling a partial building which doesn't inc
|
|
459
670
|
**Required:** true,
|
460
671
|
**Model Dependent:** false
|
461
672
|
|
673
|
+
**Choice Display Names** ["None", "Basements Ground Mid Top"]
|
674
|
+
|
675
|
+
|
462
676
|
### Make Mid Story Floor Surfaces Adiabatic
|
463
677
|
If set to true, this will skip surface intersection and make mid story floors and celings adiabatic, not just at multiplied gaps.
|
464
678
|
**Name:** make_mid_story_surfaces_adiabatic,
|
@@ -467,6 +681,7 @@ If set to true, this will skip surface intersection and make mid story floors an
|
|
467
681
|
**Required:** true,
|
468
682
|
**Model Dependent:** false
|
469
683
|
|
684
|
+
|
470
685
|
### Division Method for Bar Space Types
|
471
686
|
To use perimeter multiplier greater than 1 selected Multiple Space Types - Individual Stories Sliced.
|
472
687
|
**Name:** bar_division_method,
|
@@ -475,6 +690,9 @@ To use perimeter multiplier greater than 1 selected Multiple Space Types - Indiv
|
|
475
690
|
**Required:** true,
|
476
691
|
**Model Dependent:** false
|
477
692
|
|
693
|
+
**Choice Display Names** ["Multiple Space Types - Simple Sliced", "Multiple Space Types - Individual Stories Sliced", "Single Space Type - Core and Perimeter"]
|
694
|
+
|
695
|
+
|
478
696
|
### Choose Space Type Sorting Method
|
479
697
|
|
480
698
|
**Name:** space_type_sort_logic,
|
@@ -483,6 +701,9 @@ To use perimeter multiplier greater than 1 selected Multiple Space Types - Indiv
|
|
483
701
|
**Required:** true,
|
484
702
|
**Model Dependent:** false
|
485
703
|
|
704
|
+
**Choice Display Names** ["Size", "Building Type > Size"]
|
705
|
+
|
706
|
+
|
486
707
|
### Use Upstream Argument Values
|
487
708
|
When true this will look for arguments or registerValues in upstream measures that match arguments from this measure, and will use the value from the upstream measure in place of what is entered for this measure.
|
488
709
|
**Name:** use_upstream_args,
|
@@ -494,3 +715,4 @@ When true this will look for arguments or registerValues in upstream measures th
|
|
494
715
|
|
495
716
|
|
496
717
|
|
718
|
+
|