Create your Space

In this article:

  1. Create a spacemap file
  2. Determine speaker locations
  3. Add a Space using Control


Create a spacemap file

A spacemap is an XML document that primarily maps each physical speaker in a space to a Spatial Reality computer and specifies the location of each speaker in 3-dimensional space. Spatial Reality uses the Spacemap to determine information about your speakers and then renders the Scene based on that information and your specific layout. 


Here are some of the basic details you will need to get started with creating a Spacemap:


  • Device ID
    The unique device id (e.g. UUID) of the computer that contributes this speaker's output. On a Mac, the UUID of playback computer can be discovered via the Spatial Reality app computer settings page. You can also find the UUID via the menu bar —  → About This Mac → System Report → Hardware UUID.
  • Channel
    Corresponds to the audio interface (physical hardware, virtual soundcard or virtual aggregate device) channel number for a particular computer→speaker combination. 
  • Position 
    3D position coordinates of a speaker relative to the measurement reference of the Space. Refer to the details below to determine the location information for a speaker


Here's an example of a Spacemap for a Space that utilizes a computer group with two computers and a total of 9 channels. You can learn more about the format for the Spacemap file here

<speaker id="11111111-2222-2222-2222-111111111111" channel="0"
position="-2.0 -2.0 2.0"
type="medium" volumedb="0" name="1"/>
<speaker id="11111111-2222-2222-2222-111111111111" channel="1"
position="-2.0 0 2.0"
type="medium" volumedb="0" name="2"/>
<speaker id="11111111-2222-2222-2222-111111111111" channel="2"
position="-2.0 +2.0 2.0"
type="medium" volumedb="0" name="3"/>
<speaker id="11111111-2222-2222-2222-111111111111" channel="3"
position="0 +2.0 2.0"
type="medium" volumedb="0" name="4"/>
<speaker id="22222222-4444-4444-4444-222222222222" channel="0"
position="+2.0 +2.0 2.0"
type="medium" volumedb="0" name="5"/>
<speaker id="22222222-4444-4444-4444-222222222222" channel="1"
position="+2.0 0 2.0"
type="medium" volumedb="0" name="6"/>
<speaker id="22222222-4444-4444-4444-222222222222" channel="2"
position="+2.0 -2.0 2.0"
type="medium" volumedb="0" name="7"/>
<speaker id="22222222-4444-4444-4444-222222222222" channel="3"
position="0 -2.0 2.0"
type="medium" volumedb="0" name="8"/>
<speaker id="22222222-4444-4444-4444-222222222222" channel="4"
position="-2.0 -2.0 0"
type="subwoofer" volumedb="0" name="9"/>


Replace id, channel, position and add/subtract speakers based on your particular setup. Make sure to save this file with a .spacemap file extension.

Note regarding origin:

Prior to Spatial Reality engine 8.20.0

Explicitly specify the acoustic origin (<origin x="0" y="0" z="0"/>) in your Spacemap. Origin is generally in the center of a Space and all speaker locations are measured from the origin. 

Spatial Reality engine 8.20.0+

Reality engine will compute the acoustic origin based on the speaker positions. If you need to override the acoustic origin — specify origin (<origin position="0 0 0"/>) in your Spacemap. 


Determine speaker locations

Determine the locations of all speakers that are in this Space by measuring their position in 3D space as referenced to a measurement reference. You will need a tape or laser measure.


  • Picking a measurement reference
    In general, we recommend picking a spot that is centrally located in the Space and mark it on the floor (z=0). This measurement reference will be used as the reference point to measure speaker locations.

  • Measuring speaker locations
    Using a tape or laser measure, measure every speaker (in meters) relative to your measurement reference.  

    x-coordinate, y-coordinate are classic xy 2d coordinates. 
    z-coordinate is measured referenced to the floor (floor being z=0)


Add a Space using Control

Once you have created your Spacemap file — you can import it using Spatial Control to create a new Space. You'll want to make sure that this file is available on your phone through the Files app (either via iCloud, 3rd party cloud storage services or AirDrop).

  1. Download Spatial Control from the App store if you haven't already, and sign-in.
  2. Menu → Manage → (Select a Site) → Add new Space
  3. Type a unique Space name and then tap Choose Spacemap.
  4. From the Files app — select the .spacemap file that you created before.
  5. Tap Done to create the Space. You'll be prompted to restart Spatial Reality to ensure that this newly created Space is activated and available for Studio and Control. 



Note: The file must have a .spacemap file extension, and adhere to the Spatial spacemap schema


Was this article helpful?
0 out of 0 found this helpful