gbXML version 6.01 - maintained by gbXML.org.
Change Log:
6.01
10/2015
1. Added new attribute "SurfaceReferenceLocation" to "gbXML" element of type "surfaceReferenceLocationEnum"
2. Added new enumeration "surfaceReferenceLocationEnum"
3. Added notes/comments to following elements, attributes, enumerations: surfaceDescriptionEnum, SimulationParameters, AdjacentSpaceId, ConvergenceLimits, Layer, MaterialId, CADObjectId
4. Changed minimumSystemTimeStep attribute of element "ConvergenceLimits" to integer from decimal
5. Changed maximumHVACIterations attribute of element "ConvergenceLimits" to integer from decimal
6. Changed minimumPlantIterations attribute of element "ConvergenceLimits" to integer from decimal
7. Changed maximumPlantIterations attribute of element "ConvergenceLimits" to integer from decimal
8. Changed LowerLimitValue child element of element ScheduleTypeLimits minOccurs to 0
9. Changed UpperLimitValue child element of element ScheduleTypeLimits minOccurs to 0
10. Added new version numbers to versionEnum enumeration
6.00
9/2015
1. Added new children elements to Material element including absorptance, roughness, albedo, reflectance, transmittance, emittance
2. Added ScheduleTypeLimits element that includes child elements: lowerlimitvalue, upperlimitvalue, scheduleLimitsType enum, id enum
3. Added ScheduleTypeLimitsId attribute (string) to YearSchedule, WeekSchedule, DaySchedule that refers to the ScheduleTypeLimits element (above #2).
4. Added ScheduleTypeLimitsEnum that includes Continuous, Discrete items
5. Add SimulationParameters element that includes version and timestep attributes and ConvergenceLimits child element. This element is a child element of gbXML.
6. Added ConvergenceLimits child element.
7. Added surfaceDescriptionEnum enumeration that includes 1,2, and even enumeration items.
8. Changed the MaterialId maxOccurs to 1 under the Layer element
9. Added coordinatesAbsolute attribute (boolean) to Opening element so as to specify the type of coordinate definitions used for the Opening.
10. Added HOutside child element to Layer element so that exterior heat transfer coefficients can be addressed in the Layer
11. Added new child element "OAFlowPerZone" to Zone element. Includes enumeration: "flowUnitEnum": Air flow per zone (m^3/s)
12. Added new child element "AirStreamFraction" to AirLoopEquipment element: % of fan in air stream
13. Added new child element "MaximumFlow" to AirLoopEquipment: Maximum Flow per Zone Floor Area During Reheat {m3/s-m2}
14. Added new child element "MaximumFlowFractionDuringReheat" to AirLoopEquipment: Maximum flow fraction during reheat
15. Added new child element: "SecondaryFlow" to Zone: supply air maximum flow rate {m3/s}
16. Added new child element: "FlowType" to AirLoopEquipment. Flow type: parallel, series
17. Added enumeration: FlowType: series, parallel
18. Added new child element "ParallelFanOnFlowFraction" to AirLoopEquipment.
19. Added new child element "MaxOAFlowPerZone" to Zone element.
20. Added new child element "MinOAFlowPerZone" to Zone element.
21. Added new child element "EconomizerLockout" to AirLoopEquipment.
22. Added new enumeration: "enthalpyTypeEnum" that is used by the "Enthalpy" element to describe the type of enthalpy
23. Added new attribute to "Enthalpy" callted "enthalpyType" of type "enthalpyTypeEnum" that describes the type of enthalpy (see #22 above).
24. Added new enumeration value to "tempType" enumeration: "EconomizerMaxLimitDewpoint"
25. Added new enumeration "nightCycleControlEnum"
26. Added new child element "NightCycleControl" of type nightCycleControlEnum to "AirLoopEquipment" element.
27. Added new enumeration "heatRecoveryTypeEnum"
28. Added new child element "HeatRecoveryType" of type heatRecoveryTypeEnum to "AirLoopEquipment" element.
29. Added new child element "SensibleHeatRecoveryEffectiveness" to "AirLoopEquipment" element.
30. Added new child element "LatentHeatRecoveryEffectiveness" to "AirLoopEquipment" element.
31. Added enumeration "heatingCoilSetpointResetTypeEnum"
32. Added enumeration "coolingCoilSetpointResetTypeEnum"
33. Added new child element "HeatingCoilSetpointResetType" to AirLoopEquipment element.
34. Added new child element "CoolingCoilSetpointResetType" to AirLoopEquipment element.
35. Added enumeration "minimumOutdoorAirControlTypeEnum"
36. Added new child element "MinimumOutdoorAirControlType" to Zone element
37. Added enumeration "damperHeatingActionEnum"
38. Added new child element "DamperHeatingAction" to "AirLoopEquipment" element.
39. Added new child element "CoolingSizingFactor" to "Zone" element
40. Added new child element "HeatingSizingFactor" to "Zone" element
41. Added new enum item to tempTypeEnum: "HeatPumpDefrostMaxOADryBulb"
42. Added new enumeration "defrostControlEnum"
43. Added new enumeration "defrostStrategyEnum"
44. Added new child element "HeatPumpDefrostControl" of type defrostControlEnum and real to "AirLoopEquipment"
45. Added new child element "HeatPumpDefrostStrategy" of type defrostStrategyEnum to "AirLoopEquipment"
46. Added new enumeration "supplementalHeatingCoilTypeEnum"
47. Added new child element "SupplementalHeatingCoilType" of type supplementalHeatingCoilTypeEnum to "AirLoopEquipment"
48. Added new child element "SupplementalHeatingCoilCapacity" to "AirLoopEquipment" element .
49. Added new enum item to tempTypeEnum: "SupplementalHeatingCoilMaxOADryBulb"
50. Added new child element "SupplementalGasHeatingCoilParasiticElectricLoad" to "AirLoopEquipment" element.
51. Added new enumeration "baseboardHeatingTypeEnum"
52. Added new child element "BaseboardHeatingType" of type "baseboardHeatingTypeEnum" to "Zone" element
53. Added new child element "BaseboardHeatingCapacity" to "Zone" element
54. Added new child element "CyclingRateMax" to "AirLoopEquipment" element.
55. Added new child element "HeatPumpTimeConstant" to "AirLoopEquipment" element.
56. Added new child element "FractionOnCyclePowerUse" to "AirLoopEquipment" element.
57. Added new child element "HeatPumpFanDelayTime" to "AirLoopEquipment" element.
58. Added new enumeration "coolingCoilTypeEnum"
59. Added new child element "CoolingCoilType" to "AirLoopEquipment" element.
60. Added new enumeration "preheatCoilTypeEnum"
61. Added new child element "PreheatCoilType" to "AirLoopEquipment" element.
62. Added new enum to tempTypeEnum: PreheatCoilDesignSetpoint.
63. Added new child element "GasPreheatCoilEfficiency" to "AirLoopEquipment" element.
64. Added new child element "GasPreheatCoilParasiticElectricLoad" to "AirLoopEquipment" element.
65. Updated notes for a number of elements
5.12
8/2014
1. Added "ExposedFloor" enumeration to surfaceTypeEnum
2. Surface element attribute constructionIdRef is a required attribute.
3. Surface element child AdjacentSpaceId, minimum 1, maximum 2 (meaning it is a required field)
4. Space element Area child - min 1, max 1 (is a required field)
5. Space element Volume child - min 1, max 1 (is a required field)
6. Added "CubicMPerHourPerSquareM" enumeration to flowPerAreaUnitEnum
7. At element FlowControl, added new element “RecircFlow” with unit attribute and flowUnitEnum
8. Added "ActivityLevel" enumeration to scheduleTypeEnum
9. Added "Custom" enumeration to dayTypeEnum
10. At element FlowControl, added new element “RecircFlow” with unit attribute and flowUnitEnum
11. At element TemperatureControl added existing element ResetTemperature as an optional child, with unit attribute of temperatureUnitEnum
12. Added new attribute “resetSchedIDRef” to ResetTemperature element
13. Added “Scheduled” enumeration to resetTemperatureTypeEnum
14. Added “ResetTemp" enumeration to scheduleTypeEnum
15. Added optional attributes to ScheduleValue: OutsideHighReset, OutsideLowReset, SupplyHighReset, SupplyLowReset
16. Added optional attribute to Zone element: fanTempSchedIdRef
17. Added "Fraction" enumeration to flowUnitEnum
18. Added "TwoWayValve" and "ThreeWayValve" enumerations to hydronicEquipTypeEnum
19. Added existing element "DesignCoolT" to element "HydronicLoop"
5.11
11/2013
1. Made ZipcodeOrPostalCode element under Location element required field.
2. Made Name and HolidayDate elements under HolidaysModeled element required fields
5.10
10/2012
1. Added new element: ProjectEntity under ProgramInfo and it contains three new elements Filename, URI, and GUID.
2. Added new element: Filename for storing filenames of project files that created or modified the gbXML file.
3. Added new element: URI for storing location of filename or project that created or modified the gbXML file.
4. Added new element: GUID for storing unique ids for models, projects, simulations, and files that created or modified the gbXML file. GUID also has entity attribute that uses entityType enumeration.
5. Added new enumeration: entityType which has four values, Model, File, Project, Run.
6. Added programId attribute to the following elements; LightPowerPerArea, EquipPowerPerArea, InfiltrationFlow, PeopleNumber, PeopleHeatGain, Temperature, PeakDomesticHotWaterFlow, Weather, Schedule, IntEquip, ExtEquip, OAFlowPerPerson, OAFlowPerArea, DesignHeatT, DesignCoolT, Construction, HydronicLoop, HydronicLoopEquipment, AirLoop, AirLoopEquipment, LightingSystem, LightingControl, Lighting, WindowType, Vegetation, Weather, Meter, Transportation, Zone, ShadeControl, AltEnergySource, FlowPerArea, FlowPerPerson, and Flow.
7. Added Lux and Phot to illuminanceUnitEnum.
8. Added Damper, Boiler, Chiller to controlTypeEnum.
9. Added unit attribute using temperatureUnitEnum to DesignTemp, MinTemp, and MaxTemp.
10. Added unit attribute using flowUnitEnum to DesignFlow, MaximumFlow, and MinimumFlow.
11. Added LPM to flowUnitEnum.
12. Added primaryLoopId attribute to HydronicLoop.
13. Added Location element to Weather element.
14. Remove City, Country, StateorProvince elements from Weather element as Location element superceeds it.
15. Added Modeled to stationTypeEnumeration.
16. Added DataCenter to buildingTypeEnum.
17. Added ServerRoom to spaceTypeEnum.
18. Remove CADModelId from CreatedBy element as ProgramInfo and ProjectEntites superceeds it.
19. Changed minOccurs value to 4 for Surface sub-element of Campus main element
20. Changed minOccurs value to 0 for Surface main element
21. Updated the versionEnum with the latest gbXML version numbers
22. Updated the surfaceTypeEnum annotations to better clarify the angle constraints
5.01
4/2012
1. Deleted "surfaceNormalConvention" element. No longer used.
2. Deleted "surfaceNormalEnum" enumeration. No longer used.
5.00
10/2011
1. Added new element: YearModeled. It consists of BeginDate, EndDate, and HolidaysModeled child elements.
2. Added new element: HolidaysModeled. It consists of Name, Description, and HolidayDate child elements.
3. Added new element: HolidayDate (type: date)
4. Added YearModeled child element to Campus element
5. Added 5 new enumeration items to the extEquipTypeEnum enumeration (Types of exterior equipment):
a. WindTurbine
b. Photovoltaic
c. CogenDiesel
d. CogenFuelCell
e. CogenGasTurbine
6. Added new element: HeatRejectedtoSpace with unitlessUnitEnum attribute
7. Added new element: Weight with attribute weightUnitEnum
8. Added Weight, HeatRejectedtoSpace child elements to IntEquip element
9. Added Weight child element to ExtEquip, airLoopEquip, HydronicEquip elements
10 Added new element: HeatRejectedtoSpace (type: decimal). Also added annotation explaining this element
11. Added HeatRejectedtoSpace child element to intEquip
12. Added Exhaust item to enumeration systemTypeEnum
13. Added new enumeration: resetTemperatureTypeEnum with 3 items: None, Automatic, OutdoorAirBased
14. Added new element: ResetTemperature with attributes: temperatureUnitEnum, resetTemperatureTypeEnum
15. Added ResetTemperature child element to AirLoopEquipment element
16. Updated the annotation of the AirLoopEquipment element to explain how they should be ordered in an AirLoop
17. Added new element: MotorInAirstream (type: boolean)
18. Added MotorInAirstream child element to AirLoopEquipment element
19. Added new element: Enthalpy with attribute enthalpyUnitEnum
20. Added new enumeration: enthalpyUnitEnum with 2 items: BTUPerLb and KJPerKg
21. Added Enthalpy child element to AirLoopEquipment element
22. Added 2 enumeration items to equipmentTypeEnum: EvaporativePreCooler, PreHeatCoil
23. Added 2 enumeration items to efficiencyTypeEnum: BTUPerHourPerF, kWPerC. Also, added annotation saying that this applies to StandByLoss for water heaters
24. Updated SolarHeatGainCoeff child element of Opening element so that it is unbounded (i.e. - many SHGC values for an Opening)
25. Updated AdjacentSpaceId annotation to better explain its use
26. Updated PolyLoop annotation to better explain its use
27. Added ProductName, Version, Platform elements (All of type: string)
28. Added AirChangesPerHour child element to Space element
29. Updated ShellGeometry annotation with clarification
30. Updated SpaceBoundary annotation with clarification
31. Added oppositeIdRef attribute (type: IDREF) to SpaceBoundary
32. Added SpaceBoundary child element to Building element along with annotation
33. Added new element: FamilyName (type: string)
34. Added FamilyName child element to Surface
35. Added new elements: Address1, Address2, City, State, ZipCode, Country, PhoneNumber (all of type: string)
36. Added Address1, Address2, City, State, ZipCode, Country, PhoneNumber child elements to PersonInfo element
37. Added ExtEquipId child element to both Construction and WindowType elements for purposes of modeling BIPV.
38. Added 2 enumeration items to powerTypeEnum: Diesel, Biogas
39. Added 1 enumeration item to powerUseTypeEnum: ElectricityGeneration
40. Added 2 enumeration items to tempTypeEnum: HighTempLockout, LowTempLockout
41. Added new enumeration: windSpeedEnum with 3 items: RatedWindSpeed, CutInWindSpeed, CutOutWindSpeed
42. Added new element: WindSpeed with attributes velocityUnitEnum, windSpeedEnum
43. Added WindSpeed child element to ExtEquip element
44. Added ResetTemperature child element to HydronicLoopEquipment element
45. Updated Equation element documentation to clarify dependent vs. independent variables
45. Updated IndependentVariable child element of Equation element to allow for infinite number of independent variables
46. Updated all instances of text "Dependent" and "Independent". It was misspelled.
47. Updated Performance element documentation to clarify that it can represent all types of performance metrics
0.37
12/08
Added version attribute to gbXML element.
Added the ability to have additional SolarHeatGainCoeff values for Openings and WindowTypes for different angles of incidence defined by a new attribute in the SolarHeatGainCoeff element.
Added the Photometry element to the LightingSystem element.
Added the CADModelID to the CreatedBy element to track the CAD/BIM model the gbXML was created from.
Added CoefficientOfUtilization element to Lighting element.
Added PhotometryOrientation element to Lighting element.
Added Radiator to hydronicEquipTypeEnum.
Added 25 additional systemTypeEnums.
0.36
02/08
Corrected buildingStoreyIdRef attribute in Space element.
Added HydronicLoopEquipmentId element to Space element.
Added airChangesSchedIdRef attribute to Zone element.
Add constraint to Surface element to have a minimum of four defined.
Corrected spelling error in PercentAreaDaylitControlled element in LightingControl element.
Added the following elements to allow USDA-FS to conduct urban/wildland interface fire modeling: BiomassDensity element to Vegetation element, WFTDTemp, WFTDRelHumidity, WFTDWindSpeed, WFTDWindDir, and WFTDPressure to Weather element, Fire to Material element and FireFace to Construction element.
Changed DocumentHistory/CreatedBy and DocumentHistory/ProgramInfo elements to be required.
0.35
8/06
Corrected spelling error in capacityTypeEnum.
Added SingleFamily to buildingTypeEnum.
Replaced sequence requirement with unbound choice.
0.34
8/19/03
Convert spaceTypeEnum facets to Pascal case and added DiningCafeteriaFastFood to buildingTypeEnum. Ensured all enumeration facets are in Pascal case.
6/25/03
Added CartesianPoint element to Results element.
Set minNumber for ZipcodeOrPostalCode element under the Location element to 1.
Set Campus element id attribute use to required.
Set Building element id attribute use to required.
Corrected Surface element id attribute use to required.
0.33
1/15/02
Added PolyLoop element to RectangularGeometry for describing polygons
Changed CartesianPoint element to allow only two Coordinate elements for describing flat geometry
Added PeakDomesticHotWaterFlow element to Building
Created PeakDomesticHotWaterFlow element
Moved simple type elements into complex type elements - easier to find correct element
Added enumeration to conditionTypeEnum
1/14/02
Made HydronicLoopId repeatable in AirLoopEquipment and HydronicLoopEquipment
Added Name and Description as optional elements to the Results element
1/10/02
Created heatGainTypeEnum enumeration and assigned it to the PeopleHeatGain element
Created PeopleHeatGain element and added it to the Space element
Removed TotalPeopleHeatGain and PeopleLatentHeatGain elements
Added systemType attribute to the AirLoop element, and added systemTypeEnum enumeration
Removed Lighting element from gbXML root element
Replaced LightId in Campus and Building elements with Lighting elements that refrence LightingSystem elements directly
Changed InfiltrationFlow/@type to optional
Added an optional HydronicLoop/@primaryLoopId attribute
0.32
12/12/01
Changed xsd:any namespace="##any" to ##other for GeneralGeometry and Meter elements
12/10/01
Removed gbXML/CreatorPersonInfo and gbXML/CreatorCadInfo
Created Surface/RectangularGeometry and Opening/RectangularGeometry and their children
Created gbXML/DocumentHistory and its children
Updated schema to version http://www.w3.org/2001/XMLSchema
Changed enumerations for spaceTypeEnum to remove spaces and slashes
Changed Results/@timeIncrement to type xsd:duration as required for the 2001 schema specification
0.31
8/1/01
Added HydronicLoopId to AirLoopEquipment element
7/26/01
Added Control element to equipment elements
Added FlowControl element to HydronicLoop element
Added PressureControl element to AirLoop element
Added TemperatureControl element to both loop elements
Added enumerations to tempTypeEnum
7/25/01
Added xmlns to schema element
Added conditioningTypeEnum
Changed enumerations for efficiencyTypeEnum
Changed enumerations for resourceTypeEnum
Added stadardsTypeEnum
Added DependentValue element
Added IndependentValue element
Removed XValue element
Removed YValue element
Added RefrigerantType to AirLoopEquipment element
Changed structure of Data element
Added attributes to DeltaP element
Added conditionType attribute to DeltaT element
Made Name and Description elements optional in the DependentVariable element
Added minValue and maxValue attributes to the DependentVariable element
Changed structure of the Efficiency element
Allowed up to 2 IndependentVariable elements in the Equation element
Added fluidType attribute to the HydronicLoop element
Changed structure of HydronicLoopEquipment element
Made Name in IndependentVariable element optional
Changed structure of MinFlow element
Added id attribute to the Performance element
Changed structure of PointData element
7/9/01
Added hydronicLoopType to HydronicLoopId
Added HydronicLoopId to HydronicLoopEquipment
7/3/01
Added ShadeControl to Opening
Added ShadeSchedule, SolarOnOpening, HorizontalSolar, AirTempature, ZoneCoolingLoad, and Glare to ShadeControl
Added attributes, enumerations, and documentation for these new elements
Removed frameIdRef, blindIdRef, GlazeId, GapId from Opening - they are redundant and already contained in WindowType
0.30
6/28/01
Changed Results element
Removed MaterialType - it did not add information
0.29
4/30/01
Added StreetAddress element to Building - removed Location.
Changed SIResults element to useSIUnitsForResults.
Made several attributes at the gbXML level required instead of defaulting to SI.
Campus/@buildingType removed - Building/@buildingType required.
Changed SpaceId element to AdjacentSpaceId.
Moved CADObjectId after PlanarGeometry in the Opening element.
Made PlanarGeometry/@id optional.
Removed shadeTypeEnum (no longer used).
4/27/01
Added annotation to several elements and attributes.
Added Enum to the end of enumerations to clarify distinction between 'type', meaning simple type (used for enumerations) and 'type', used in classifying an object (example: buildingType, surfaceType).
0.28
4/12/01
Added uValueUnit.
Made exposedToSun default = true.
4/10/01
Changed sequence of gbXML, Campus, Building, Surface, and Location children.
Added more of a description for Location.
Made Building/@id, Surface/@id optional.
Moved Surface to be child of Campus.
Added enumerations to conditionType.
Changed ShadingSurface element to ExposedToSun boolean attribute.
Renamed SpaceRef to SpaceId, @spaceRef to @spaceIdRef
Removed Name and Description from PlanarGeometry.
Added explicit right-hand-rule documentation to the PolyLoop element.
Constrained PolyLoop to at least 3 CartesianPoints.
Constrained CartesianPoint to exactly 3 Coordinates.
Added @lengthUnit, @areaUnit, @volumeUnit, and @temperatureUnit to the gbXML element.
Changed documentation for Latitude and Longitude.
4/6/01
Added targetNamespace.
Removed gbXML/@version.
Made gbXML/@id optional.
Removed GeoPraxisEAM from gbXML/@engine.
Renamed gbXML/SI to gbXML/SIResults and added documentation.
Removed @unit from Latitude and Longitude and made simple type - must be in decimal degrees.
Added global enumerations to be called out elsewhere.
0.27
2/13/01
Removed buildingType attribute from Space.
Added spaceType attribute to Space.
Changed FloorArea to Area.
Changed CADObjectIdRef attribute to CADObjectId element to allow for multiples.
Changed to surface-centric model.
Changed Geometry to PlanarGeometry, ShellGeometry, and GeneralGeometry
2/12/01
Changing from X3D elements to ifcXML elements.
Removed X3D element.
Placed in alphabetical order.
Seperated complex types from simple type elements.
Changed back to sequence type - all had unusable restrictions.
0.26
2/7/01
Replaced sequence types with type all.
Removed empty sequence elements.
ACCA has given permission to gbXML authors to use this trademark ACCA and Manual J in the gbXML schema. Users of the gbXML schema are restricted from using the ACCA trademarks for any other purposes without express permission from ACCA.
"ASHRAE" is a registered service mark of ASHRAE. All rights reserved.
Enumerations
Use to specify the most predominant building use type.
Enumeration value to be used when there is no building type information available.
Coefficient of Performance
Energy Efficiency Ratio
Seasonal Energy Efficiency Ratio
Annual Fuel Utilization Efficiency
Heating Seasonal Performance Factor
Thermal Efficiency
Motor Efficiency
Fan Efficiency
Mechanical Efficiency
Boiler Efficiency
Used with the floorCategory attribute.
Used with the floorSlabPerimeterHeatLossCoefficientUnitType attribute.
Used with the hOutsideUnitType attribute.
Opening in a surface with a tilt between 45° and 149.99° with a non-operable glazed opening in it.
Opening in a surface with a tilt between 45° and 149.99° with a operable glazed opening in it.
Opening in a surface with a tilt between 0° and 44.99° with a non-operable glazed opening in it.
Opening in a surface with a tilt between 0° and 44.99° with a operable glazed opening in it.
Opening in a surface with a tilt between 45° and 149.99° with a sliding door in it.
Opening in a surface with a tilt between 45° and 149.99° with a non-sliding door in it.
Opening in a surface with a tilt between 0° and 180° with nothing in it.
Used with the roofASHRAENumber attribute. Each annotation for the values is only one example of many possible constructions for that ASHRAE roof number. The user should select the one that best matches the thermal characteristics of the roof, not necessarily the one closest to the example description.
Undefined
Steel sheet with 1 or 2 inches insulation
One inch wood with 1 inch insulation
Four inch light weight concrete
Two inch heavy weight concrete
One inch wood with 2 inch insulation
Six inch light weight concrete
2.5 inch wood with 1 inch insulation
Eight inch light weight concrete
4 inch hvy wt concrete with 1-2 inch insulation
2.5 inch wood with 2 inches of insulation
Roof Terrace System
6 inch hvy wt concrete with 1-2 inch insulation
4 inch wood with 1-2 inches of insulation
Used with the roofCLTDIndex attribute.
Under attic or knee wall, U-value = 0.408 - 0.018, Unvented Attic, No Radiant Barrier, Any Roofing Material, Any Roof Color
Under attic or knee wall, U-value = 0.408 - 0.018, Vented Attic, No Radiant Barrier, Dark Asphalt Shingles or Dark Metal, Tar and Gravel or Membrane
Under attic or knee wall, U-value = 0.408 - 0.018, Vented Attic, No Radiant Barrier, White or Light Color Shingles, Any Wood Shake Light Metal, Tar and Gravel or Membrane
Under attic or knee wall, U-value = 0.408 - 0.02, Vented Attic, No Radiant Barrier, Dark Tile, Slate or Concrete
Under attic or knee wall, U-value = 0.408 - 0.02, Vented Attic, No Radiant Barrier, Light Tile, Slate or Concrete
Under attic or knee wall, U-value = 0.408 - 0.02, Vented Attic, No Radiant Barrier, White Tile, Slate or Concrete, White Metal or White Membrane
On exposed beams, U-value = 0.287 - 0.134, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
On exposed beams, U-value = 0.118 - 0.091, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
On exposed beams, U-value = 0.074 - 0.063, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
On exposed beams, U-value = 0.054, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
On exposed beams, U-value = 0.048, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
On exposed beams, U-value = 0.043 - 0.039, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
On exposed beams, U-value = 0.035, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
On exposed beams, U-value = 0.032 - 0.027, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
On exposed beams, U-value = 0.287 - 0.134, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
On exposed beams, U-value = 0.118 - 0.091, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
On exposed beams, U-value = 0.074 - 0.063, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
On exposed beams, U-value = 0.054, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
On exposed beams, U-value = 0.048, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
On exposed beams, U-value = 0.043 - 0.039, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
On exposed beams, U-value = 0.035, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
On exposed beams, U-value = 0.032 - 0.027, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
On exposed beams, U-value = 0.287 - 0.134, White or Light Color Tile, Slate or Concrete, White Metal, White Membrane
On exposed beams, U-value = 0.118 - 0.091, White or Light Color Tile, Slate or Concrete, White Metal, White Membrane
On exposed beams, U-value = 0.074 - 0.063, White or Light Color Tile, Slate or Concrete, White Metal, White Membrane
On exposed beams, U-value = 0.054, White or Light Color Tile Slate or Concrete, White Metal, White Membrane
On exposed beams, U-value = 0.048, White or Light Color Tile Slate or Concrete, White Metal, White Membrane
On exposed beams, U-value = 0.043 - 0.039, White or Light Color Tile, Slate or Concrete, White Metal, White Membrane
On exposed beams, U-value = 0.035, White or Light Color Tile Slate or Concrete, White Metal, White Membrane
On exposed beams, U-value = 0.032 - 0.027, White or Light Color Tile, Slate or Concrete, White Metal, White Membrane
Below roof joists, U-value = 0.241 - 0.109, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
Below roof joists, U-value = 0.09 - 0.076, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
Below roof joists, U-value = 0.069, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
Below roof joists, U-value = 0.051 - 0.047, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
Below roof joists, U-value = 0.034, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
Below roof joists, U-value = 0.029, Dark or Bold-Color Asphalt Shingle, Dark Metal, Dark Membrane, Dark Tar and Gravel
Below roof joists, U-value = 0.241 - 0.109, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
Below roof joists, U-value = 0.09 - 0.076, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
Below roof joists, U-value = 0.069, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
Below roof joists, U-value = 0.051 - 0.047, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
Below roof joists, U-value = 0.034, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
Below roof joists, U-value = 0.029, White or Light Color Asphalt Shingle, Any Wood Shake, Dark or Medium Color Tile, Slate or Concrete, Light or Unpainted Metal, Light or Silver Membrane, Light Tar and Gravel
Below roof joists, U-value = 0.241 - 0.109, White or Light Color Tile, Slate or Concrete, White Metal, White Membrane
Below roof joists, U-value = 0.09 - 0.076, White or Light Color Tile, Slate or Concrete, White Metal, White Membrane
Below roof joists, U-value = 0.069, White or Light Color Tile, Slate or Concrete, White Metal, White Membrane
Below roof joists, U-value = 0.051 - 0.034, White or Light Color Tile, Slate or Concrete, White Metal, White Membrane
Below roof joists, U-value = 0.029, White or Light Color Tile, Slate or Concrete, White Metal, White Membrane
Used with the roofColor attribute. Only enter Light if the construction is a roof and if it's in a rural location.
Dark colored or light colored in an industrial area
Permanently light colored and in a rural area
Used with the roofCTSType attribute. Each annotation for the values is only one example of many possible constructions for that CTS type. The user should select the one that best matches the thermal characteristics of the roof, not necessarily the one closest to the example description.
Metal Roof, R-19 Batt Insulation, Gyp Board
Metal Roof, R-19 Batt Insulation, Suspended Acoustical Ceiling
Metal Roof, R-19 Batt Insulation
Asphalt Shingles, Wood Sheathing, R-19 Batt Insulation, Gyp Board
Slate or Tile, Wood Sheathing, R-19 Batt Insulation, Gyp Board
Wood Shingles, Wood Sheathing, R-19 Batt Insulation, Gyp Board
Membrane, Sheathing, R-10 Insulation Board, Wood Deck
Membrane, Sheathing, R-10 Insulation Board, Wood Deck Suspended Acoustical Ceiling
Membrane, Sheathing, R-10 Insulation Board, Metal Deck
Membrane, Sheathing, R-10 Insulation Board, Metal Deck Suspended Acoustical Ceiling
Membrane, Sheathing, R-15 Insulation Board, Metal Deck
Membrane, Sheathing, R-10 plus R-15 Insulation Boards, Metal Deck
2" Concrete Roof Ballast, Membrane, Sheathing, R-15 Insulation Board, Metal Deck
Membrane, Sheathing, R-15 Insulation Board, 4" LW Concrete
Membrane, Sheathing, R-15 Insulation Board, 6" LW Concrete
Membrane, Sheathing, R-15 Insulation Board, 8" LW Concrete
Membrane, Sheathing, R-15 Insulation Board, 6" HW Concrete
Membrane, Sheathing, R-15 Insulation Board, 8" HW Concrete
Membrane, 6" HW Concrete, R-19 Batt Insulation, Suspended Acoustical Ceiling
Department of Energy
Air-Conditioning and Refrigeration Institute
American National Standards Institute
National Electrical Manufacturers Association
A five-digit station identifier assigned by the World Meteorological Organization (WMO), used for international weather data exchange and station documentation.
Weather-Bureau-Army-Navy station id. A five-digit station identifier used at National Climatic Data Center (NCDC) for digital data storage and general station identification purposes.
A 4-letter indicator for geographical locations throughout the world, managed by the International Civil Aviation Organization (ICAO).
A 3- to 5-character alpha-numeric identifier assigned by the US National Weather Service (NWS), used for site identification in the NWS communications systems (e.g. AFOS, ROSA, SHEF, etc.).
An alpha-numeric identifier of up to 4-characters managed by the USDT Federal Aviation Administration (FAA), used for site identification of airports, weather stations and other sites vital to navigation.
A 6-digit number identifying a station in the NWS Cooperative Network.
A custom code identifying a virtual station for a particular grid location on the planet that was modeled by a simulation program such as MM5, WRF, or other weather simulation programs.
The surfaceDescriptionEnum allows control over the specification of material surface properties. By setting the surfaceDescriptionEnum to 1, it is implied that the attribute (e.g. - Reflectance, Emittance, etc.) is associated with Surface 1 of the material's two surfaces [it is assumed that the material is a large planar object]. Surface 1 represents the surface that points away from the building interior.
The surfaceDescriptionEnum allows control over the specification of material surface properties. By setting the surfaceDescriptionEnum to 2, it is implied that the attribute (e.g. - Reflectance, Emittance, etc.) is associated with Surface 2 of the material's two surfaces [it is assumed that the material is a large planar object]. Surface 2 represents the surface that points towards the building interior.
The surfaceDescriptionEnum allows control over the specification of material surface properties. By setting the surfaceDescriptionEnum to Both, it is implied that the attribute (e.g. - Reflectance, Emittance, etc.) is associated both Surface 1 and Surface 2 of the material's 2 surfaces [it is assumed that the material is a large planar object]. See the enumerations above for a description of Surface 1 and 2.
The portion of the building envelope, including opaque area and fenestration, that is adjacent to two conditioned or unconditioned spaces and that is vertical or tilted at an angle of 60° from horizontal or greater.
The portion of the building envelope, including opaque area and fenestration, that is adjacent to one conditioned or unconditioned space and that is vertical or tilted at an angle of 60° from horizontal or greater.
The upper portion of the building envelope, including opaque areas and fenestration, that is adjacent to one conditioned or unconditioned space and that is horizontal or tilted at an angle of less than 60° from horizontal.
The lower portion of the building envelope, including opaque area and fenestration, that has conditioned or semiheated space above and is horizontal or tilted at an angle of less than 60 degrees from horizontal but excluding slab-on-grade floors.
The floor area exposed to non-conditioned space or outside.
Surface not adjacent to any spaces with tilt between 0° and 180°.
The portion of the building envelope, including opaque area and fenestration, that is adjacent to one conditioned or unconditioned space and earth (soil) and that is vertical or tilted at an angle of 60° from horizontal or greater.
Surface adjacent to one conditioned or unconditioned space and earth (soil) below grade with a tilt between 150° and 180°.
The upper portion of the building envelope that is adjacent to two conditioned or unconditioned spaces and that is horizontal or tilted at an angle of less than 60° from horizontal.
Air membrane between two conditioned or unconditioned spaces with a tilt between 0° and 180°.
The portion of the building envelope, including opaque area and fenestration, that is adjacent to one conditioned or unconditioned space and earth (soil) and that is horizontal or tilted at an angle of less than 60° from horizontal.
The lower portion of the building envelope, including opaque area and fenestration, that is adjacent to one conditioned or unconditioned space and the outside and is horizontal or tilted at an angle between 150° and 180°.
The lower portion of the building envelope, including opaque area and fenestration, that is adjacent to one conditioned or unconditioned space and earth (soil) at grade with a tilt between 150° and 180°.
Freestanding column in space specified by its top surface having the same ifcGUID.
Embedded column in wall specified by a surface which is coplanar with (one of) the embedding wall(s).
Variable Temperature
Packaged Single-zone
Ceiling Induction
Constant-volume Reheat Fan
Variable-volume Fan
Powered Induction Unit
Packaged Variable Air Volume
Packaged Variable-Volume Variable-Temperature
Ceiling Bypass
Evaporative Cooling
Multizone Fan
Packaged Multizone
Dual-duct Fan
Fan Coil
Induction Unit
Packaged Terminal Air Conditioner
Water Loop Heat Pump
Residential with cycling furnace and cycling air-conditioner
Residential Variable-Volume Variable-Temperature
Floor Panel Heating
Heating and Ventilating
Unit Heater
Unit Ventilator
Central Heating Radiators
Central Heating Convectors
Central Heating Radiant Floor
Central Heating Hot Air
Other Room Heater
Radiant Heater No Flue
Radiant Heater Flue
Radiant Heater Multiburner
Forced Convection Heater Flue
Forced Convection Heater No Flue
VAV Single Duct
VAV Dual Duct
VAV Reheat Fan
VAV Indoor Packaged Cabinet
Constant Volume Fixed OA
Constant Volume Variable OA
Constant Volume Terminal Reheat
Multizone Hot Deck Cold Deck
Constant Volume Dual Duct
Radiant Cooled Ceilings
Active Chilled Beams
Variable Refrigerant Flow
Split Systems With Natural Ventilation
Split Systems With Mechanical Ventilation
Split Systems With Mechanical Ventilation With Cooling
Exhaust Air Systems
Used with the wallASHRAEGroup attribute. Each annotation for the values is only one example of many possible constructions for that ASHRAE wall group. The user should select the one that best matches the thermal characteristics of the wall, not necessarily the one closest to the example description.
4-in. face brick, insulation + 8-in. com. brick
4-in. face brick, 2-in. insul., 4-in. com. brick
4-in. face brick, air space + 4-in. face brick
4-in. face brick + 4-in. common brick
4-in. face brick + 4-in. block
4-in. block + air space or insulation
Metal curtain wall + 1 to 3-in. insulation
Used with the wallColor attribute. Only enter Light or Medium if the construction is a wall and if it's in a rural location.
Dark colored or light colored in an industrial area
Permanently medium colored and in a rural area
Permanently light colored and in a rural area
Used with the wallCTSType attribute. Each annotation for the values is only one example of many possible constructions for that CTS type. The user should select the one that best matches the thermal characteristics of the wall, not necessarily the one closest to the example description.
Spandrel Glass, R-10 Insulation Board, Gyp Board
Metal Wall Panel, R-10 Insulation Board, Gyp Board
1" Stone, R-10 Insulation Board, Gyp Board
Metal Wall Panel, Sheathing, R-11 Batt Insulation, Gyp Board
1" Stone, Sheathing, R-11 Batt Insulation, Gyp Board
Wood Siding, Sheathing, R-11 Batt Insulation, 1/2"
Wood
1" Stucco, Sheathing, R-11 Batt Insulation, Gyp Board
EIFS Finish, R-5 Insulation Board, Sheathing, Gyp Board
EIFS Finish, R-5 Insulation Board, Sheathing, R-11 Batt Insulation, Gyp Board
EIFS Finish, R-5 Insulation Board, Sheathing, 8" LW CMU, Gyp Board
Brick, R-5 Insulation Board, Sheathing, Gyp Board
Brick, Sheathing, R-11 Batt Insulation, Gyp Board
Brick, R-5 Insulation Board, Sheathing, R-11 Batt Insulation Gyp Board
Brick, R-5 Insulation Board, 8" LW CMU
Brick, 8" LW CMU, R-11 Batt Insulation, Gyp Board
Brick, R-5 Insulation Board, 8" HW CMU, Gyp Board
Brick, R-5 Insulation Board, Brick
Brick, R-5 Insulation Board, 8" LW Concrete, Gyp Board
Brick, R-5 Insulation Board, 12" HW Concrete, Gyp Board
Brick, 8" HW Concrete, R-11 Batt Insulation, Gyp Board
8" LW CMU, R-11 Batt Insulation, Gyp Board
8" LW CMU w Fill Insulation, R-11 Batt Insulation, Gyp Board
1" Stucco, 8" HW CMU, R-11 Batt Insulation, Gyp Board
8" LW CMU w Fill Insulation
8" LW CMU w Fill Insulation, Gyp Board
12" LW CMU w Fill Insulation, Gyp Board
4" LW Concrete. R-5 Board Insulation, Gyp Board
4" LW Concrete. R-11 Batt Insulation, Gyp Board
4" LW Concrete. R-10 Board Insulation, 4" LW Concrete
EIFS Finish, R-5 Insulation Board, 8" LW Concrete, Gyp Board
8" LW Concrete. R-11 Batt Insulation, Gyp Board
EIFS Finish, R-10 Insulation Board, 8" HW Concrete, Gyp Board
8" HW Concrete. R-11 Batt Insulation, Gyp Board
12" HW Concrete. R-19 Batt Insulation, Gyp Board
12" HW Concrete
Used with the wallGroupManualJ attribute.
Fastest heat transfer
Medium heat transfer
Slowest heat transfer
Analysis engine used
This attribute specifies the default temperature unit for the entire gbXML document, wherever the temperatureUnit simple type is used.
This attribute specifies the default length unit for the entire gbXML document, wherever the lengthUnit simple type is used.
This attribute specifies the default area unit for the entire gbXML document, wherever the areaUnit simple type is used.
This attribute specifies the default volume unit for the entire gbXML document, wherever the volumeUnit simple type is used.
Results will be given in SI or IP units. True = SI units which is the implied default. If False, results will be in english units.
Use this attribute to determine what type of geometry information is included in the geometry elements. This is specified using an enumeration that includes shell/wall paper and centerline coordinates.
Absorptance of the outside surface
References the ID of a Space that is bounded by this surface. First AdjacentSpaceId entered will determine how the referenced construction layers are ordered with the first construction layer being in contact with the outside or 2nd space listed and the last layer in contact with the first space listed. The outward normal of the surface, as defined by the right hand rule of the coordinates in the planar geometry element, is always pointing away from the first AdjacentSpaceID listed.
With interior horizontal surfaces, this attribute can distinguish between ceiling and floor surfaces to avoid double-counting of floor areas, etc. If not present, the surface type can be assumed based on the description of the surface type enums. When the surfaceTypeEnum is provided and the surface attributes (i.e. adjacency, tilt angle) do not match the enumeration's description, the enumeration should have precedence.
The AirLoop element represents the equipment serving one path of air
Please specify the program that added this element.
A piece of equipment serving an air-loop. This is generalized to be able to contain any type of air loop equipment. The air loop equipment are ordered as they exist on the airloop. A blow-through system should have fan listed before the coils. A draw-through system should have the fan listed after the coils.
Maximum flow per zone floor area during reheat
Maximum flow flow fraction during reheat
Please specify the program that added this element.
ID pointing at an air loop equipment object
ID pointing to an air loop
Fraction of motor in air stream
Minimum air temperature before shades are closed.
Cooling and Heating Reset Temperature Type
Reflectance of solar radiation
Alternative energy source
Please specify the program that added this element.
Specifies the area of the space or building. This value should be equal to the area enclosed by the physical boundaries of the space, as defined by the intersection of the horizontal plane at the highest floor height and the volumetric model's vertical interior surface planes. Building area should be the sum of space areas whose PeopleNumber element values are greater than zero.
Polygon azimuth. The direction of the outward normal for the polygon (surface or opening) defined in RectangularGeometry element. Azimuth is measured in degrees clockwise from North, where North = 0 degrees. Examples: East = 90 deg, South = 180 deg, West = 270 deg. If CADModelAzimuth is defined, the Azimuth value is relative to the CADModelAzimuth value rather then North.
Type of ballast used
Baseboard heating capacity
Month and day year schedule begins
Date of holiday modeled
Biomass of vegetation
Leakage value obtained from blower door test.
Use this element to define the shell of the building.
This element establishes the logical relation of a given part of the building envelope such that its PlanarGeometry is part of an exterior surface of the building.
Global Unique ID from Industry Foundation Class (IFC) file.
Captures Building Storey Structure
Global Unique ID from Industry Foundation Class (IFC) file.
ID used by a CAD/BIM program to reference its internal materials library
The number of degrees (0 to 360) of the angle of positive Y axis from north. (Value of the of Azimuth of Model's North relative to Cardinal North)
The CADModelId Element is used to map a CAD model or BIM to its corresponding gbXML file. Allows the CAD/BIM tool referenced by the programIdRef to correlate the gbXML file to its CAD/BIM model.
ID reference to unique CAD/BIM program defined in DocumentHistory/ProgramInfo element.
The CADObjectId Element is used to map unique CAD object identifiers to gbXML elements. Allows CAD/BIM tools to read results from a gbXML file and map them to their CAD objects.
ID reference to unique CAD/BIM program defined in DocumentHistory/ProgramInfo element.
The Campus element should be used as the base for all physical objects. On a campus, place one or more buildings.
ID for the weather data used for a heating design day
ID for the weather data used for a cooling design day
Global Unique ID from Industry Foundation Class (IFC) file.
This is the x, y, and z distances from the origin. This element must have three Coordinate elements when representing 3-d space, which represent x, y and z in order. This element must have two Coordinate elements when representing 2-d space.
IfcCartesianPoint
Cooling degree days. CDD is calculated as the number of degrees a mean daily temperature is above a value (specified as the Temperature element), for each day. For example, if the mean temperature in a region rises to 77 degrees for three days during a year, the rest of the time staying below 75, and the Temperature element is set at 75, then CDD = 6.
Cooling degree day value
This is an element from ifcXML that describes a collection of faces that make up a closed shell.
IfcClosedShell
Parameters required by CLTD load calculation method, as described in the 1989 ASHRAE Handbook, Fundamentals volume, pages 26.32 and following. Ignore this element and all elements under it if you are not planning to use that method.
Specifies the number 1 to 13 to use for a roof. See Table 29 page 26.34, 1989 ASHRAE Handbook, Fundamentals volume.
Specifies the wall group code A to G to use for a wall. See Table 31, page 26.36, 1989 ASHRAE Handbook, Fundamentals volume.
Specifies the effective roof color, which depends on the actual color and whether the location is industrial or rural. See page 26.34, 1989 ASHRAE Handbook, Fundamentals volume.
Specifies whether or not a roof has a suspended ceiling under it. See table 29, page 26.34, 1989 ASHRAE Handbook, Fundamentals volume.
Specifies the effective wall color, which depends on the actual color and whether the location is industrial or rural. See page 26.36, 1989 ASHRAE Handbook, Fundamentals volume.
The coefficient of utilization is the ratio of luminous flux on a work plane to the luminous flux emitted by the lamps alone.
Room cavity ratio is a measure of the room cavity proportions.
Conductivity as a function of temperature
A Construction is a combination of layers, such as a wall or a roof
Reference to layers that comprise this construction. Multiple LayerId's order is important and specifies the layering of the layer's referenced materials. The first Surface/AdjacentSpaceId entered will determine how the referenced construction layers are ordered with the first construction layer being in contact with the outside or 2nd Surface/AdjacentSpaceId listed and the last layer in contact with the first Surface/AdjacentSpaceId listed.
This element is for purposes of modeling BIPV (building integrated photovoltaics).
Use this attribute to reference objects in the DOE2 library
Please specify the program that added this element.
The Control element should be used for describing how this equipment is controlled.
ConvergenceLimits is an optional element that can be used to specify timesteps on individual simulation loops. It is generally reserved for EnergyPlus simulations, and is recommended for advanced users wishing to speed up calculations. This may be a valid location to store this information if the gbXML file is used as a simulation archive.
This is the an x, y, or z length measurement from the origin.
IfcLengthMeasure
Denotes the time this file has been created, as well as the person and program used to create this file.
Number of operation cycles per week.
Maximum cycling rate (cycles/hr)
ID for operation schedules
Allows for including daylight savings time
Set of values that define the profile of one 24 hour period divided equally to the number of values entered.
Day of the month that the cooling design day occurs on
Day of the month that the heating design day occurs on
Flag for daylight savings on the cooling design day
Flag for daylight savings for the heating design day
Cooling design day dry bulb temperature
Heating design day dry bulb temperature
Cooling design day dry bulb temperature range
Heating design day dry bulb temperature range
Ground temperature on the cooling design day
Ground temperature for the heating design day
Cooling design day hour of high temperature
Heating design day hour of high temperature
Cooling design day hour of low temperature
Heating design day hour of low temperature
Month the cooling design day lands on. 1=Jan 12=Dec
Month that the heating design day occurs on. 1=Jan 12=Dec
Cooling design day atmospheric pressure
Heating design day atmospheric pressure
Flag for rain on the cooling design day. 0=no rain 1=rain
Heating design day rain flag. 0=no rain, 1=rain
Cooling design day sky clearness
Heating design day sky clearness
Flag for snow on the cooling design day. 0=not snowing 1=snowing
Heating design day snow flag. 0=not snowing 1=snowing
Cooling design day wet bulb temperature
Heating design day wet bulb temperature
Cooing design day wind direction
Heating design day wind direction
Cooling design day wind speed
Heating design day wind speed
Difference in pressure
Use this attribute for conditioning units with both heating and cooling.
Use this attribute to point to a performance curve if one is provided
Difference in temperature
Use this attribute for conditioning units with both heating and cooling.
Density as a function of temperature
Value of a dependent variable for this data point
Use minValue and maxValue to define constraints on the curve.
Design temperature for cooling
Please specify the program that added this element.
Design temperature for heating
Please specify the program that added this element.
Contains details about people and programs that created and modified this file
Use the standardsType attribute when the efficiency is measured at standard conditions.
Use this attribute for conditioning units with both heating and cooling.
Use this attribute to point to a performance curve if one is provided
Electric load
Height above sea level
Infra-red emissivity
Month and day year schedule ends
ID for a resource meter
Minimum enthalpy setpoint for air-side economizer.
The Equation element allows data for n-dimensional algebraic data to be entered. The Expression element should contain an dependent variable followed by an = sign and an equation containing independent variables. The independent and dependent variables are then defined by their respective tags. The only mathematical operations allowed are ^ (power), + (addition), - (subtraction), / (division), and * (multiplication). Example: z=x+2*y^2 would have an DependentVariable with a name = z, and two IndependentVariable(s) with names of x and y. Descriptions would be included for each variable, along with unit and dataType information identifying the variable and its role.
Amount of power used by equipment in a given area
Please specify the program that added this element.
External equipment. This is generalized to be able to contain any type of external equipment.
ID for the schedule of transmittance of a shading surface
ID pointing to a hydronic loop
ID pointing to an air loop
Please specify the program that added this element.
Properties of a material under fire conditions.
Properties of a construction under fire conditions.
Specifies the heat loss from a floor in terms of the amount of heat lost per length of exposed perimeter. Used with both commercial and residential load calculation methods.
Please specify the program that added this element.
Use this element to describe how the fluid flow is controlled. The temperatures specified in this element should be measured just upstream of the chiller.
Please specify the program that added this element.
Please specify the program that added this element.
Fraction of on-cycle power use
Use this attribute to reference objects in the DOE2 library
Space between window panes
Use this attribute to reference objects in the DOE2 library
ID for a gap between window panes
Gas preheat coil efficiency
Gas Preheat Coil Parasitic Electric Load
This element has been left open for use with other geometry definitions, such as X3D or BLISXML.
Minimum amount of glare to trigger the shades to close
Properties of one layer of a window
Use this attribute to reference objects in the DOE2 library
ID indicating the type of glaze used
Monthly ground temperatures, 12 values
Heating degree days. HDD is calculated as the number of degrees a mean daily temperature is below a value (specified as the Temperature element), for each day. For example, if the mean temperature in a region drops to 64 degrees for four days during a year, the rest of the time staying above 65, and the Temperature element is set at 65, then HDD = 4.
Heat pump fan delay time (s)
Heat pump time constant (s)
Amount of horizontal solar radiation striking the opening before a shade is closed.
h (Outside) is the combined coefficient of heat transfer by long-wave radiation and convection at outer surface, Btu/h-sf-F. See 2001 HoF Chapter 25 Table 1.
Used by the hOutsideUnitType attribute.
The HydronicLoop element represents the equipment serving one path of water, or other liquid
Only use this attribute for secondary loops to reference the primary loop.
Please specify the program that added this element.
A piece of equipment serving a hydronic loop (most commonly a water loop). This is generalized to be able to contain any type of hydronic loop equipment.
Use this element to point to another loop. For instance if this is a chiller and is a child of a chilled water loop, use this element to point at a cooling water loop.
Please specify the program that added this element.
ID pointing at a hydronic loop equipment object
ID pointing to a hydronic loop
Type of hydronic loop
This is an X3D element to map a texture to this material. From X3D specification: The ImageTexture node defines a texture map by specifying an image file and general parameters for mapping to geometry. Texture maps are defined in a 2D coordinate system (s, t) that ranges from [0.0, 1.0] in both directions. The bottom edge of the image corresponds to the S-axis of the texture map, and left edge of the image corresponds to the T-axis of the texture map. The lower-left pixel of the image corresponds to s=0, t=0, and the top-right pixel of the image corresponds to s=1, t=1.
Specifies location of the image. From X3D specification: The texture is read from the URL specified by the url field. When the url field contains no values, texturing is disabled. Browsers shall support the JPEG and PNG image file formats. In addition, browsers may support other image formats (e.g. CGM) which can be rendered into a 2D image. Support for the GIF format is also recommended (including transparency).
From X3D specification: If repeatS is TRUE, the texture map is repeated outside the [0.0, 1.0] texture coordinate range in the S direction so that it fills the shape. If repeatS is FALSE, the texture coordinates are clamped in the S direction to lie within the [0.0, 1.0] range.
From X3D specification: If repeatT is TRUE, the texture map is repeated outside the [0.0, 1.0] texture coordinate range in the T direction so that it fills the shape. If repeatT is FALSE, the texture coordinates are clamped in the T direction to lie within the [0.0, 1.0] range.
Value of the independent variable for this data point
ID for the schedule of transmittance of a shading surface
Flow of air through building envelope
Please specify the program that added this element.
Thermal resistance of the internal air film in a layer
Interior equipment. This is generalized to be able to contain any type of internal equipment.
ID for the schedule of transmittance of a shading surface
ID pointing to a hydronic loop
ID pointing to an air loop
Please specify the program that added this element.
ID pointing at an interior equipment object
Type of lamp used
Degrees north of the equator, in decimal degrees. Locations south of the equator are negative.
A Layer is a description of a material in a composite construction. Its id attribute is referenced in the Contstruction element's LayerId
Use this attribute to reference objects in the DOE2 library
ID identifying a layer in this construction. Multiple layers in Constructions are in order from outside to inside.
Building storey Local Placement Z coordinate.
ID for the schedule of transmittance of a shading surface
Identifier pointing at a light object
ID for a resource meter
Please specify the program that added this element.
Illuminance level that the lights are maintained if daylighting controls present (lightControlTypeEnum not equal to on off).
Location where Illuminance value is specified.
Please specify the program that added this element.
Please specify the program that added this element.
Amount of power used by lighting in a given area
Please specify the program that added this element.
The Location element describes the location of the global origin for this campus. This element can be used in a general sense by using the Name and Description elements for a physical address or landmark, or Location can be made precise by specifying the Elevation, Longitude, and Latitude of the origin.
Degrees east of Greenwich, in decimal degrees. Locations west of Greenwich are negative.
Type of luminaire used
Parameters required by the ACCA Manual J Eighth Edition load calculation method. Ignore this element and all elements under it if you are not planning to use that method.
Specifies the group code for the wall, which determines how quickly the wall delivers heat into the space. See Table 4C, page T4C-1 ACCA Manual J Eighth Edition.
Specifies the array of CLTD values to use for the roof, which determines how quickly the roof delivers heat into the space. See Table 4A page T4A-18 and following, ACCA Manual J Eighth Edition.
Specifies whether or not to use a higher heating temperature difference value in calculating the heating loss for a floor (25 degrees F higher value is used in formula if floor is radiant). See Figure A5-5, page A5-8, ACCA Manual J Eighth Edition.
Specifies the u-value of the crawl space wall that is associated with the floor, which affects both the heating and cooling load. See Figure A5-5, page A5-8, and Figure A5-17, page A5-16, ACCA Manual J Eighth Edition.
Specifies whether or not the crawl space wall associated with this floor is well sealed from the outdoor air, which affects both the heating and cooling loads. See Figure A5-5, page A5-8, and Figure A5-17 page A5-16, ACCA Manual J Eighth Edition.
Specifies the type of floor being considered, which affects both the heating and the cooling loads. See Table 4A, pages T4A-27 and following, ACCA Manual J Eighth Edition.
Use this attribute to reference objects in the DOE2 library
ID identifying a material in a Layer element.
Percentage (1-100%) of this layer that this material is made from.
Maximum outdoor air flow per zone
Description of a resource measurement
Please specify the program that added this element.
ID for a resource meter
Minimum flow
Fraction of light illuminance used at minimum setting.
Minimum outdoor air flow per zone
Fraction of power used at minimum setting.
Denotes the time this file has been modified, as well as the person and program used to modify this file.
Indicates if the motor is located in the path of the air stream.
Natural ventilation does not occur above this temperature.
Natural ventilation does not occur below this temperature.
Occupancy dependence of natural ventilation. If true, then natural ventilation only occurs when people are present.
Outside air flow per area
Please specify the program that added this element.
Outside air flow per person
Please specify the program that added this element.
Outside air flow per zone
Please specify the program that added this element.
Indicates which object or objects the results apply to, if any
coordinatesAbsolute is a boolean value for an Opening element, which if true, specifies that the coordinates in RectangularGeometry and PlanarGeometry are relative to the origin of the project's global reference frame. If this attribute is set to false, this means the coordinates in in RectangularGeometry and PlanarGeometry are relative to a local origin, defined as the lower left hand corner of its parent wall (when viewing the wall looking towards it outward-facing normal (i.e. - "outside looking in")).
Identifier pointing to a construction
Global Unique ID from Industry Foundation Class (IFC) file.
Schedule of operation for a piece of equipment. For heating and cooling equipment (such as a boiler or chiller) this is the availability schedule, the schedule of temperatures that, when reached, the piece of equipment will be available.
Parallel fan flow fraction
Use this element to report overall domestic hot water use for the domestic hot water loop referenced with the hydronicLoopIdRef attribute. The schedule referenced by waterUseScheduleIdRef defines a hot water use fraction schedule, which when combined with the value of PeakDomesticHotWaterFlow fully describe the hot water use of this building.
Please specify the program that added this element.
Occupancy of the space
Please specify the program that added this element.
Amount of heat added to the space by people
Please specify the program that added this element.
Percent of space area whose lights are controlled by a daylight sensor. Only applicable when LightPowerPerArea is used at the space level and not Lighting Systems.
Percent of original building shell used in renovation
Used to represent part-load performance and other performance metrics
The rate water vapor is allowed through a surface
Contains information about people that created and modified this file
This element has been left open for use with other photometry definitions. Photometric data is required for various forms of lighting analysis. This tag provides a way for the photometric data to be passed. Since this can be done in a variety of ways (iesna LM-63, cibse TM14, ELUMDAT, etc.) a specific format is not being specified.
This element specifies the position and the x, y and z axis of the light source. This element must have four Coordinate elements which represent the position and the x, y and z axis in order. The first CartesianPoint element specifies the position of the light source. The second, third and fourth CartesianPoint elements specifies the displacement points for the positive x, positive y and positive z axis.
List of points defining a loop. There are no repeated points in the list. All data are global, with the assumption that positive Z is up, and if CADModelAzimuth is undefined or zero, positive X is East and positive Y is North. If CADModelAzimuth is defined it is the angle of positive Y to North, positive X is the vectorial product of Y and Z. If geometry is to be precise, use Longitude, Latitude and Elevation in the Location element to define the origin. Otherwise the origin is an arbitrary point. Use PlanarGeometry to define a three dimensional polygon that lies on a plane, and has no self-intersection.
The PointData element allows for graph or tabular information to be entered. The data type and units of the independent and dependent variables are defined in their respective elements. Each Data element represent a data point, with each Value element representing the value of a variable - starting with the independent variable, then each dependent variable listed in the order defined.
This is a list of coordinates that make up a polygon in three-dimensional space. All coordinates must lie on the same plane. The right-hand rule applies for defining the outward normal of a surface: For every surface, points must be defined in order, such that the direction of (the average cross-product between (any point, the centroid of the surface, and the next point)) points in the direction of the outward normal, which is a vector pointing away from the first AdjacentSpaceID listed.
IfcPolyLoop
the ratio of the total amount of void space in a material (due to poses, small channels, and so on) to the bulk volume occupied by the material.
Maximum consumption of energy (power input)
ID for a resource meter
Prandtl number as a function of temperature
Use this element to describe how the air pressure is controlled. The temperatures specified in this element should be measured just upstream of the air handlers.
Contains information about the originating or modifying file or service that created or modified this file
Contains information about programs that created and modified this file
Geometry data in a form typically used in simulation engines. For surfaces, specify the location of the bottom-left corner with the CartesianPoint element when facing it from the outside. Also for surfaces, Tilt and Azimuth must be specified. If CADModelAzimuth is defined, the Azimuth value is relative to the CADModelAzimuth value rather then North. For openings, the third Coordinate should be zero or left missing. For openings, these Coordinates represent the distance of the bottom-left of the opening to the bottom-left corner of the parent surface. Azimuth and Tilt should not be specified for opening. There is an optional PolyLoop element, which may be used for describing the polygon shape of the surface.
This is a two-dimensional polygon, with the origin at the point specified with RectangularGeometry/CartesianPoint.
Please specify the program that generated the results using the id of the ProgramInfo element.
Please specify how the values were obtained.
Use the startTime attribute to define the start of the first Value element.
This specifies the duration of time between each Value element. This is required if more than one Value element exists in a this Results element.
Roughness of the outside surface
Parameters required by RTS load calculation method, as described in pages 29.25 and following of the 2001 ASHRAE Handbook, Fundamentals volume. Ignore this element and all elements under it if you are not planning to use that method.
Specifies which Conduction Time Series to use for the roof. See Table 21, page 29.30, 2001 ASHRAE Handbook, Fundamentals volume. Only used if the construction is a roof and you are using the RTS calculation method.
Specifies which Conduction Time Series to use for the wall. See Table 20, page 29.28, 2001 ASHRAE Handbook, Fundamentals volume. Only used if the construction is a wall and you are using the RTS calculation method.
Resistance of material
The ShadeControl element is a bit complex, as shading control is handled differently in different simulation engines. Each child of ShadeControl represents a criteria to help determine if the shades will be open or closed. The resulting shade action should be a union of these. Example: You have included a ShadeSchedule, which is a 1 on weekdays and a 0 on weekends, and a SolarOnOpening. The shade will be drawn when the solar radiation on this opening is greater than SolarOnOpening and it is a weekday.
Please specify the program that added this element.
Use this element to define schedules for a shade.
List of year schedules that make up an entire calendar year.
Please specify the program that added this element.
Value for one block of time. Divides a day evenly into number of ScheduleValue elements defined in DaySchedule. Example: If 12 ScheduleValue elements are defined, each will represent two hours
Value of the outside drybulb temperature for when defining HVAC system lower supply reset temperature
Value of the outside drybulb temperature for when defining HVAC system upper supply reset temperature
Value of the upper supply air setpoint temperature for reset of cooling air or heating air temperature
Value of the lower supply air setpoint temperature for reset of cooling air or heating air temperature
Secondary supply air maximum flow rate
Distance from outside surface of window to outside surface of wall
Shading Coefficient: The ratio of total solar transmittance for the specified glazing system to the total solar transmittance for the standard reference glazing (1/8" clear).
All data are global, with the assumption that positive Z is up, and if CADModelAzimuth is undefined or zero, positive X is East and positive Y is North. If CADModelAzimuth is defined it is the angle of positive Y to North, positive X is the vectorial product of Y and Z. If geometry is to be precise, use Longitude Latitude, and Elevation in the Location element to define the origin. Otherwise the origin is an arbitrary point. ShellGeometry is used to define a union of closed shells, where there is no intersection of any two of the given shells.
Simulation parameters refer to simulation engine settings that are used during simulation run-time. These parameters are instructions for a simulation engine to take into account features such as simulation timestep (entered as a number of minutes which should be evenly divisible into 60, see timestep attribute), convergence limits (see ConvergenceLimits), and the version of the simulation engine (version attribute). This element intends to maintain a record of the settings used to run a simulation, which may be important if gbxml stores simulation results, as a user may wish to know what settings and version of the simulation engine were used for analysis.
When element is a child of WindowType: The center of glass solar heat gain coefficient. When element is a child of Opening: The overall solar heat gain coefficient for the window assembly.
Amount of solar radiation striking the opening before a shade is closed.
A space represents a volume enclosed by surfaces.
Planar polygon that represents the perimeter of space and whose area is equal to the floor area of the space.
Planar polygons that represent the interior surfaces bounding the space and whose volume is equal to the volume of the space.
spaceType represents how a space is used.
IfcPolyLoop, an IESNA and ASHRAE project for determining lighting power density for individual spaces.
ID for the schedule of transmittance of a shading surface
ID of the schedule for lights contained in this space
ID for schedule of equipment use
ID for schedule of people in this space
ID for BuildingStorey this space is on.
Global Unique ID from Industry Foundation Class (IFC) file.
This element establishes the logical relation of a given part of the space ShellGeometry such that its PlanarGeometry is part of an interior surface bounding the space.
Global Unique ID from Industry Foundation Class (IFC)
file.
If this attribute is set to true, the boundary is important in heat flow calculation.
Connects the space boundary to a surface representing a building element (or representing the open air).
If surface referenced by SpaceBoundary is adjacent to two spaces, then this references the corresponding SpaceBoundary of the opposite space.
Supplemental heating coil efficiency
Supplemental heating coil parasitic electric load
Supplemental heating coil capacity.
First AdjacentSpaceId entered will determine how the referenced construction layers are ordered with the first construction layer being in contact with the outside or 2nd space listed and the last layer in contact with the first space listed.
Identifier pointing to a construction
ID for the schedule of transmittance of a shading surface
This attribute specifies whether or not direct beam radiation from the sun will ever hit this surface. Only relevant to exterior surface types.
Global Unique ID from Industry Foundation Class (IFC) file.
Temperature
Please specify the program that added this element.
Use this element to describe how the temperature is controlled. The temperatures specified in this element should be measured just upstream of the most critical piece of equipment (air handlers for a chilled water and hot water loops the chiller for the cooling water loop).
The number of degrees from up that the outside of the surface is tilted in relation to the bottom-left corner.
Time or period that results represent. Example: if timeType = Month and TimeIncrement = 1 the Value would be for the month of January or if timeType = Hour and TimeIncrement = 4 the 81st the Value would be for January 14 at noon.
Transmittance of shading surface
Public transportation
ID for the schedule of transmittance of a shading surface
Please specify the program that added this element.
User/project defined Code for Space or Zone.
We have left the UtilityRate element open to allow for use with billing schemas.
Overall conductance
Contains the actual numerical result value. If series result type each Value element contains the one value and is in sequential order for the series.
Plants, trees, etc. on a campus
Refers to a building-level surface.
Please specify the program that added this element.
Viscosity as a function of temperature
Specifies the volume of the space. This value should be equal to the volume enclosed by the actual physical boundaries of the space, as defined by the volumetric model's interior surfaces bounding that space.
Waste water heat recovery efficiency
ID pointing to an air loop
ID pointing to a hydronic loop
This includes blowdown (draining a cooling tower to clean), drift (water loss from water sprayed), and evaporation in cooling towers.
Amount of water used for water using equipment per cycle of operation.
The amount of heat from this equipment rejected to this space. For condensors exterior to building, this value will be 0.
Please specify the program that added this element.
Set of day schedules all assigned to a unique particular period of the week using the day type attribute. Do not schedule conflicting day types to the same week schedule.
Wildfire threat design atomospheric pressure.
Wildfire threat design relative humidity.
Wildfire threat design dry bulb temperature.
Wildfire threat design wind direction
Wildfire threat design wind speed.
Wind speed for wind turbine.
One WindowType should be created for each type of window. Create a Blind, Frame, and Cost for each OpeningType, and then add as many Glaze and Gaps as exist in the window. Place these Glaze and Gap elements in order from outside to inside. For instance, a two pane window will have Glaze Gap Glaze, where the first Glaze represents the outside surface.
This element is for purposes of modeling BIPV (building integrated photovoltaics).
Use this attribute to reference objects in the DOE2 library
Please specify the program that added this element.
Year of simulation to use
Set of week schedules all assigned for a particular time period during the year defined by the begin and end date elements. These must not span more than one calendar year.
ID of heating schedule
Design temperature for cooling
Outside air schedule ID
Air changes schedule ID
ID of the fan schedule for this zone
ID of the fan temperature schedule for this zone
Global Unique ID from Industry Foundation Class (IFC) file.
Please specify the program that added this element.
Minimum cooling load that triggers the shades to close