# Manual Project Setup

Concise, step-by-step, simple project setup walkthrough. For comprehensive project setup information see Project Setup chapter in Getting Started book.

# Preparing Project Space

This tutorial will show you a step-by-step, basic project creation workflow. To learn more about every step and different features, see the following books: [<span style="text-decoration: underline; color: rgb(53, 152, 219);">**Getting Started**</span>](https://docs.sim-on.com/books/2-getting-started) for project creation related information and <span style="color: rgb(53, 152, 219);">[<span style="text-decoration: underline;">**App overview**</span>](https://docs.sim-on.com/books/3-app-overview)</span> for comprehensive descriptions of SIMON features.

To use **SIM-ON** you will need two things:

- A Matterport scan
- Optionally: (*supported*) Smarthome provider

<p class="callout info">For this tutorial you will be **provided with a Matterport scan** of an office, but **we recommend you to use your own scan**, together with a **Smarthome provider** if possible</p>

Provided tutorial material:

- **<span style="color: rgb(53, 152, 219);">[Matterport Scan](https://my.matterport.com/show/?m=KnmwKwMaj4s)</span>**

<p class="callout info">At any time, in this tutorial, you can access the provided link from the **Attachments** section.  
(*located in the top left corner of the screen*)</p>

---

#### **New Space Creation**

After [<span style="text-decoration: underline; color: rgb(53, 152, 219);">**Logging into SIM-ON**</span>](https://identity.simlab.pl/Account/Login), you will first see the <span style="text-decoration: underline; color: rgb(53, 152, 219);">**browser view.**</span> Here you will find **news** and your **available spaces.**

![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/4Sdimage.png)

- Press ![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/mhPimage.png) button to begin the **space creation** process.

![obraz.png](https://docs.sim-on.com/uploads/images/gallery/2024-08/scaled-1680-/kgoobraz.png)

- Select **Matterport** set up method as we will be using the provided **Matterport link** in this tutorial.
- Press ![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/TeLimage.png) to proceed.

#### Room creator

![obraz.png](https://docs.sim-on.com/uploads/images/gallery/2024-08/scaled-1680-/3x1obraz.png)

Next, we will create starter rooms.

- Select **Custom rooms** option, as it allows to proceed **without linking** a smarthome provider.
- Press ![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/TeLimage.png) to proceed.

![obraz.png](https://docs.sim-on.com/uploads/images/gallery/2024-08/scaled-1680-/hgXobraz.png)

We need **at least one** **room** to proceed with project creation. Here we will only create a **placeholder room** to create the project. Proper room creation will be handled at a later stage, within the project. This way you will be creating rooms at the fly, while assigning them to the sweeps in the project.

<p class="callout info">If you are following this tutorial with **your own Matterport Scan**, and know the rooms beforehand - feel free to include them in this step. Otherwise keep following this tutorial</p>

- Create a single, placeholder room (We will change its name later.)
- Press ![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/TeLimage.png) to proceed.

#### Linking Matterport scan

![obraz.png](https://docs.sim-on.com/uploads/images/gallery/2024-08/scaled-1680-/GBcobraz.png)

Now we to provide a **Matterport link** to be used as a 3D space for the project.

- Paste the <span style="text-decoration: underline; color: rgb(53, 152, 219);">**Provided Matterport Link**</span> into the required field.
- Press ![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/TeLimage.png) to finalize the space creation.

You've successfully created a new SIM-ON space! Proceed to next page of the tutorial where you'll learn how to further set up the scene.

# Setting up Rooms

After entering the space for the first time, by default you will appear in the 3D Walk view. You may notice that the environment is desaturated. This is an indication that the current position (sweep) we are on is unassigned. It is understandable, since the project has just been created and needs to be set up.

![settingUpRoomsTut.jpg](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/settinguproomstut.jpg)






#### **Room creation**

First step before setting up sweeps is to prepare rooms to choose from later. You might have noticed that we skipped this step in the project scene creation. It's because we will use the **Matterport** **Dollhouse** feature to get the general view of the space that will help us decide what rooms to create.

- To enter the **dollhouse view** (or any other type of view): select it from the bottom left corner of the screen:   
    ![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/g9qimage.png)

With the **Dollhouse view** enabled a 3D scan model of the entire scanned place will appear:

![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/eNUimage.png)

This lets us navigate the environment unobstructed and explore the given space to decide the amount and names of the rooms.

- Explore the office and think about what rooms need to be created

Here is an example, using the ![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/ZJLimage.png) **floorplan view** of how the provided space <span style="text-decoration: underline;">could be</span> divided into rooms:

![tutorial_room allocation.jpg](https://docs.sim-on.com/uploads/images/gallery/2025-01/tutorial-room-allocation.jpg)

<p class="callout warning">The screenshot was colored in an image editing software for easier visualization of the concept  
</p>

With the general idea for the room layout, head to **Space settings** &gt; **Rooms** accessed from the burger ![hamburger_icon.png](https://docs.sim-on.com/uploads/images/gallery/2024-08/scaled-1680-/hamburger-icon.png)menu located in the top left corner of the screen. And create room(s) you will use to start assigning sweeps with.

- Go to the **Rooms** view in **Space settings**
- Create rooms for the space

![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/K2Cimage.png)

<p class="callout info">Use neutral/general naming scheme for the first time (*as seen in the screenshot above*) to setup all the spaces without worrying too much about "proper" room names, especially since the rooms can be edited later on.</p>






#### **Sweep assignment**

With (some *starting*) rooms created, now we need to assign them within the space to "**sweeps**".

<table border="1" id="bkmrk-to-place-the-devices-1" style="border-collapse: collapse; width: 103.095%; border-width: 0px; height: 144.406px;"><colgroup><col style="width: 85.119%;"></col><col style="width: 14.881%;"></col></colgroup><tbody><tr style="height: 144.406px;"><td style="border-width: 0px; text-align: justify; height: 144.406px;">> To place **devices** within the 3D space of **Virtual Tour**, first we need to **define** **the rooms** within the 3D space by assigning them to "**sweeps**".
> 
> <p class="callout info">‘**Sweep**’ as in a full Matterport camera rotation - **A spot** in the **Matterport Space** where a user can **stand** and **look around** (*This includes 3D scan locations and 360º Views*)</p>
> 
>   
> ~[**<span style="text-decoration: underline; color: rgb(53, 152, 219);">*Sweeps*</span>**](https://docs.sim-on.com/~Sweeps)

</td><td style="border-width: 0px; height: 144.406px;"> </td></tr></tbody></table>

To assign sweeps, we need to be in the **3D Walk** view. Access it through the burger![hamburger_icon.png](https://docs.sim-on.com/uploads/images/gallery/2024-08/scaled-1680-/hamburger-icon.png)menu located in the top left corner of the screen.

In the top section of the viewport, you can notice a text: "**Not assigned room**" and a **closed lock** ![padlock_closed.png](https://docs.sim-on.com/uploads/images/gallery/2024-08/scaled-1680-/padlock-closed.png) icon to the right of it. To assign a room to the sweep, click on the **lock** ![padlock_closed.png](https://docs.sim-on.com/uploads/images/gallery/2024-08/scaled-1680-/padlock-closed.png) **icon,** it will reveal a window with the available rooms.

- Enter **3D Walk** view
- Toggle the **lock** ![padlock-unlock.png](https://docs.sim-on.com/uploads/images/gallery/2024-08/scaled-1680-/padlock-unlock.png) **icon** to reveal the rooms window

![sweep assignment.jpg](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/sweep-assignment.jpg)

Select the proper room for the sweep you are standing on. The view will become saturated, indicating the sweep you are currently on is <span style="text-decoration: underline;">set</span> and the room name will appear, replacing the "**Not assigned room**" prompt. Go to next sweep and repeat.

You can assign all the sweeps in the project the same way. To finish you need to lock editing by toggling the **lock** ![padlock-unlock.png](https://docs.sim-on.com/uploads/images/gallery/2024-08/scaled-1680-/padlock-unlock.png) **icon** again.

- Assign a room to the sweep
- Navigate to a next sweep
- Repeat until all the sweeps have assigned rooms

<p class="callout info align-left">While assigning sweeps, If there is a room you are missing/haven't prepared before: don't worry, you can always go to the **Rooms** in **Space Settings** to add new room and return back to the **3D View.** The last place you left the view from will be remembered and you will start where you left.</p>

![bistro.jpg](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/bistro.jpg)After going through the swpies, check if the option ![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/LkPimage.png) is still available. If so, that means some of the sweeps are still unassigned.

- Use "Find not assigned" to be automatically transported to one of the unassigned sweeps and assign it.
- Repeat until the option is no longer available, indicating that all of the sweeps are now assigned.

With the rooms set up, the project space is now ready for all of the SIM-ON features to be used.

---

**This concludes the core setup of the SIM-ON project space setup tutorial. In the following, last page, you will learn how to create an asset and an event within the created space.**

# Asset creation

With the rooms assigned, assets can now be included within the space.

> Defined as an "**asset**" is any object or an item you wish to keep track of in your SIM-ON space. The main difference between an "**asset**" and a "**device**" is the lack of smart connectivity of the former one.

![image.png](https://docs.sim-on.com/uploads/images/gallery/2024-11/scaled-1680-/P7simage.png)To add an asset, navigate to **<span style="color: rgb(53, 152, 219);">[Quick Access Menu](https://docs.sim-on.com/link/148#bkmrk-assets "Top Menu")</span>** located on the right side of the viewport, select **Assets** ![image.png](https://docs.sim-on.com/uploads/images/gallery/2024-11/scaled-1680-/Kb5image.png) icon and hover over ![image.png](https://docs.sim-on.com/uploads/images/gallery/2024-11/scaled-1680-/RpLimage.png) icon, to reveal "**Add Asset**" button and then press it.

The following window will appear on the right side of your screen&gt;

To create an asset, you need to fill out the necessary fields, marked with " <span style="color: rgb(224, 62, 45);">**\*** <span style="color: rgb(0, 0, 0);">", then the </span></span>![image.png](https://docs.sim-on.com/uploads/images/gallery/2024-11/scaled-1680-/cJuimage.png) button will become available to finalize the asset creation.

As an example, we will create an asset for a **Printer** located in the **Printing room** in the **project space**.

- Fill the necessary fields as seen here:

![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/RvMimage.png)

With basic Asset info, now we will set position for the asset.

- Click the ![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/s5gimage.png) **Set position** button

![asset location.jpg](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/asset-location.jpg)

We will be putting the position marker on the left printer. Press the " **+** " button from the new window that appeared on the bottom of the view.

- Place the Pin on the printer

![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/QEeimage.png)

- Exit Position placement by pressing " **x** " button

<p class="callout info">You can edit/delete Asset location at any time from the **Asset Panel**</p>

With the basic **Info** and **location** set, asset can be created.

There are more options that can be used to store information within an asset such as: **Description,** **Photos**, **Videos** and **Documents.** You can use these to further complete asset information.   
  
Here is an Event section filled as an example:

![image.png](https://docs.sim-on.com/uploads/images/gallery/2025-01/scaled-1680-/DKFimage.png)  
  
After creating an asset, it will appear on the right side of the viewport, under the **<span style="color: rgb(53, 152, 219);">[Quick Access Menu](https://docs.sim-on.com/link/148#bkmrk-assets "Top Menu")</span>**, as well as in the <span style="color: rgb(53, 152, 219);">[**assets list**](https://docs.sim-on.com/books/3-app-overview/page/assets)</span> in the <span style="color: rgb(53, 152, 219);">[<span style="text-decoration: underline;">**Dashboard**</span>](https://docs.sim-on.com/books/3-app-overview/chapter/dashboard)</span>.

**![image.png](https://docs.sim-on.com/uploads/images/gallery/2024-11/scaled-1680-/Ul5image.png)**

---

To learn more about other Aspects of the Software, check the rest of our [<span style="text-decoration: underline; color: rgb(53, 152, 219);">**SIM-ON Documentation.**</span>](https://docs.sim-on.com/shelves/sim-on)