Space Element

Supported attributes

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).

Attribute

Description

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

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.

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

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 Defaults under Energy Settings in Project Information is checked, 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 Defaults under Energy Settings in Project Information is checked, these values are exported. Sample: `<EquipPowerPerArea unit="WattPerSquareFoot">1.500000</EquipPowerPerArea>`

Example

<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>