urbanopt-geojson 0.7.0 → 0.8.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (44) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +1 -0
  3. data/CHANGELOG.md +22 -0
  4. data/LICENSE.md +1 -1
  5. data/doc_templates/LICENSE.md +1 -1
  6. data/doc_templates/copyright_erb.txt +1 -1
  7. data/doc_templates/copyright_js.txt +2 -2
  8. data/doc_templates/copyright_ruby.txt +1 -1
  9. data/docs/package-lock.json +15961 -1719
  10. data/lib/measures/urban_geometry_creation/measure.rb +1 -1
  11. data/lib/measures/urban_geometry_creation_zoning/measure.rb +1 -1
  12. data/lib/urbanopt/geojson/building.rb +1 -1
  13. data/lib/urbanopt/geojson/derived_extension.rb +1 -1
  14. data/lib/urbanopt/geojson/district_system.rb +1 -1
  15. data/lib/urbanopt/geojson/feature.rb +2 -2
  16. data/lib/urbanopt/geojson/geo_file.rb +18 -3
  17. data/lib/urbanopt/geojson/helper.rb +1 -1
  18. data/lib/urbanopt/geojson/logging.rb +1 -1
  19. data/lib/urbanopt/geojson/mapper_classes.rb +1 -1
  20. data/lib/urbanopt/geojson/model.rb +1 -1
  21. data/lib/urbanopt/geojson/region.rb +1 -1
  22. data/lib/urbanopt/geojson/scale_area.rb +1 -1
  23. data/lib/urbanopt/geojson/schema/breaker_properties.json +33 -0
  24. data/lib/urbanopt/geojson/schema/building_properties.json +641 -591
  25. data/lib/urbanopt/geojson/schema/capacitor_properties.json +38 -0
  26. data/lib/urbanopt/geojson/schema/consumer_properties.json +58 -0
  27. data/lib/urbanopt/geojson/schema/distribution_generator.json +45 -0
  28. data/lib/urbanopt/geojson/schema/distribution_transformer.json +54 -0
  29. data/lib/urbanopt/geojson/schema/district_system_properties.json +10 -15
  30. data/lib/urbanopt/geojson/schema/dummy_node_properties.json +21 -0
  31. data/lib/urbanopt/geojson/schema/electrical_connector_properties.json +6 -135
  32. data/lib/urbanopt/geojson/schema/hvmv_substation_properties.json +54 -0
  33. data/lib/urbanopt/geojson/schema/line_properties.json +69 -0
  34. data/lib/urbanopt/geojson/schema/region_properties.json +1 -1
  35. data/lib/urbanopt/geojson/schema/site_properties.json +126 -98
  36. data/lib/urbanopt/geojson/schema/switch_properties.json +33 -0
  37. data/lib/urbanopt/geojson/update_areas.rb +1 -1
  38. data/lib/urbanopt/geojson/validate_geojson.rb +1 -1
  39. data/lib/urbanopt/geojson/version.rb +2 -2
  40. data/lib/urbanopt/geojson/zoning.rb +1 -1
  41. data/lib/urbanopt/geojson.rb +1 -1
  42. data/lib/urbanopt-geojson.rb +1 -1
  43. data/urbanopt-geojson-gem.gemspec +1 -1
  44. metadata +13 -4
@@ -1,593 +1,643 @@
1
1
  {
2
- "$schema": "http://json-schema.org/draft-04/schema#",
3
- "id": "http://json-schema.org/openstudio-urban-modeling/building_properties.json#",
4
- "title": "URBANopt Building",
5
- "description": "Schema for an URBANopt Building object",
6
- "type": "object",
7
- "properties": {
8
- "id": {
9
- "description": "Unique id used to refer to this feature within this dataset.",
10
- "type": "string"
11
- },
12
- "project_id": {
13
- "description": "Project which this feature belongs to.",
14
- "type": "string"
15
- },
16
- "type": {
17
- "description": "Type of feature.",
18
- "type": "string",
19
- "enum": [
20
- "Building"
21
- ]
22
- },
23
- "source_name": {
24
- "description": "Name of the original data source.",
25
- "type": "string"
26
- },
27
- "source_id": {
28
- "description": "Id of the feature in original data source.",
29
- "type": "string"
30
- },
31
- "name": {
32
- "description": "Feature name.",
33
- "type": "string"
34
- },
35
- "legal_name": {
36
- "description": "Legal name used to identify this feature.",
37
- "type": "string"
38
- },
39
- "address": {
40
- "description": "Street address.",
41
- "type": "string"
42
- },
43
- "building_status": {
44
- "description": "Building status.",
45
- "type": "string",
46
- "enum": [
47
- "Proposed",
48
- "Existing"
49
- ]
50
- },
51
- "detailed_model_filename": {
52
- "description": "Name of a detailed model which can be loaded from disk as a seed model or complete model. Mapper class decides which measures to disable if this is present.",
53
- "type": "string"
54
- },
55
- "weather_filename": {
56
- "description": "Name of EPW weather file for this building. Defaults to site's weather_filename.",
57
- "type": "string"
58
- },
59
- "tariff_filename": {
60
- "description": "Name of the tariff file for this building. Defaults to site's tariff_filename.",
61
- "type": "string"
62
- },
63
- "surface_elevation": {
64
- "description": "The surface elevation (above NAVD88 datum) of the building (ft). This is the elevation of the ground at the building location, any below ground stories will be lower than this. Defaults to site's surface_elevation.",
65
- "type": "number"
66
- },
67
- "timesteps_per_hour": {
68
- "description": "Number of timesteps per hour for energy simulations. Defaults to site's timesteps_per_hour.",
69
- "type": "integer",
70
- "minimum": 1,
71
- "maximum": 60
72
- },
73
- "begin_date": {
74
- "description": "Date to begin simulation, format YYYY-MM-DD. Defaults to site's begin_date.",
75
- "type": "string"
76
- },
77
- "end_date": {
78
- "description": "Date to end simulation, format YYYY-MM-DD. Defaults to site's end_date.",
79
- "type": "string"
80
- },
81
- "climate_zone": {
82
- "description": "ASHRAE 169 climate zone. Defaults to site's climate_zone",
83
- "type": "string"
84
- },
85
- "cec_climate_zone": {
86
- "description": "CEC Title24 climate zone. Defaults to site's cec_climate_zone",
87
- "type": "string"
88
- },
89
- "floor_area": {
90
- "description": "Usable floor area (ft^2). Required for residential buildings, this represents conditioned floor area.",
91
- "type": "number"
92
- },
93
- "number_of_stories": {
94
- "description": "The maximum number of building stories, sum of number of above and below ground stories.",
95
- "type": "integer"
96
- },
97
- "number_of_stories_above_ground": {
98
- "description": "The number of building stories above ground. Defaults to number_of_stories. Required for residential buildings.",
99
- "type": "integer"
100
- },
101
- "maximum_roof_height": {
102
- "description": "Maximum height of the roof relative to surface elevation (ft)",
103
- "type": "number"
104
- },
105
- "roof_type": {
106
- "description": "The type of roof. Defaults to flat.",
107
- "type": "string",
108
- "enum": [
109
- "Flat",
110
- "Gable",
111
- "Hip"
112
- ]
113
- },
114
- "foundation_type": {
115
- "$ref": "#/definitions/foundationType"
116
- },
117
- "attic_type": {
118
- "$ref": "#/definitions/atticType"
119
- },
120
- "footprint_area": {
121
- "description": "Area of the footprint (ft^2). Calculated on export.",
122
- "type": "number"
123
- },
124
- "footprint_perimeter": {
125
- "description": "Perimeter of the footprint (ft). Calculated on export.",
126
- "type": "number"
127
- },
128
- "year_built": {
129
- "description": "The year construction of the building was completed. Can be in the future to indicate future build out. Defaults to current year.",
130
- "type": "integer"
131
- },
132
- "template": {
133
- "$ref": "#/definitions/templateType"
134
- },
135
- "building_type": {
136
- "$ref": "#/definitions/buildingType"
137
- },
138
- "system_type": {
139
- "$ref": "#/definitions/systemType"
140
- },
141
- "heating_system_fuel_type": {
142
- "$ref": "#/definitions/heatingSystemFuelType"
143
- },
144
- "weekday_start_time": {
145
- "description": "Weekday operating hours start time in 08:30 format, using 24-hr clock. Leave blank to use default.",
146
- "type": "string"
147
- },
148
- "weekday_duration": {
149
- "description": "Length of weekend operating hours in 08:30 format, up to 24:00.",
150
- "type": "string"
151
- },
152
- "weekend_start_time": {
153
- "description": "Weekend operating hours start time in 08:30 format, using 24-hr clock. Leave blank to use default.",
154
- "type": "string"
155
- },
156
- "weekend_duration": {
157
- "description": "Length of weekend operating hours in 08:30 format, up to 24:00.",
158
- "type": "string"
159
- },
160
- "mixed_type_1": {
161
- "$ref": "#/definitions/buildingType"
162
- },
163
- "mixed_type_1_percentage": {
164
- "description": "Percentage of 1st mixed building space type. Only used when building_type is Mixed use.",
165
- "type": "number",
166
- "minimum": 0,
167
- "maximum": 100
168
- },
169
- "mixed_type_2": {
170
- "$ref": "#/definitions/buildingType"
171
- },
172
- "mixed_type_2_percentage": {
173
- "description": "Percentage of 2nd mixed building space type. Only used when building_type is Mixed use.",
174
- "type": "number",
175
- "minimum": 0,
176
- "maximum": 100
177
- },
178
- "mixed_type_3": {
179
- "$ref": "#/definitions/buildingType"
180
- },
181
- "mixed_type_3_percentage": {
182
- "description": "Percentage of 3rd mixed building space type. Only used when building_type is Mixed use.",
183
- "type": "number",
184
- "minimum": 0,
185
- "maximum": 100
186
- },
187
- "mixed_type_4": {
188
- "$ref": "#/definitions/buildingType"
189
- },
190
- "mixed_type_4_percentage": {
191
- "description": "Percentage of 4th mixed building space type. Only used when building_type is Mixed use.",
192
- "type": "number",
193
- "minimum": 0,
194
- "maximum": 100
195
- },
196
- "number_of_residential_units": {
197
- "description": "Total number of residential units in the building. Required for single-family attached and multifamily residential buildings.",
198
- "type": "integer"
199
- },
200
- "number_of_bedrooms": {
201
- "description": "Total number of bedrooms in the building. Required for residential buildings. Must be divisible by the number of residential units.",
202
- "type": "integer"
203
- },
204
- "exterior_lighting_zone": {
205
- "description": "Choice of exterior lighting zone.",
206
- "type": "string",
207
- "enum": [
208
- "0 - Undeveloped Areas Parks",
209
- "1 - Developed Areas Parks",
210
- "2 - Neighborhood",
211
- "3 - All Other Areas",
212
- "4 - High Activity"
213
- ]
214
- },
215
- "onsite_parking_fraction": {
216
- "description": "Fraction of building parking to include in this model. Choose 1 to include exterior lights for parking in this building model. Choose 0 if parking is modeled separately.",
217
- "type": "number",
218
- "minimum": 0,
219
- "maximum": 1
220
- },
221
- "power_factor": {
222
- "description": "Ratio of the real power used by building to the apparent power seen by grid.",
223
- "type": "number",
224
- "minimum": 0
225
- },
226
- "user_data": {
227
- "description": "Arbitrary user data"
228
- },
229
- "ev_charging": {
230
- "description": "Should be set to true if EV charging is associated with the building.",
231
- "type": "boolean"
232
- },
233
- "ev_charging_station_type": {
234
- "description": "Indicates whether EV charging associated with the building is for Typical Home, Public or Work charging station",
235
- "type": "string",
236
- "enum": [
237
- "Typical Home",
238
- "Typical Public",
239
- "Typical Work"
240
- ]
241
- },
242
- "delay_type": {
243
- "description": "Adds workplace charging flexibility for different scenarios. Min delay scenario indicates EV charging immediately upon arriving to work, Max delay indicates not charging until necessary thereby shifting EV charging load to later in the day and Min power indicates charging EVs at a minimum rate over the parking event.",
244
- "type": "string",
245
- "enum": [
246
- "Min Delay",
247
- "Max Delay",
248
- "Min Power"
249
- ]
250
- },
251
- "ev_charging_behavior": {
252
- "description": "Describes scenarios for EV charging behavior, Business as Usual implies home dominant charging behavior, Free Workplace Charging at Project Site implies peak power draw from EV charging during morning hours due to EV charging at workplaces and Free Workplace Charging Across Metro Area scenario reduces Home EV charging relative to Free Workplace Charging at Project Site for residents who work elsewhere and can charge their vehicles for free at those workplaces.",
253
- "type": "string",
254
- "enum": [
255
- "Business as Usual",
256
- "Free Workplace Charging at Project Site",
257
- "Free Workplace Charging Across Metro Area"
258
- ]
259
- },
260
- "ev_percent": {
261
- "description": "Denotes the % of vehicles parked at the building that are EVs.",
262
- "type": "number"
263
- },
264
- "ev_curtailment_frac": {
265
- "description": "Fraction between 0 and 1 that denotes curtailment of EV charging load to better align EV charging with expected energy production from a solar PV system",
266
- "type": "number"
267
- }
268
- },
269
- "oneOf": [
270
- {
271
- "properties": {
272
- "building_type": {
273
- "enum": [
274
- "Single-Family Detached"
275
- ]
276
- }
277
- },
278
- "required": [
279
- "id",
280
- "type",
281
- "name",
282
- "floor_area",
283
- "number_of_stories_above_ground",
284
- "number_of_stories",
285
- "building_type",
286
- "number_of_bedrooms",
287
- "foundation_type",
288
- "attic_type"
289
- ]
290
- },
291
- {
292
- "properties": {
293
- "building_type": {
294
- "enum": [
295
- "Single-Family Attached"
296
- ]
297
- }
298
- },
299
- "required": [
300
- "id",
301
- "type",
302
- "name",
303
- "floor_area",
304
- "number_of_stories_above_ground",
305
- "number_of_stories",
306
- "building_type",
307
- "number_of_residential_units",
308
- "number_of_bedrooms",
309
- "foundation_type",
310
- "attic_type"
311
- ]
312
- },
313
- {
314
- "properties": {
315
- "building_type": {
316
- "enum": [
317
- "Multifamily"
318
- ]
319
- }
320
- },
321
- "required": [
322
- "id",
323
- "type",
324
- "name",
325
- "floor_area",
326
- "number_of_stories_above_ground",
327
- "number_of_stories",
328
- "building_type",
329
- "number_of_residential_units",
330
- "number_of_bedrooms",
331
- "foundation_type"
332
- ]
333
- },
334
- {
335
- "properties": {
336
- "building_type": {
337
- "enum": [
338
- "Single-Family",
339
- "Multifamily (2 to 4 units)",
340
- "Multifamily (5 or more units)",
341
- "Vacant",
342
- "Office",
343
- "Laboratory",
344
- "Nonrefrigerated warehouse",
345
- "Food sales",
346
- "Public order and safety",
347
- "Outpatient health care",
348
- "Refrigerated warehouse",
349
- "Religious worship",
350
- "Public assembly",
351
- "Education",
352
- "Food service",
353
- "Inpatient health care",
354
- "Nursing",
355
- "Lodging",
356
- "Strip shopping mall",
357
- "Enclosed mall",
358
- "Retail other than mall",
359
- "Service",
360
- "Mixed use",
361
- "Uncovered Parking",
362
- "Covered Parking"
363
- ]
364
- }
365
- },
366
- "required": [
367
- "id",
368
- "type",
369
- "name",
370
- "floor_area",
371
- "number_of_stories",
372
- "footprint_area",
373
- "building_type"
374
- ]
375
- }
376
- ],
377
- "additionalProperties": true,
378
- "definitions": {
379
- "buildingType": {
380
- "description": "Primary building space type.",
381
- "type": "string",
382
- "enum": [
383
- "Single-Family Detached",
384
- "Single-Family Attached",
385
- "Multifamily",
386
- "Single-Family",
387
- "Multifamily (2 to 4 units)",
388
- "Multifamily (5 or more units)",
389
- "Vacant",
390
- "Office",
391
- "Laboratory",
392
- "Nonrefrigerated warehouse",
393
- "Food sales",
394
- "Public order and safety",
395
- "Outpatient health care",
396
- "Refrigerated warehouse",
397
- "Religious worship",
398
- "Public assembly",
399
- "Education",
400
- "Food service",
401
- "Inpatient health care",
402
- "Nursing",
403
- "Lodging",
404
- "Strip shopping mall",
405
- "Enclosed mall",
406
- "Retail other than mall",
407
- "Service",
408
- "Mixed use",
409
- "Uncovered Parking",
410
- "Covered Parking",
411
- "null"
412
- ]
413
- },
414
- "systemType": {
415
- "description": "Building HVAC system type.",
416
- "type": "string",
417
- "enum": [
418
- "PTAC with baseboard electric",
419
- "PTAC with baseboard gas boiler",
420
- "PTAC with baseboard district hot water",
421
- "PTAC with gas unit heaters",
422
- "PTAC with electric coil",
423
- "PTAC with gas coil",
424
- "PTAC with gas boiler",
425
- "PTAC with no heat",
426
- "PTAC with district hot water",
427
- "PTAC with central air source heat pump",
428
- "PTHP",
429
- "PSZ-AC with gas coil",
430
- "PSZ-AC with baseboard electric",
431
- "PSZ-AC with no heat",
432
- "PSZ-AC with district hot water",
433
- "PSZ-AC with central air source heat pump",
434
- "PSZ-HP",
435
- "Fan coil district chilled water with no heat",
436
- "Fan coil district chilled water with boiler",
437
- "Fan coil district chilled water with central air source heat pump",
438
- "Fan coil district chilled water with gas unit heaters",
439
- "Fan coil district chilled water with baseboard electric",
440
- "Fan coil district chilled water with district hot water",
441
- "Fan coil chiller with district hot water",
442
- "Fan coil air-cooled chiller with district hot water",
443
- "Fan coil chiller with boiler",
444
- "Fan coil air-cooled chiller with boiler",
445
- "Fan coil chiller with central air source heat pump",
446
- "Fan coil air-cooled chiller with central air source heat pump",
447
- "Fan coil chiller with no heat",
448
- "DOAS with fan coil district chilled water with no heat",
449
- "DOAS with fan coil district chilled water and boiler",
450
- "DOAS with fan coil district chilled water with central air source heat pump",
451
- "DOAS with fan coil district chilled water with gas unit heaters",
452
- "DOAS with fan coil district chilled water with baseboard electric",
453
- "DOAS with fan coil district chilled water with district hot water",
454
- "DOAS with fan coil chiller with district hot water",
455
- "DOAS with fan coil air-cooled chiller with district hot water",
456
- "DOAS with fan coil air-cooled chiller with boiler",
457
- "DOAS with fan coil chiller with central air source heat pump",
458
- "DOAS with fan coil air-cooled chiller with central air source heat pump",
459
- "DOAS with fan coil chiller with no heat",
460
- "DOAS with VRF",
461
- "VRF",
462
- "DOAS with water source heat pumps with ground source heat pump",
463
- "Forced air furnace",
464
- "Baseboard district hot water",
465
- "Baseboard electric",
466
- "Baseboard gas boiler",
467
- "Baseboard central air source heat pump",
468
- "Window AC with no heat",
469
- "Window AC with forced air furnace",
470
- "Window AC with baseboard district hot water",
471
- "Window AC with baseboard electric",
472
- "Window AC with unit heaters",
473
- "Window AC with baseboard gas boiler",
474
- "Window AC with baseboard central air source heat pump",
475
- "Direct evap coolers with baseboard district hot water",
476
- "Direct evap coolers with baseboard electric",
477
- "Direct evap coolers with baseboard gas boiler",
478
- "Direct evap coolers with baseboard central air source heat pump",
479
- "Direct evap coolers with no heat",
480
- "Direct evap coolers with gas unit heaters",
481
- "Direct evap coolers with forced air furnace",
482
- "Gas unit heaters",
483
- "VAV chiller with gas boiler reheat",
484
- "VAV chiller with gas coil reheat",
485
- "VAV chiller with central air source heat pump reheat",
486
- "VAV chiller with PFP boxes",
487
- "VAV air-cooled chiller with gas boiler reheat",
488
- "VAV air-cooled chiller with central air source heat pump reheat",
489
- "VAV air-cooled chiller with district hot water reheat",
490
- "VAV air-cooled chiller with gas coil reheat",
491
- "VAV air-cooled chiller with no reheat with gas unit heaters",
492
- "VAV district chilled water with gas boiler reheat",
493
- "VAV district chilled water with central air source heat pump reheat",
494
- "VAV district chilled water with no reheat with zone heat pump",
495
- "VAV chiller with no reheat with baseboard electric",
496
- "VAV air-cooled chiller with no reheat with zone heat pump",
497
- "VAV district chilled water with district hot water reheat",
498
- "VAV district chilled water with gas coil reheat",
499
- "PVAV with gas heat with electric reheat",
500
- "PVAV with central air source heat pump reheat",
501
- "PVAV with PFP boxes",
502
- "Residential - electric resistance and no cooling",
503
- "Residential - electric resistance and central air conditioner",
504
- "Residential - electric resistance and room air conditioner",
505
- "Residential - electric resistance and evaporative cooler",
506
- "Residential - furnace and no cooling",
507
- "Residential - furnace and central air conditioner",
508
- "Residential - furnace and room air conditioner",
509
- "Residential - furnace and evaporative cooler",
510
- "Residential - boiler and no cooling",
511
- "Residential - boiler and central air conditioner",
512
- "Residential - boiler and room air conditioner",
513
- "Residential - boiler and evaporative cooler",
514
- "Residential - air-to-air heat pump",
515
- "Residential - mini-split heat pump",
516
- "Residential - ground-to-air heat pump"
517
- ]
518
- },
519
- "heatingSystemFuelType": {
520
- "description": "The fuel type of the heating system. This does not apply for certain system types (e.g., electric resistance or heat pumps).",
521
- "type": "string",
522
- "enum": [
523
- "electricity",
524
- "natural gas",
525
- "fuel oil",
526
- "propane",
527
- "wood"
528
- ]
529
- },
530
- "templateType": {
531
- "description": "Standard template applied to building. Default to site's default_template",
532
- "type": "string",
533
- "enum": [
534
- "DOE Ref Pre-1980",
535
- "DOE Ref 1980-2004",
536
- "90.1-2004",
537
- "90.1-2007",
538
- "90.1-2010",
539
- "90.1-2013",
540
- "90.1-2016",
541
- "90.1-2019",
542
- "DEER Pre-1975",
543
- "DEER 1985",
544
- "DEER 1996",
545
- "DEER 2003",
546
- "DEER 2007",
547
- "DEER 2011",
548
- "DEER 2014",
549
- "DEER 2015",
550
- "DEER 2017",
551
- "DEER 2020",
552
- "DEER 2025",
553
- "DEER 2030",
554
- "DEER 2035",
555
- "DEER 2040",
556
- "DEER 2045",
557
- "DEER 2050",
558
- "DEER 2055",
559
- "DEER 2060",
560
- "DEER 2065",
561
- "DEER 2070",
562
- "DEER 2075",
563
- "Residential IECC 2006 - Customizable Template Sep 2020",
564
- "Residential IECC 2009 - Customizable Template Sep 2020",
565
- "Residential IECC 2012 - Customizable Template Sep 2020",
566
- "Residential IECC 2015 - Customizable Template Sep 2020",
567
- "Residential IECC 2018 - Customizable Template Sep 2020"
568
- ]
569
- },
570
- "foundationType": {
571
- "description": "The foundation type of the building. Required for residential buildings.",
572
- "type": "string",
573
- "enum": [
574
- "slab",
575
- "crawlspace - vented",
576
- "crawlspace - unvented",
577
- "basement - unconditioned",
578
- "basement - conditioned",
579
- "ambient"
580
- ]
581
- },
582
- "atticType": {
583
- "description": "The attic type of the building. Required for single-family residential buildings.",
584
- "type": "string",
585
- "enum": [
586
- "attic - vented",
587
- "attic - unvented",
588
- "attic - conditioned",
589
- "flat roof"
590
- ]
591
- }
592
- }
2
+ "$schema": "http://json-schema.org/draft-04/schema#",
3
+ "id": "http://json-schema.org/openstudio-urban-modeling/building_properties.json#",
4
+ "title": "URBANopt Building",
5
+ "description": "Schema for an URBANopt Building object",
6
+ "type": "object",
7
+ "properties": {
8
+ "id": {
9
+ "description": "Unique id used to refer to this feature within this dataset.",
10
+ "type": "string"
11
+ },
12
+ "project_id": {
13
+ "description": "Project which this feature belongs to.",
14
+ "type": "string"
15
+ },
16
+ "type": {
17
+ "description": "Type of feature.",
18
+ "type": "string",
19
+ "enum": [
20
+ "Building"
21
+ ]
22
+ },
23
+ "source_name": {
24
+ "description": "Name of the original data source.",
25
+ "type": "string"
26
+ },
27
+ "source_id": {
28
+ "description": "Id of the feature in original data source.",
29
+ "type": "string"
30
+ },
31
+ "name": {
32
+ "description": "Feature name.",
33
+ "type": "string"
34
+ },
35
+ "legal_name": {
36
+ "description": "Legal name used to identify this feature.",
37
+ "type": "string"
38
+ },
39
+ "address": {
40
+ "description": "Street address.",
41
+ "type": "string"
42
+ },
43
+ "building_status": {
44
+ "description": "Building status.",
45
+ "type": "string",
46
+ "enum": [
47
+ "Proposed",
48
+ "Existing"
49
+ ]
50
+ },
51
+ "detailed_model_filename": {
52
+ "description": "Name of a detailed model which can be loaded from disk as a seed model or complete model. Mapper class decides which measures to disable if this is present.",
53
+ "type": "string"
54
+ },
55
+ "hpxml_directory": {
56
+ "description": "Name of the folder containing pre-built HPXML files. Optional for residential buildings.",
57
+ "type": "string"
58
+ },
59
+ "weather_filename": {
60
+ "description": "Name of EPW weather file for this building. Defaults to site's weather_filename.",
61
+ "type": "string"
62
+ },
63
+ "tariff_filename": {
64
+ "description": "Name of the tariff file for this building. Defaults to site's tariff_filename.",
65
+ "type": "string"
66
+ },
67
+ "surface_elevation": {
68
+ "description": "The surface elevation (above NAVD88 datum) of the building (ft). This is the elevation of the ground at the building location, any below ground stories will be lower than this. Defaults to site's surface_elevation.",
69
+ "type": "number"
70
+ },
71
+ "timesteps_per_hour": {
72
+ "description": "Number of timesteps per hour for energy simulations. Defaults to site's timesteps_per_hour.",
73
+ "type": "integer",
74
+ "minimum": 1,
75
+ "maximum": 60
76
+ },
77
+ "begin_date": {
78
+ "description": "Date to begin simulation, format YYYY-MM-DD. Defaults to site's begin_date.",
79
+ "type": "string"
80
+ },
81
+ "end_date": {
82
+ "description": "Date to end simulation, format YYYY-MM-DD. Defaults to site's end_date.",
83
+ "type": "string"
84
+ },
85
+ "climate_zone": {
86
+ "description": "ASHRAE 169 climate zone. Defaults to site's climate_zone",
87
+ "type": "string"
88
+ },
89
+ "cec_climate_zone": {
90
+ "description": "CEC Title24 climate zone. Defaults to site's cec_climate_zone",
91
+ "type": "string"
92
+ },
93
+ "occupancy_calculation_type": {
94
+ "description": "The occupancy calculation type. Optional for residential buildings. Defaults to asset.",
95
+ "type": "string",
96
+ "enum": [
97
+ "asset",
98
+ "operational"
99
+ ]
100
+ },
101
+ "floor_area": {
102
+ "description": "Usable floor area (ft^2). Required for residential buildings, this represents conditioned floor area.",
103
+ "type": "number"
104
+ },
105
+ "number_of_stories": {
106
+ "description": "The maximum number of building stories, sum of number of above and below ground stories.",
107
+ "type": "integer"
108
+ },
109
+ "number_of_stories_above_ground": {
110
+ "description": "The number of building stories above ground. Required for residential buildings.",
111
+ "type": "integer"
112
+ },
113
+ "maximum_roof_height": {
114
+ "description": "Maximum height of the roof relative to surface elevation (ft)",
115
+ "type": "number"
116
+ },
117
+ "roof_type": {
118
+ "description": "The type of roof. Optional for residential buildings. Defaults to Gable.",
119
+ "type": "string",
120
+ "enum": [
121
+ "Gable",
122
+ "Hip"
123
+ ]
124
+ },
125
+ "foundation_type": {
126
+ "$ref": "#/definitions/foundationType"
127
+ },
128
+ "attic_type": {
129
+ "$ref": "#/definitions/atticType"
130
+ },
131
+ "footprint_area": {
132
+ "description": "Area of the footprint (ft^2). Calculated on export.",
133
+ "type": "number"
134
+ },
135
+ "footprint_perimeter": {
136
+ "description": "Perimeter of the footprint (ft). Calculated on export.",
137
+ "type": "number"
138
+ },
139
+ "year_built": {
140
+ "description": "The year construction of the building was completed. Can be in the future to indicate future build out. Defaults to current year.",
141
+ "type": "integer"
142
+ },
143
+ "template": {
144
+ "$ref": "#/definitions/templateType"
145
+ },
146
+ "building_type": {
147
+ "$ref": "#/definitions/buildingType"
148
+ },
149
+ "system_type": {
150
+ "$ref": "#/definitions/systemType"
151
+ },
152
+ "heating_system_fuel_type": {
153
+ "$ref": "#/definitions/heatingSystemFuelType"
154
+ },
155
+ "weekday_start_time": {
156
+ "description": "Weekday operating hours start time in 08:30 format, using 24-hr clock. Leave blank to use default.",
157
+ "type": "string"
158
+ },
159
+ "weekday_duration": {
160
+ "description": "Length of weekend operating hours in 08:30 format, up to 24:00.",
161
+ "type": "string"
162
+ },
163
+ "weekend_start_time": {
164
+ "description": "Weekend operating hours start time in 08:30 format, using 24-hr clock. Leave blank to use default.",
165
+ "type": "string"
166
+ },
167
+ "weekend_duration": {
168
+ "description": "Length of weekend operating hours in 08:30 format, up to 24:00.",
169
+ "type": "string"
170
+ },
171
+ "mixed_type_1": {
172
+ "$ref": "#/definitions/buildingType"
173
+ },
174
+ "mixed_type_1_percentage": {
175
+ "description": "Percentage of 1st mixed building space type. Only used when building_type is Mixed use.",
176
+ "type": "number",
177
+ "minimum": 0,
178
+ "maximum": 100
179
+ },
180
+ "mixed_type_2": {
181
+ "$ref": "#/definitions/buildingType"
182
+ },
183
+ "mixed_type_2_percentage": {
184
+ "description": "Percentage of 2nd mixed building space type. Only used when building_type is Mixed use.",
185
+ "type": "number",
186
+ "minimum": 0,
187
+ "maximum": 100
188
+ },
189
+ "mixed_type_3": {
190
+ "$ref": "#/definitions/buildingType"
191
+ },
192
+ "mixed_type_3_percentage": {
193
+ "description": "Percentage of 3rd mixed building space type. Only used when building_type is Mixed use.",
194
+ "type": "number",
195
+ "minimum": 0,
196
+ "maximum": 100
197
+ },
198
+ "mixed_type_4": {
199
+ "$ref": "#/definitions/buildingType"
200
+ },
201
+ "mixed_type_4_percentage": {
202
+ "description": "Percentage of 4th mixed building space type. Only used when building_type is Mixed use.",
203
+ "type": "number",
204
+ "minimum": 0,
205
+ "maximum": 100
206
+ },
207
+ "number_of_residential_units": {
208
+ "description": "Total number of residential units in the building. Required for single-family attached and multifamily residential buildings.",
209
+ "type": "integer"
210
+ },
211
+ "number_of_bedrooms": {
212
+ "description": "Total number of bedrooms in the building. Required for residential buildings. Must be divisible by the number of residential units.",
213
+ "type": "integer"
214
+ },
215
+ "number_of_occupants": {
216
+ "description": "Total number of occupants in the building. Optional for residential buildings. Must be divisible by the number of residential units. Defaults to the total number of bedrooms in the building.",
217
+ "type": "integer"
218
+ },
219
+ "exterior_lighting_zone": {
220
+ "description": "Choice of exterior lighting zone.",
221
+ "type": "string",
222
+ "enum": [
223
+ "0 - Undeveloped Areas Parks",
224
+ "1 - Developed Areas Parks",
225
+ "2 - Neighborhood",
226
+ "3 - All Other Areas",
227
+ "4 - High Activity"
228
+ ]
229
+ },
230
+ "onsite_parking_fraction": {
231
+ "description": "Fraction of building parking to include in this model. Choose 1 to include exterior lights for parking in this building model. Choose 0 if parking is modeled separately.",
232
+ "type": "number",
233
+ "minimum": 0,
234
+ "maximum": 1
235
+ },
236
+ "power_factor": {
237
+ "description": "Ratio of the real power used by building to the apparent power seen by grid.",
238
+ "type": "number",
239
+ "minimum": 0
240
+ },
241
+ "user_data": {
242
+ "description": "Arbitrary user data"
243
+ },
244
+ "ev_charging": {
245
+ "description": "Should be set to true if EV charging is associated with the building.",
246
+ "type": "boolean"
247
+ },
248
+ "ev_charging_station_type": {
249
+ "description": "Indicates whether EV charging associated with the building is for Typical Home, Public or Work charging station",
250
+ "type": "string",
251
+ "enum": [
252
+ "Typical Home",
253
+ "Typical Public",
254
+ "Typical Work"
255
+ ]
256
+ },
257
+ "delay_type": {
258
+ "description": "Adds workplace charging flexibility for different scenarios. Min delay scenario indicates EV charging immediately upon arriving to work, Max delay indicates not charging until necessary thereby shifting EV charging load to later in the day and Min power indicates charging EVs at a minimum rate over the parking event.",
259
+ "type": "string",
260
+ "enum": [
261
+ "Min Delay",
262
+ "Max Delay",
263
+ "Min Power"
264
+ ]
265
+ },
266
+ "ev_charging_behavior": {
267
+ "description": "Describes scenarios for EV charging behavior, Business as Usual implies home dominant charging behavior, Free Workplace Charging at Project Site implies peak power draw from EV charging during morning hours due to EV charging at workplaces and Free Workplace Charging Across Metro Area scenario reduces Home EV charging relative to Free Workplace Charging at Project Site for residents who work elsewhere and can charge their vehicles for free at those workplaces.",
268
+ "type": "string",
269
+ "enum": [
270
+ "Business as Usual",
271
+ "Free Workplace Charging at Project Site",
272
+ "Free Workplace Charging Across Metro Area"
273
+ ]
274
+ },
275
+ "ev_percent": {
276
+ "description": "Denotes the % of vehicles parked at the building that are EVs.",
277
+ "type": "number"
278
+ },
279
+ "ev_use_model_occupancy": {
280
+ "description": "When true, will scale the EV profiles as per the modeled occupancy of the OpenStudio building model. When false, will resort to default behavior of using typical EV load profiles for charging station type",
281
+ "type": "boolean"
282
+ },
283
+ "ev_curtailment_frac": {
284
+ "description": "Fraction between 0 and 1 that denotes curtailment of EV charging load to better align EV charging with expected energy production from a solar PV system",
285
+ "type": "number"
286
+ },
287
+ "emissions": {
288
+ "description": "Should be set to true to calculate emissions for the associated building.",
289
+ "type": "boolean"
290
+ },
291
+ "emissions_future_subregion": {
292
+ "description": "Future subregion. Options: AZNMc, CAMXc, ERCTc, FRCCc, MROEc, MROWc, NEWEc, NWPPc, NYSTc, RFCEc, RFCMc, RFCWc, RMPAc, SPNOc, SPSOc, SRMVc, SRMWc, SRSOc, SRTVc, and SRVCc",
293
+ "type": "string",
294
+ "enum": [
295
+ "AZNMc",
296
+ "CAMXc",
297
+ "ERCTc",
298
+ "FRCCc",
299
+ "MROEc",
300
+ "MROWc",
301
+ "NEWEc",
302
+ "NWPPc",
303
+ "NYSTc",
304
+ "RFCEc",
305
+ "RFCMc",
306
+ "RFCWc",
307
+ "RMPAc",
308
+ "SPNOc",
309
+ "SPSOc",
310
+ "SRMVc",
311
+ "SRMWc",
312
+ "SRSOc",
313
+ "SRTVc",
314
+ "SRVCc"
315
+ ]
316
+ },
317
+ "emissions_hourly_historical_subregion": {
318
+ "description": "Historical hourly subregion. Options: California, Carolinas, Central, Florida, Mid-Atlantic, Midwest, New England, New York, Northwest, Rocky Mountains, Southeast, Southwest, Tennessee, and Texas",
319
+ "type": "string",
320
+ "enum": [
321
+ "California",
322
+ "Carolinas",
323
+ "Central",
324
+ "Florida",
325
+ "Mid-Atlantic",
326
+ "Midwest",
327
+ "New England",
328
+ "New York",
329
+ "Northwest",
330
+ "Rocky Mountains",
331
+ "Southeast",
332
+ "Southwest",
333
+ "Tennessee",
334
+ "Texas"
335
+ ]
336
+ },
337
+ "emissions_annual_historical_subregion": {
338
+ "description": "Historical annual subregion. Options: AKGD, AKMS, AZNM, CAMX, ERCT, FRCC, HIMS, HIOA, MROE, MROW, NEWE, NWPP, NYCW, NYLI, NYUP, RFCE, RFCM, RFCW, RMPA, SPNO, SPSO, SRMV, SRMW, SRSO, SRTV, and SRVC",
339
+ "type": "string",
340
+ "enum": [
341
+ "AKGD",
342
+ "AKMS",
343
+ "AZNM",
344
+ "CAMX",
345
+ "ERCT",
346
+ "FRCC",
347
+ "HIMS",
348
+ "HIOA",
349
+ "MROE",
350
+ "MROW",
351
+ "NEWE",
352
+ "NWPP",
353
+ "NYCW",
354
+ "NYLI",
355
+ "NYUP",
356
+ "RFCE",
357
+ "RFCM",
358
+ "RFCW",
359
+ "RMPA",
360
+ "SPNO",
361
+ "SPSO",
362
+ "SRMV",
363
+ "SRMW",
364
+ "SRSO",
365
+ "SRTV",
366
+ "SRVC"
367
+ ]
368
+ },
369
+ "emissions_future_year": {
370
+ "description": "Future Year. Options: 2020 to 2050 in two year increments",
371
+ "type": "string",
372
+ "enum": [
373
+ "2020",
374
+ "2022",
375
+ "2024",
376
+ "2026",
377
+ "2028",
378
+ "2030",
379
+ "2032",
380
+ "2034",
381
+ "2036",
382
+ "2038",
383
+ "2040",
384
+ "2042",
385
+ "2044",
386
+ "2046",
387
+ "2048",
388
+ "2050"
389
+ ]
390
+ },
391
+ "emissions_hourly_historical_year": {
392
+ "description": "Hourly Historical Year. Options: 2019.",
393
+ "type": "string",
394
+ "enum": [
395
+ "2019"
396
+ ]
397
+ },
398
+ "emissions_annual_historical_year": {
399
+ "description": "Annual Historical Year. Options: 2007, 2009, 2010, 2012, 2014, 2016, 2018, and 2019.",
400
+ "type": "string",
401
+ "enum": [
402
+ "2007",
403
+ "2009",
404
+ "2010",
405
+ "2012",
406
+ "2014",
407
+ "2016",
408
+ "2018",
409
+ "2019"
410
+ ]
411
+ }
412
+ },
413
+ "required": [
414
+ "building_type",
415
+ "floor_area",
416
+ "footprint_area",
417
+ "id",
418
+ "name",
419
+ "number_of_stories",
420
+ "type"
421
+ ],
422
+ "definitions": {
423
+ "buildingType": {
424
+ "description": "Primary building space type.",
425
+ "type": "string",
426
+ "enum": [
427
+ "Single-Family Detached",
428
+ "Single-Family Attached",
429
+ "Multifamily",
430
+ "Single-Family",
431
+ "Multifamily (2 to 4 units)",
432
+ "Multifamily (5 or more units)",
433
+ "Vacant",
434
+ "Office",
435
+ "Laboratory",
436
+ "Nonrefrigerated warehouse",
437
+ "Food sales",
438
+ "Public order and safety",
439
+ "Outpatient health care",
440
+ "Refrigerated warehouse",
441
+ "Religious worship",
442
+ "Public assembly",
443
+ "Education",
444
+ "Food service",
445
+ "Inpatient health care",
446
+ "Nursing",
447
+ "Lodging",
448
+ "Strip shopping mall",
449
+ "Enclosed mall",
450
+ "Retail other than mall",
451
+ "Service",
452
+ "Mixed use",
453
+ "Uncovered Parking",
454
+ "Covered Parking",
455
+ "null"
456
+ ]
457
+ },
458
+ "systemType": {
459
+ "description": "Building HVAC system type.",
460
+ "type": "string",
461
+ "enum": [
462
+ "PTAC with baseboard electric",
463
+ "PTAC with baseboard gas boiler",
464
+ "PTAC with baseboard district hot water",
465
+ "PTAC with gas unit heaters",
466
+ "PTAC with electric coil",
467
+ "PTAC with gas coil",
468
+ "PTAC with gas boiler",
469
+ "PTAC with no heat",
470
+ "PTAC with district hot water",
471
+ "PTAC with central air source heat pump",
472
+ "PTHP",
473
+ "PSZ-AC with gas coil",
474
+ "PSZ-AC with baseboard electric",
475
+ "PSZ-AC with no heat",
476
+ "PSZ-AC with district hot water",
477
+ "PSZ-AC with central air source heat pump",
478
+ "PSZ-HP",
479
+ "Fan coil district chilled water with no heat",
480
+ "Fan coil district chilled water with boiler",
481
+ "Fan coil district chilled water with central air source heat pump",
482
+ "Fan coil district chilled water with gas unit heaters",
483
+ "Fan coil district chilled water with baseboard electric",
484
+ "Fan coil district chilled water with district hot water",
485
+ "Fan coil chiller with district hot water",
486
+ "Fan coil air-cooled chiller with district hot water",
487
+ "Fan coil chiller with boiler",
488
+ "Fan coil air-cooled chiller with boiler",
489
+ "Fan coil chiller with central air source heat pump",
490
+ "Fan coil air-cooled chiller with central air source heat pump",
491
+ "Fan coil chiller with no heat",
492
+ "DOAS with fan coil district chilled water with no heat",
493
+ "DOAS with fan coil district chilled water and boiler",
494
+ "DOAS with fan coil district chilled water with central air source heat pump",
495
+ "DOAS with fan coil district chilled water with gas unit heaters",
496
+ "DOAS with fan coil district chilled water with baseboard electric",
497
+ "DOAS with fan coil district chilled water with district hot water",
498
+ "DOAS with fan coil chiller with district hot water",
499
+ "DOAS with fan coil air-cooled chiller with district hot water",
500
+ "DOAS with fan coil air-cooled chiller with boiler",
501
+ "DOAS with fan coil chiller with central air source heat pump",
502
+ "DOAS with fan coil air-cooled chiller with central air source heat pump",
503
+ "DOAS with fan coil chiller with no heat",
504
+ "DOAS with VRF",
505
+ "VRF",
506
+ "DOAS with water source heat pumps with ground source heat pump",
507
+ "Forced air furnace",
508
+ "Baseboard district hot water",
509
+ "Baseboard electric",
510
+ "Baseboard gas boiler",
511
+ "Baseboard central air source heat pump",
512
+ "Window AC with no heat",
513
+ "Window AC with forced air furnace",
514
+ "Window AC with baseboard district hot water",
515
+ "Window AC with baseboard electric",
516
+ "Window AC with unit heaters",
517
+ "Window AC with baseboard gas boiler",
518
+ "Window AC with baseboard central air source heat pump",
519
+ "Direct evap coolers with baseboard district hot water",
520
+ "Direct evap coolers with baseboard electric",
521
+ "Direct evap coolers with baseboard gas boiler",
522
+ "Direct evap coolers with baseboard central air source heat pump",
523
+ "Direct evap coolers with no heat",
524
+ "Direct evap coolers with gas unit heaters",
525
+ "Direct evap coolers with forced air furnace",
526
+ "Gas unit heaters",
527
+ "VAV chiller with gas boiler reheat",
528
+ "VAV chiller with gas coil reheat",
529
+ "VAV chiller with central air source heat pump reheat",
530
+ "VAV chiller with PFP boxes",
531
+ "VAV air-cooled chiller with gas boiler reheat",
532
+ "VAV air-cooled chiller with central air source heat pump reheat",
533
+ "VAV air-cooled chiller with district hot water reheat",
534
+ "VAV air-cooled chiller with gas coil reheat",
535
+ "VAV air-cooled chiller with no reheat with gas unit heaters",
536
+ "VAV district chilled water with gas boiler reheat",
537
+ "VAV district chilled water with central air source heat pump reheat",
538
+ "VAV district chilled water with no reheat with zone heat pump",
539
+ "VAV chiller with no reheat with baseboard electric",
540
+ "VAV air-cooled chiller with no reheat with zone heat pump",
541
+ "VAV district chilled water with district hot water reheat",
542
+ "VAV district chilled water with gas coil reheat",
543
+ "PVAV with gas heat with electric reheat",
544
+ "PVAV with central air source heat pump reheat",
545
+ "PVAV with PFP boxes",
546
+ "Residential - electric resistance and no cooling",
547
+ "Residential - electric resistance and central air conditioner",
548
+ "Residential - electric resistance and room air conditioner",
549
+ "Residential - electric resistance and evaporative cooler",
550
+ "Residential - furnace and no cooling",
551
+ "Residential - furnace and central air conditioner",
552
+ "Residential - furnace and room air conditioner",
553
+ "Residential - furnace and evaporative cooler",
554
+ "Residential - boiler and no cooling",
555
+ "Residential - boiler and central air conditioner",
556
+ "Residential - boiler and room air conditioner",
557
+ "Residential - boiler and evaporative cooler",
558
+ "Residential - air-to-air heat pump",
559
+ "Residential - mini-split heat pump",
560
+ "Residential - ground-to-air heat pump"
561
+ ]
562
+ },
563
+ "heatingSystemFuelType": {
564
+ "description": "The fuel type of the heating system. This does not apply for certain system types (e.g., electric resistance or heat pumps).",
565
+ "type": "string",
566
+ "enum": [
567
+ "electricity",
568
+ "natural gas",
569
+ "fuel oil",
570
+ "propane",
571
+ "wood"
572
+ ]
573
+ },
574
+ "templateType": {
575
+ "description": "Standard template applied to building. Default to site's default_template",
576
+ "type": "string",
577
+ "enum": [
578
+ "DOE Ref Pre-1980",
579
+ "DOE Ref 1980-2004",
580
+ "90.1-2004",
581
+ "90.1-2007",
582
+ "90.1-2010",
583
+ "90.1-2013",
584
+ "90.1-2016",
585
+ "90.1-2019",
586
+ "DEER Pre-1975",
587
+ "DEER 1985",
588
+ "DEER 1996",
589
+ "DEER 2003",
590
+ "DEER 2007",
591
+ "DEER 2011",
592
+ "DEER 2014",
593
+ "DEER 2015",
594
+ "DEER 2017",
595
+ "DEER 2020",
596
+ "DEER 2025",
597
+ "DEER 2030",
598
+ "DEER 2035",
599
+ "DEER 2040",
600
+ "DEER 2045",
601
+ "DEER 2050",
602
+ "DEER 2055",
603
+ "DEER 2060",
604
+ "DEER 2065",
605
+ "DEER 2070",
606
+ "DEER 2075",
607
+ "Residential IECC 2006 - Customizable Template Sep 2020",
608
+ "Residential IECC 2009 - Customizable Template Sep 2020",
609
+ "Residential IECC 2012 - Customizable Template Sep 2020",
610
+ "Residential IECC 2015 - Customizable Template Sep 2020",
611
+ "Residential IECC 2018 - Customizable Template Sep 2020",
612
+ "Residential IECC 2006 - Customizable Template Apr 2022",
613
+ "Residential IECC 2009 - Customizable Template Apr 2022",
614
+ "Residential IECC 2012 - Customizable Template Apr 2022",
615
+ "Residential IECC 2015 - Customizable Template Apr 2022",
616
+ "Residential IECC 2018 - Customizable Template Apr 2022"
617
+ ]
618
+ },
619
+ "foundationType": {
620
+ "description": "The foundation type of the building. Required for residential buildings.",
621
+ "type": "string",
622
+ "enum": [
623
+ "slab",
624
+ "crawlspace - vented",
625
+ "crawlspace - unvented",
626
+ "crawlspace - conditioned",
627
+ "basement - unconditioned",
628
+ "basement - conditioned",
629
+ "ambient"
630
+ ]
631
+ },
632
+ "atticType": {
633
+ "description": "The attic type of the building. Required for residential buildings.",
634
+ "type": "string",
635
+ "enum": [
636
+ "attic - vented",
637
+ "attic - unvented",
638
+ "attic - conditioned",
639
+ "flat roof"
640
+ ]
641
+ }
642
+ }
593
643
  }