gbXML version 0.32 - created by GeoPraxis, Inc.
Change Log:
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 DependantValue element
Added IndependantValue 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 DependantVariable element
Added minValue and maxValue attributes to the DependantVariable element
Changed structure of the Efficiency element
Allowed up to 2 IndependantVariable elements in the Equation element
Added fluidType attribute to the HydronicLoop element
Changed structure of HydronicLoopEquipment element
Made Name in IndependantVariable 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.
ifcXML namespace is http://www.iai-na.org/ifcXML/schema/v04a-20010301
Enumerations
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
Department of Energy
Air-Conditioning and Refrigeration Institute
American National Standards Institute
National Electical Manufacturers Association
Elements with simple content
The number of degrees from north the outside of the surfaces is rotated in relation to the bottom-left corner.
Type of ballast used
Month and day year scedule begins
The CADObjectId Element is used to map unique CAD object identifiers to gbXML elements. Allows CAD tools to read results from a gbXML file and map them to their CAD objects.
Cooling degree day value
Number of operation cycles per week.
Allows for including daylight savings time
Heating design day dry bulb temperature range
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 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
Flag for rain on the cooling design day. 0=no rain, 1=rain
Heating design day rain flag. 0=no rain, 1=rain
Flag for snow on the cooling design day. 0=not snowing, 1=snowing
Heating design day snow flag. 0=not snowing, 1=snowing
Value of a dependant variable for this data point
Month and day year schedule ends
Value of the independant variable for this data point
Type of lamp used
Degrees east of Greenwich, in decimal degrees. Locations west of Greenwich are negative.
Degrees north of the equator, in decimal degrees. Locations south of the equator are negative.
Type of luminaire used
Occupancy dependence of natural ventilation. If true, then natural ventalation only occurs when people are present.
Indicates which object or objects the results apply to, if any
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
The number of degrees from up that the outside of the surface is tilted in relation to the bottom-left corner.
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.
Year of simulation to use
Elements with complex content.
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.
Absorptance of the outside surface
ID for a space that is bounded by this surface.
The AirLoop element represents the equipment serving one path of air
A piece of equipment serving an air-loop.
This is generalized to be able to contain any type of air loop equipment.
ID pointing to an air loop
Minimum air temperature before shades are closed.
Reflectance of solar radiation
Alternative energy source
Specifies the area of the space or building. This value should be equal to the area enclosed by the physical boundries 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.
Leakage value obtained from blower door test.
Use this element to define the shell of the building.
ID used by a CAD program to reference its internal materials library
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
This is the x, y, and z distances from the origin. This element must have three Coordinate elements, which represent x, y, and z in order.
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.
This is an element from ifcXML that describes a collection of faces that make up a closed shell.
IfcClosedShell
The coefficient of utilization is the ratio of luminous flux on a workplane 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
Use this attribute to reference objects in the DOE2 library
The Control element should be used for describing how this equipment is controlled.
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.
ID for operation schedules
Set of values that define the profile of one 24 hour period divided equally to the number of values entered.
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 atmospheric pressure
Heating design day atmospheric pressure
Cooling design day sky clearness
Heating design day sky clearness
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
Use minValue and maxValue to define constraints on the curve.
Design temperature for cooling
Design temperature for heating
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 emmisivity
ID for a resource meter
The Equation element allows data for n-dimensional algebraic data to be entered.
The Expression element should contain an indepentant variable followed by an = sign and an equation containing dependant variables.
The independant and dependant variables are then defined by their respective tags.
The only mathmatical operations allowed are ^ (power), + (addition), - (subtraction), / (division), and * (multiplication).
Example: z=x+2*y^2 would have an IndependantVariable with a name = z, and two DependantVariables 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
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
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.
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
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.
Amount of horizontal solar radiation striking the opening before a shade is closed.
The HydronicLoop element represents the equipment serving one path of water, or other liquid
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.
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.
ID for the schedule of transmittance of a shading surface
Flow of air through building envelope
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
ID pointing at an interior equipment object
A Layer is a combination of one of more materials
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.