# Working with Projects

In VoxelSpace, Projects are the central containers used to organize spatial data, collaborative workflows, and visualization tools. Each project can include datasets, views, reports, and processing scripts, making it the foundation for team-based work and long-term data management.

After the project is created, you need to upload the Raw Data of project using Add Object.

Once the Raw Data is associated to the project you need to process that data to generate an output (view or Unity Project).

# Introduction

## Working with Projects

<span class="rvts6">  
</span>

The VoxelSpace platform uses a **data-centric approach** to help organizations scale the spatial understanding of their operations.

At the core of this approach is a **shared repository of spatial data objects**, known within the platform as **Entities**. These Entities represent a wide range of geospatial and design data types, including:

<div class="main-content" id="bkmrk-point-clouds-terrain">- <span class="rvts6">Point Clouds</span>
- <span class="rvts6">Terrain Models</span>
- <span class="rvts6">Block Models</span>
- <span class="rvts6">Planning / Design Solids</span>
- <span class="rvts6">BIM <span style="font-size: 12.0pt; font-family: 'Times New Roman',serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: EN-CA; mso-fareast-language: EN-CA; mso-bidi-language: AR-SA;">(Building Information Models)</span></span>

</div>Entities can be shared across different teams within the organization—subject to security and access controls.

Most organizations generate **thousands of Entities annually**. These may include datasets captured from the field, models created by internal teams, or results generated through automated spatial processing. The full collection of these assets forms the organization’s **Catalog**.

## <span style="mso-fareast-font-family: 'Times New Roman';">Project Structure and Organization</span>

To manage large volumes of Entities, the platform organizes the Catalog into a hierarchy of **Projects** and **Folders**.

<span style="font-size: 10.0pt; mso-bidi-font-size: 12.0pt; font-family: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol;"><span style="mso-list: Ignore;">·<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>**Projects** serve as containers for related Entities, workflows, and team collaboration.

<span style="font-size: 10.0pt; mso-bidi-font-size: 12.0pt; font-family: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol;"><span style="mso-list: Ignore;">·<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Each project can have its own **custom folder structure**, defined by the project team.

<span style="font-size: 10.0pt; mso-bidi-font-size: 12.0pt; font-family: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol;"><span style="mso-list: Ignore;">·<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>**Access permissions**, folder layouts, and the selection of Entities within each project are configurable by the organization’s users.

After logging in, users can navigate to the **“Catalog”** section in the left-hand menu to see a list of accessible Projects.

[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/Qkpimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/Qkpimage.png)

Clicking on a Project will open its workspace. This loads the **Project Catalog**, where users can browse and interact with the folder structure and associated Entities.

[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/pPSimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/pPSimage.png)

Users can organize the catalog by creating folders using the **“New Folder”** button. This helps maintain clarity and structure as more Entities are added to the project.

# Creating a Project

To create a new Project in VoxelSpace, start by navigating to the **“Catalog”** section from the left-hand menu. This will display a list of all projects currently assigned to your user account.

Next, click the **“New Project”** button, located at the top of the project list:

[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/Uwgimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/Uwgimage.png)

A dialog window will appear, prompting you to enter information about the new Project:

[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/TLuimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/TLuimage.png)

<span class="rvts6">In this dialog, provide:</span>

- <span style="font-size: 10.0pt; mso-bidi-font-size: 12.0pt; font-family: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol;"><span style="mso-list: Ignore;"><span style="font: 7.0pt 'Times New Roman';"> </span></span></span>A **Project Name**
- <span style="font-size: 10.0pt; mso-bidi-font-size: 12.0pt; font-family: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol;"><span style="mso-list: Ignore;"><span style="font: 7.0pt 'Times New Roman';"> </span></span></span>An optional **Description**

Below these fields, you’ll find settings for the **Project’s Coordinate System**. These define how spatial data will be aligned and interpreted within the project. For more details, refer to the **Project Coordinate System** section of this guide.

Once you’ve entered the necessary information, click **“Create.”**  
The system will generate the project and automatically load it, placing you in the **Project Catalog** view where you can begin organizing folders and uploading spatial entities.

# Project Setup

<span class="rvts6">To modify Project settings, first go to the catalog and click on three-dot menu of your project and select Edit:</span>

[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/hIiimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/hIiimage.png)

<span class="rvts6">I</span>

[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/3y7image.png)](https://help.mystart.com/uploads/images/gallery/2025-03/3y7image.png)

# Project Coordinate System

Use the **“Coordinates”** section when creating or editing a project to define its units, reference systems, and spatial framework.

[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/3zXimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/3zXimage.png)

These settings are essential for aligning all spatial data correctly within your project and ensuring consistency across datasets.

<table border="1" cellpadding="0" class="MsoNormalTable" id="bkmrk-field-description-ti" style="border: 1pt solid rgb(255, 255, 255); width: 100%; height: 886.64px; border-collapse: collapse;"><thead><tr style="height: 19.7969px;"><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 13.4748%; height: 19.7969px;"><span style="color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">**Field**</span>

</td><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 86.4062%; height: 19.7969px;"><span style="color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">**Description**</span>

</td></tr></thead><tbody><tr style="height: 36.5938px;"><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 13.4748%; height: 36.5938px;">**Time Zone**

</td><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 86.4062%; height: 36.5938px;">Sets the local time zone for the project location. This helps timestamp data and coordinate updates across time-based processes.

</td></tr><tr style="height: 238.156px;"><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 13.4748%; height: 238.156px;">**Horizontal Datum**

</td><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 86.4062%; height: 238.156px;">A horizontal datum defines how latitude and longitude coordinates are calculated based on the shape of the Earth. VoxelSpace supports the following horizontal datums:   
  
• WGS 72  
• WGS 84  
• GRS 80  
• NAD27  
• NAD83  
• NAD83 (2011)  
• NAD83 HARN  
• NAD83 CSRS  
• GDA94  
• ETRS89  
• AGD66

</td></tr><tr style="height: 221.359px;"><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 13.4748%; height: 221.359px;">**Vertical Datum**

</td><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 86.4062%; height: 221.359px;">A vertical datum sets the reference surface used to measure elevation or depth. VoxelSpace supports the following vertical datums:   
  
• WGS 84  
• NGVD 29  
• NAVD 29  
• NAVD 88 (GEOID variants 96–12B)  
• CGVD 28  
• CGVD 2013  
• DVR 90  
• NN2000  
• NN54  
• DHHN92

</td></tr><tr style="height: 221.359px;"><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 13.4748%; height: 221.359px;">**Projection**

</td><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 86.4062%; height: 221.359px;">Defines the map projection used to represent the Earth’s curved surface in 2D/3D space. Supported projections include:   
  
• Latitude/Longitude  
• Longitude/Latitude  
• Earth-Centered Earth-Fixed (ECEF)  
• Mercator  
• Universal Transverse Mercator (UTM)  
• Transverse Mercator  
• Lambert Conformal Conic  
• AEAC  
• AMG  
• MGA

</td></tr><tr style="height: 19.7969px;"><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 13.4748%; height: 19.7969px;">**Units**

</td><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 86.4062%; height: 19.7969px;">Choose whether your project uses **meters** or **feet** for all distance measurements.

</td></tr><tr style="height: 19.7969px;"><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 13.4748%; height: 19.7969px;">**Voxel Size**

</td><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 86.4062%; height: 19.7969px;">Voxels are 3D cubes. This setting defines the edge length of each voxel (in project units).

</td></tr><tr style="height: 36.5938px;"><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 13.4748%; height: 36.5938px;">**Project Origin (X, Y, Z)**

</td><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 86.4062%; height: 36.5938px;">The origin point of the project’s coordinate space. All spatial data will be referenced relative to this point.

</td></tr><tr style="height: 36.5938px;"><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 13.4748%; height: 36.5938px;">**Min X, Y, Z (Read-only)**

</td><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 86.4062%; height: 36.5938px;">The minimum bounds of the coordinate system in each axis. Calculated automatically.

</td></tr><tr style="height: 36.5938px;"><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 13.4748%; height: 36.5938px;">**Max X, Y, Z (Read-only)**

</td><td style="border: 1pt solid rgb(255, 255, 255); padding: 0.75pt; width: 86.4062%; height: 36.5938px;">The maximum bounds of the coordinate system in each axis. Calculated automatically.

</td></tr></tbody></table>

<div class="rvps2" id="bkmrk-time-zone-the-time-z"></div>**Next Steps**

After setting the coordinate system, click **“Next”** to continue defining the dimensions and spatial extent of your project.

[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/p5Yimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/p5Yimage.png)

[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/Pi1image.png)](https://help.mystart.com/uploads/images/gallery/2025-03/Pi1image.png)

# Linking Users to Projects

VoxelSpace features a built-in security model that controls user access based on authentication and assigned permissions. Once a user is authenticated via the login provider, they can be linked to specific projects with appropriate access levels.

**Adding a User to a Project**

To assign a user to a project:

1\. **Go to your user profile** by clicking on your name or profile icon (My profile).

<span class="rvts6">[![Capture-new.PNG](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/capture-new.PNG)](https://help.mystart.com/uploads/images/gallery/2025-03/capture-new.PNG)</span>

2\. Navigate to the **“My Team”** tab.

<span class="rvts6">[![Capture-new-2.PNG](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/capture-new-2.PNG)](https://help.mystart.com/uploads/images/gallery/2025-03/capture-new-2.PNG)</span>

3\. Click **“Add New User”** to create a new user account.

4\. After the user is created, click the **Settings** icon next to their name.

5\. Select **“Add Project”** to assign a project to the user.

[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/7tOimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/7tOimage.png)

6\. In the dialog box, enter the following details:

- - - **User ID**: This is typically the user's email address, but it may vary depending on your authentication setup. If you're unsure, consult your system administrator.
        - **Access Level**: Choose between: 
            - **Read-Only**: The user can view project data but cannot modify or add content.
            - **Full Control**: The user can view, edit, add data, and manage user access for the project.

7\. Click **“Add User”** to send an invitation. The user will receive an email with instructions to join the platform and access the assigned project.

[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/40Wimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/40Wimage.png)

**Managing User Access**

- To **change a user’s access level**, click the **Settings** icon next to their name and select **“Access Level.”**

[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/UT2image.png)](https://help.mystart.com/uploads/images/gallery/2025-03/UT2image.png)

- To **remove a user from a project**, open the context menu beside their name and select **“Remove from Project.”**

# Creating a View

[Creating a View for your project. ](https://help.voxelspace.com/books/using-the-webui/page/creating-a-view)The WebUI provides two different ways to start the creation of a View...

More options for [View](https://help.voxelspace.com/books/using-the-webui/chapter/working-with-views)