45-Day Public Review Period
Version 8.01 - May 2025
Version 8.01 of the gbXML schema is now available for a 45-day public review from May 26 to July 10, 2025.
It includes one major category of updates:
- 1. gbXML was a big part of ASHRAE RP-1815, "Integrating Occupant Behavior Data into Building Information Modeling for Performance Simulation" that was completed in August 2024. ASHRAE RP-1815 centered on advancing the state of occupant behavior modeling as part of building information modeling (BIM) and energy modeling and simulation (BEM) workflows. Enhancements to the industry data standards IFC and gbXML for BIM and BEM to support occupant behavior modeling data were a specific area of focus and project deliverable. The research drew heavily on Lawrence Berkeley's obXML occupant behavior modeling schema as an influence and point of departure for this work. Most of the obXML elements were incorporated into this new gbXML update.
Click here to go to the Google doc for the list of changes and updates.
Click here to view the gbXML Version 8.01 Documentation (zip)
Click here to download the gbXML Version 8.01 schema (xsd) file
List of Version 8.01 gbXML updates:
-
obXML Updates:
1. Added TimeofDayType simple enum
2. Added SeasonType simple enum
3. Added Time element
4. Added Environment element
5. Added Drivers element
6. Added Needs element
7. Added Actions and all formula complex types. Altered in from the obXML version. In the obXML version, Interaction complex type was a direct child of Actions. In gbXML, Interaction complex type is a child of gbXML and Actions references Interaction.
8. Added Occupant/Occupants
9. Added JobType enum.
9a. Added "Contractor" to the JobType enum.
10. Added LifeStyleType enum
11. Added GenderType enum
12. Added OccupantBehavior
13. Added Seasons element
14. Added TimeofDays element
15. In the OccupantBehavior element, using the existing gbXML element "HolidaysModeled" instead of the obXML element: "Holidays"
16. Added TypesDataCollectedList simple type
17. Added complex type: SpaceOccupancyType
18. Added simple type: statusTransitionEventType
19. Added OtherConstraintType simple type
20. Added ParameterType simple type
21. Added RoomEventType simple type
22. Added SpaceCategory simple type
23. Added eqConstantValueType complex type
24. Added eqLinear1DType complex type
25. Added eqLinear2DType complex type
26. Added eqLinear3DType complex type
27. Added eqLogit1DLinearType complex type
28. Added eqLogit1DQuadraticType complex type
29. Added eqLogit2DLinearType complex type
30. Added eqLogit3DLinearType complex type
31. Added eqQuadratic1DType complex type
32. Added eqWeibull1D3P complex type
35. Added MaritalStatusType simple type
36. Added EducationType simple type
37. Added ClimateZoneType simple type
38. Added MarkovChainModelType complex typef
39. Added CustomProbabilityModelType complex type
40. Added CommuteModeType simple type
41. Added PolicyType simple type
42. Added InfrastructureType simple type
43. Replace CostType (obXML) with costTypeEnum (gbXML) in the elements that were added as part of obXML
43aa. Removed the CostType simple type. Added the "ServiceFees" type enum to the costTypeEnum
43a. Added IncomeGroupType simple type
43b. Added EmploymentType simple type
44. Added subjectiveValueType simple type
45. Under OccupantBehavior replaced Buildings w/Building
46. Added BuildingSystems element which is Systems element in obXML
47. Added buildingSystemTypeEnum which is same as SystemTypeList in obXML
48. Added HVACTypeEnum which was HVACType in obXML
49. Added lightTypeEnum which was LightType in obXML
50. Added plugLoadTypeEnum which was PlugLoadType in obXML
51. Added windowTypeEnum which was WindowType in obXML
51a. Renamed WindowType (from obXML) to WindowTypeSimple since WindowType already exists in gbXML
52. Added thermostatTypeEnum which is ThermostatType in obXML
53. Added shadeAndBlindTypeEnum which is ShadeAndBlindType in obXML
54. Added Activity element to Behaviors element
55. Within the Activity element in obXML is an enum called TimeFrequencyType. Got rid of this and used the existing gbXML enum: timeUnitEnum
56. Added ASHRAEComfortTemperatures and ASHRAEComfortEnvelope to the Thermal element of the Needs main element
57. Added eqGaussianNormal1DType complex type
58. Replace ParameterRange with OperationRange (that already exists in gbXML) for the ASHRAEComfortEnvelope and ASHRAECoolingAdaptiveComfort elements
59. Added GroupPriority type
60. Added GroupPriority simple element
61. Added GroupPriority reference to existing gbXML Space element
61. Added MeetingEvent element
62. Added MeetingDurationProbabilityType complex type
63. Added MeetingEvent reference to existing gbXML Space element
64. Added OccupantID element to existing gbXML Space element
65. Reconfigured the Interaction element from obXML. Got rid of the child elements and moved them underneath the main schema, then included references to those elements including:
65a. Added ConstantValue of type eqConstantValueType
65aa. Added Linear1D of type eqLinear1DType
65ab. Added Linear2D of type eqLinear2DType
65ac. Added Linear3D of type eqLinear3DType
65ad. Added Quadratic1D of type eqQuadratic1DType
65ae. Added Logit1D of type eqLogit1DLinearType
65af. Added Logit2D of type eqLogit2DLinearType
65ag. Added Logit3D of type eqLogit3DLinearType
65ah. Added Weibull1D of type eqWeibull1D3P
65ai. Added Logit1DQuadratic of type eqLogit1DQuadraticType
65aj. Added ControlValue of type double
65b. Converted Quadratic1D to child element of gbXML and then converted to reference as child of Formula
65c. Converted Linear1D to child element of gbXML and then converted to reference as child of Formula
65d. Converted Linear2D to child element of gbXML and then converted to reference as child of Formula
65e. Converted Linear3D to child element of gbXML and then converted to reference as child of Formula
65f. Converted Logit1D to child element of gbXML and then converted to reference as child of Formula
65g. Converted Logit2D to child element of gbXML and then converted to reference as child of Formula
65h. Converted Logit3D to child element of gbXML and then converted to reference as child of Formula
65i. Converted Weibull1D to child element of gbXML and then converted to reference as child of Formula
65j. Converted Logit1DQuadratic to child element of gbXML and then converted to reference as child of Formula
65k. Converted ControlValue to child element of gbXML and then converted to reference as child of Formula
65l. Converted ConstantValue to child element of gbXML and then converted to reference as child of Formula
65m. Converted CoefficientA to child element of gbXML and then converted to reference as child of various "eq*" complex types
65n. Converted CoefficientB to child element of gbXML and then converted to reference as child of various "eq*" complex types
65o. Converted CoefficientC to child element of gbXML and then converted to reference as child of various "eq*" complex types
65p. Converted CoefficientD to child element of gbXML and then converted to reference as child of various "eq*" complex types
65q. Converted Parameter1ID to child element of gbXML and then converted to reference as child of various "eq*" complex types
65r. Converted Parameter2ID to child element of gbXML and then converted to reference as child of various "eq*" complex types
65s. Converted Parameter3ID to child element of gbXML and then converted to reference as child of various "eq*" complex types
65t. Converted Mean to child element of gbXML and then converted to reference as child of various "eq*" complex types
65u. Converted StDev to child element of gbXML and then converted to reference as child of various "eq*" complex types
65v. Converted LowerBound to child element of gbXML and then converted to reference as child of various "eq*" complex types
65w. Converted UpperBound to child element of gbXML and then converted to reference as child of various "eq*" complex types
66. Added Description element to main gbXML element then referenced it in the MovementBehavior and Behavior obXML elements
67. Converted MovementBehavior, Behavior, and Activity children elements on Behaviors to child elements of gbXML and then referenced them in Behaviors
68. Converted RandomMovementEvent to child element of gbXML then converted to reference as child of MovementBehavior
69. Converted SpaceOccupancy to child element of gbXML then converted to reference as child of RandomMovementEvent
70. Converted EventType to child element of gbXML then converted to reference as child of StatusTransitionEvent. Also, renamed EventType to StatusTransitionEventType since an EventType child already exists. There's also a RoomEventType.
71. Converted EventOccurModel to child element of gbXML then converted to reference as child of StatusTransitionEvent
72. Converted EventDuration to child element of gbXML then converted to reference as child of StatusTransitionEvent
73. Converted StatusTransitionEvent to child element of gbXML then converted to reference as child of MovementBehavior
74. Converted IsSpecialBehavior to child element of gbXML then converted to reference as child of Behavior
75. Converted Name to reference in Activity element
76. Converted StatusofActivity to child element of gbXML then converted to reference as child of Activity
77. Converted TimeFrequencyType to child element of gbXML then converted to reference as child of StatusofActivity
78. Converted ActivityOccurModel to child element of gbXML then converted to reference as child of StatusofActivity
79. Converted ActivityDuration to child element of gbXML then converted to reference as child of StatusofActivity
80. Converted MarkovChainModel to child element of gbXML then converted to reference as child of EventOccurModel
81. Converted CustomProbabilityModel to base child element then converted to reference as child of EventOccurModel and ActivityOccurModel
82. Converted NormalProbabilityModel to base child element then converted to reference as child of EventOccurModel and ActivityOccurModel
83. Converted NormalDurationModel to base child element then converted to reference as child of EventDuration and ActivityDuration
84. Converted Probability to a base child element then converted to reference as child of StatusTransitionProbability element and MeetingDuration
85. Converted StatusTransitionProbability to base child element then converted to reference child of CustomProbabilityModelType complextype
86. Converted MeetingDuration to base child element then converted to reference child of MeetingDurationProbabilityType complextype
87. Converted MinNumOccupantsPerMeeting to base child element then converted to reference child of MeetingEvent complextype
88. Converted MaxNumOccupantsPerMeeting to base child element then converted to reference child of MeetingEvent complextype
89. Converted MinNumberOfMeetingsPerDay to base child element then converted to reference child of MeetingEvent complextype
90. Converted MaxNumberOfMeetingsPerDay to base child element then converted to reference child of MeetingEvent complextype
91. Converted Formula to base child element then converted to reference child of Interaction complextype
92. Converted Type to base child element then converted to reference child of Interaction complextype
93. Converted Parameter to base child element then converted to reference child in Environment
94. Converted Type to base child and renamed to ParameterType of type parameterType then converted to reference child in Parameter
95. Converted Physical to base child then converted to reference child in Needs
96. Converted Thermal to base child then converted to reference child of Physical
97. Converted Visual to base child then converted to reference child of Physical
98. Converted IAQ to base child then converted to reference child of Physical
99. Converted ASHRAEComfortTemperatures to base child then converted to reference of Thermal
100. Converted CoolingTemperature to base child then converted to reference of ASHRAEComfortTemperatures
101. Converted HeatingTemperature to base child then converted to reference of ASHRAEComfortTemperatures
102. Converted ASHRAEComfortEnvelope to base child then converted to reference of Thermal
103. Converted ASHRAECoolingAdaptiveComfort to base child then converted to reference of Thermal
104. Converted ParameterRange to base child then converted to reference of ASHRAEComfortEnvelope
105. Converted ParameterRange to reference in ASHRAECoolingAdaptiveComfort
106. Converted ParameterRange to reference in Visual
107. Converted ParameterRange to reference in IAQ
108. Converted Occupant to base child then converted to reference of Occupants
109. Converted Priority to base chld then converted to reference of Occupant
110. Converted SocioEconomic to base child then converted to reference of Occupant
111. Got rid of "Age" child element of SocioEconomic and inserted a reference to the built-in gbXML age element that includes a child element years
112. Converted Gender to base child then converted to reference of SocioEconomic
113. Converted LifeStyle to base child then converted to reference of SocioEconomic
114. Converted MaritalStatus to base child then converted to reference of SocioEconomic
115. Converted Education to base child then converted to reference of SocioEconomic
116. Converted IncomeGroup to base child then converted to reference of SocioEconomic
117. Converted Employment to base child then converted to reference of SocioEconomic
118. Converted GeographicLocation to base child then converted to reference of Occupant
119. Converted ClimateZone to base child then converted to reference of GeographicLocation
120. Converted CommuteMode to base child then converted to reference of GeographicLocation
121. Converted Policy to base child then converted to reference of GeographicLocation
122. Converted Infrastructure to base child then converted to reference of GeographicLocation
123. Changed the initial Cost child element of GeographicLocation to the existing gbXML Cost child element
124. Converted SubjectiveValues to base child then converted to reference of Occupant
125. Converted PastExperience to base child then converted to reference of SubjectiveValues
126. Converted CostConscious to base child then converted to reference of SubjectiveValues
127. Converted EnvironmentAwareness to base child then converted to reference of SubjectiveValues
128. Converted TechnologyOriented to base child then converted to reference of SubjectiveValues
129. Converted Accommodating to base child then converted to reference of SubjectiveValues
130. Converted SocialInfluence to base child then converted to reference of SubjectiveValues
131. Converted TemperatureProbabilityModel to base child then converted to reference of CoolingTemperature and HeatingTemperature
132. Converted StartMonth to base child then converted to reference of Season
133. Converted StartDay to base child then converted to reference of Season
134. Converted EndMonth to base child then converted to reference of Season
135. Converted EndDay to base child then converted to reference of Season
136. Converted HVAC to base child then converted to reference of BuildingSystems
137. Converted Lights to base child then converted to reference of BuildingSystems
138. Converted Windows to base child then converted to reference of BuildingSystems
139. Converted PlugLoad to base child then converted to reference of BuildingSystems
140. Converted Thermostats to base child then converted to reference of BuildingSystems
141. Converted ShadesAndBlinds to base child then converted to reference of BuildingSystemsv 142. Converted TimeofDay to base child then converted to reference of TimeofDays
143. Converted StartHour to base child then converted to reference of TimeofDay
144. Converted StartMinute to base child then converted to reference of TimeofDay
145. Converted EndHour to base child then converted to reference of TimeofDay
146. Converted EndMinute to base child then converted to reference of TimeofDay
147. Added Occupants element to gbXML main element
148. Added BuildingSystems to Space element