gbXML version 5.12 - maintained by gbXML.org. |
Change Log: 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 the American Society of Heating, Refrigerating and Air-Conditioning Engineers, Inc. All rights reserved. |
Enumerations |