Space Element

Supported attributes

For MEP systems
Attribute Description
id This attribute is a hyphen-separated string, consisting of a prefix sp, Room Number, and Room Name. For example, sp-1-Lounge. The id attribute must be unique within the file. A number can be added to the end to avoid duplicate values. The attribute is formatted as a XML string (XSD:IDREF). Unwanted characters are filtered out or replaced with an underbar (_). The following special characters are filtered out: Period (.); Apostrophe ('); Backslash (\); Semicolon (;); DollarSign ($);
spaceType This is the value specified for Space Type, under Energy Analysis in the Room Instance Properties dialog.
ZoneIdRef This specifies a unique “id” for a zone that references this space.
lightScheduleIdRef This specifies a unique “id” for the lighting schedule that is referenced in the Building/Space Type Settings for the space type associated with this space.
equipmentScheduleIdRef This specifies a unique “id” for the power schedule that is referenced in the Building/Space Type Settings for the space type associated with this space.
peopleScheduleIdRef This specifies a unique “id” for the occupancy schedule that is referenced in the Building/Space Type Settings for the space type associated with this space.
conditionType This is the value specified for Condition Type, under Energy Analysis in the Room Instance Properties dialog.
buildingStoreyIdRef This specifies a unique “id” for a building storey that references this space (e.g. the Level for the Space).
For architecture
Attribute Description
id This attribute is a hyphen-separated string, consisting of a prefix sp, Room Number, and Room Name. For example, sp-1-Lounge. The id attribute must be unique within the file. A number can be added to the end to avoid duplicate values. The attribute is formatted as a XML string (XSD:IDREF). Unwanted characters are filtered out or replaced with an underbar (_). The following special characters are filtered out: Period (.); Apostrophe ('); Backslash (\); Semicolon (;); DollarSign ($);
buildingStoreyIdRef This specifies a unique “id” for a building storey that references this space (e.g. the Level for the Space).

Basic supported children

For MEP systems
Element Description
Name This is the value specified for Number in the Room Instance Properties dialog.
Lighting Represents lighting fixtures belonging to this space. See Lighting Element.
Area This value is collected from the Space: Area parameter. This is the area computed at the Wall Finish.
Volume This value is collected from the Space: Volume Parameter. This is the enclosed volume measured by interior bounding surfaces.
PlanarGeometry The 2D boundary for the space measured by interior. This is a planar polygon that represents the perimeter of the space, and whose area is equal to the floor area of the space.
ShellGeometry Polygons enclosing the volume measured by interior bounding surfaces. See ShellGeometry Element.
CADObjectId ElementId for the associated Room element.
SpaceBoundary Geometry data defining an analytical space volume where each polygon/face has a reference to a Surface. Through the Surface you can connect a source element with each polygon in a space. There will be a number of SpaceBoundary elements per Space. See SpaceBoundary Element.
For architecture
Element Description
Name This is the value specified for Number in the Room Instance Properties dialog.
Area This value is collected from the Space: Area parameter. This is the area computed at the Wall Finish.
Volume This value is collected from the Space: Volume Parameter. This is the enclosed volume measured by interior bounding surfaces.
PlanarGeometry The 2D boundary for the space measured by interior. This is a planar polygon that represents the perimeter of the space, and whose area is equal to the floor area of the space.
ShellGeometry Polygons enclosing the volume measured by interior bounding surfaces. See ShellGeometry Element.
CADObjectId ElementId for the associated Room element.
SpaceBoundary Geometry data defining an analytical space volume where each polygon/face has a reference to a Surface. Through the Surface you can connect a source element with each polygon in a space. There will be a number of SpaceBoundary elements per Space. See SpaceBoundary Element.

Additional supported children

For MEP systems
Element Description  
PeopleNumber This is the value specified for Number of people in the People Loads dialog. This value will have a unit attribute of NumberOfPeople. If Values in the People Loads dialog is set to Specified, this value is always exported.
PeopleHeatGain Revit exports three PeopleHeatGain elements, each with a different type specified by the heatGainType attribute:

PeopleHeatGain heatGainType="Total"This value is the sum of Sensible and Latent Heat Gain per person.

PeopleHeatGain heatGainType="Sensible"This is the value specified for Sensible Heat Gain per person in the People Loads dialog.

PeopleHeatGain heatGainType="Latent"This is the value specified for Latent Heat Gain per person in the People Loads dialog. The unit attribute for this element specifies how heat gain values are expressed: BtuPerHourPerson or Watts.

If Values in the People Loads dialog is set to Specified, these values are always exported.

If Values in the People Loads dialog is set to <Default>, and the Export Defaults under Energy Settings in Project Information is checked, these values are exported.

Sample:

<PeopleHeatGain unit="BtuPerHourPerson" heatGainType="Total">470.000000</PeopleHeatGain>

<PeopleHeatGain unit="BtuPerHourPerson" heatGainType="Sensible">220.000000</PeopleHeatGain>

<PeopleHeatGain unit="BtuPerHourPerson" heatGainType="Latent">250.000000</PeopleHeatGain>

LightPowerPerArea This is the value specified for Lighting Loads in the Electrical Loads dialog. This value will be specified in the unit WattPerSquareMeter or WattPerSquareFoot. The unit attribute for this element specifies how the value for Power per Area unit is expressed: WattPerSquareMeter or WattPerSquareFoot. If the Default Values is selected, this value is not exported.

If Values for Lighting in the Lighting Loads dialog is set to Specified, these values are always exported.

If Values for Lighting in the Lighting Loads dialog is set to <Default>, and the Export Default Values parameter of the Export gbXML Settings dialog is enabled, these values are exported.

Sample:

<LightPowerPerArea unit="WattPerSquareFoot">2.500000</LightPowerPerArea>

EquipPowerPerArea This is the value specified for Power Loads in the Electrical Loads dialog. This value can be expressed as: WattPerSquareMeter or WattPerSquareFoot. The unit attribute for this element specifies how the value for Power per Area unit is expressed: WattPerSquareMeter or WattPerSquareFoot. If the Default Values is selected, this value is not exported.

If Values for Power in the Electrical Loads dialog is set to Specified, these values are always exported.

If Values for Power in the Electrical Loads dialog is set to <Default>, and the Export Default Values parameter of the Export gbXML Settings dialog is enabled, these values are exported.

Sample:

<EquipPowerPerArea unit="WattPerSquareFoot">1.500000</EquipPowerPerArea>

Example: MEP Systems

<Space id="sp-1-Room" spaceType="OfficeEnclosed"> zoneIdRef="zone-A" lightScheduleIdRef="schdl-Retail_Lighting" equipmentScheduleIdRef="schdl-Retail_Lighting" peopleScheduleIdRef="schdl-Retail_Facility" conditionType="HeatedAndCooled" buildingStoreyIdRef="bldg-lvl-Level_1">

<Name>1 Space</Name>

<Lighting id="light-sp-18-North_Bedroom-1" lightingSystemIdRef="lightsys-6">

<PeopleNumber unit="NumberOfPeople">12.000000</PeopleNumber>

<PeopleHeatGain unit="BtuPerHourPerson" heatGainType="Total">470.000000</PeopleHeatGain>

<PeopleHeatGain unit="BtuPerHourPerson" heatGainType="Sensible">220.000000</PeopleHeatGain>

<PeopleHeatGain unit="BtuPerHourPerson" heatGainType="Latent">250.000000</PeopleHeatGain>

<LightPowerPerArea unit="WattPerSquareFoot">2.500000</LightPowerPerArea>

<EquipPowerPerArea unit="WattPerSquareFoot">1.500000</EquipPowerPerArea>

<Area>296.444444</Area>

<Volume>2371.555556</Volume>

+ <ShellGeometry id="sg-sp-1-Room" unit="Feet">

<CADObjectId>223542</CADObjectId>

+ <SpaceBoundary isSecondLevelBoundary="true" surfaceIdRef="su-1">

</Space>

Example: Architecture

<Space id="sp-1-Room" buildingStoreyIdRef="bldg-lvl-Level_1">

<Name>1 Space</Name>

<Area>296.444444</Area>

<Volume>2371.555556</Volume>

+ <ShellGeometry id="sg-sp-1-Room" unit="Feet">

<CADObjectId>223542</CADObjectId>

+ <SpaceBoundary isSecondLevelBoundary="true" surfaceIdRef="su-1">

</Space>