gbXML version 0.31 - created by GeoPraxis, Inc. Change Log: 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 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 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 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 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. ID for the schedule of transmittance of a shading surface Identifier pointing at a light object ID for a resource meter