# VoxelSpace Quickstart Guide

VoxelSpace is a volumetric spatial platform that transforms massive terrain, infrastructure, and sensor datasetsinto living 4D environments. Traditional models capture only surfaces—lines, elevations, or textures. Volumetricmodeling uses  
voxels-3D pixels that store data about each cubic volume. This unlocks new capabilities forsimulation, change detection, infrastructure planning, and geoscience because the entire volume becomes thedataset.  
VoxelSpace centralizes data in a cloud-hosted repository and offers real-time voxel-level modeling and massive-scale processing using serverless spatial functions called  
spatial lambdas.

# Prerequisites

Before getting started, ensure you have:

- A VoxelSpace account (the free tier allows up to 5 GB of uploaded data and includes limited compute hours).
- Data in supported file formats as outlined in the upload wizards, including common point-cloud, mesh, block-model, and raster formats.

# 1. Sign Up & Set Up Your First Project

Follow these steps to create your first project:

1\. Navigate to platform.voxelspace.com and log in with your Microsoft, Google identity or your work email.  
2\. On the catalog page, click **New Project**  
3\. Provide a project name and description  
4\. Select your time zone  
5\. Accept the default coordinate datums and projections:

- WGS 84 horizontal datum
- Mean-sea-level vertical datum

6\. Set a voxel resolution or leave the default setting  
7\. Submit the form

Your new project will appear in the project list.

# 2. Prepare and Upload Your Data

<span style="font-size: 10.0pt;">Inside your project, click **Add Object** </span>**<span lang="EN-US" style="font-size: 10.0pt; font-family: 'Liberation Sans',sans-serif; mso-bidi-font-family: 'Liberation Sans';">→ </span><span style="font-size: 10.0pt; mso-fareast-font-family: 'Liberation Sans';">Raw Data </span>**<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">and choose the type of dataset you want to import:</span>

**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Point Cloud</span>**

- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Upload LiDAR or photogrammetry point clouds</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Supported formats: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">.las, .laz, .txt, .xyz, or compressed .zip files</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Provide an object name and optional description</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Select your file</span>

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span>**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Mesh</span>**

- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Upload surface meshes (e.g., .obj files)</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">When prompted for a column meta label, supply "Default" or another appropriate label</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Choose your file</span>

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span>**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Block Model</span>**

- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Upload block-model tables</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Supported formats: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">.csv, .txt, .xls, .xlsx, or .zip</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Map your columns to Origin X, Origin Y, Origin Z, and Value fields</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Select horizontal and vertical datums and a projection</span>

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span>**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Ortho-Imagery</span>**

- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Upload orthorectified images or mosaics</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Supported formats: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">.png, .jpg, .bmp, or .tif</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">For PNG/JPEG/BMP files, include the corresponding world file (.jgw, .pgw, .tfw, etc.)</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">GeoTIFFs embed this metadata and can be uploaded directly</span>

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span><span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">After choosing the file and completing required fields, click **Create**. A new row appears in the project list showingthe object type, creation time, size, and status icon. Note that raw objects cannot be visualized until they areprocessed.</span>

# 3. Process Data into Indexed Datasets

<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">To make data queryable and visualizable, convert raw objects into indexed datasets or voxel grids:</span>

**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Indexed Points</span>**

<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">Converts a raw point cloud into a queryable point-cloud dataset. Select your source point cloud and click **Create**.</span>

<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';"> </span>**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Indexed Mesh</span>**

<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">Similar to Indexed Points but for meshes. Select the raw mesh as source and create an indexed mesh.</span>

**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Indexed Imagery</span>**

<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">Processes ortho-imagery into an indexed raster dataset. **Important:** Only one processing job can run at a time onthe free tier, so subsequent jobs remain queued until the current task finishes.</span>

**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Voxel Block Model</span>**

<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">Converts block-model tables into voxel grids. You can specify:</span>

- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Translation offsets</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Scale factors</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Rotation parameters</span>

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span><span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">Launch this process only when no other job is queued.</span>

**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Additional Processing Options</span>**

- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Voxel Terrain</span>**
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Ortho Voxel Terrain</span>**
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Voxelised Points</span>**
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Voxelised Mesh</span>**

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span><span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">Each option is tailored to specific data types. Processing tasks appear on the **Pending Tasks** page. In the free tier,only one task can run concurrently, so plan your workflow accordingly.</span>

# 4. Visualize Your Data

<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">Once you have indexed datasets, explore them in the interactive 3D viewer:</span>

**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Creating a View</span>**

1. <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Select **New View** from the project or choose **View** from an indexed object</span>
2. <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Enter a name and description for your view</span>

**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Working with the View Editor</span>**

1. <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Click **Add Objects** and select your indexed datasets</span>
2. <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Datasets appear in the left panel with icons for:Visibility (colored dot)</span>

- - <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Color settings (palette icon)</span>
    - <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Bounding-box display</span>
    - <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Zoom controls</span>
    - <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Visibility (colored dot)</span>

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span>**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Navigation and Controls</span>**

- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Visibility toggle: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Use the colored dot to show/hide datasets</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Camera controls: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Click the cross-hair icon to center the camera on the dataset</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Extent display: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Use the box icon to reveal dataset boundaries</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Manual navigation: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Zoom or pan manually if objects don't appear automatically</span>

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span>**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Customizing Appearance</span>**

- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Color settings: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Access via the palette icon to choose constant colors or gradient schemes</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Point size adjustment: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Set point sizes for point clouds</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Color palettes: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Includes options like Viridis and Plasma</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Raster overlays: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Overlay raster layers on imagery</span>

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span>**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Toolbar Features</span>**

- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Switch between navigation tools (select, pan, zoom)</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Show or hide the grid</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Enter full-screen mode</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Automatic camera re-centering when using zoom icons</span>

# 5. Explore Advanced Features

<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">VoxelSpace offers powerful capabilities beyond basic visualization:</span>

**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Spatial Calculations</span>**

<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">Run serverless **spatial lambdas** to:</span>

1. <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Compute volumes across datasets</span>
2. <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Filter data based on specific criteria</span>
3. <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Derive metrics across trillions of voxels</span>

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span>**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Temporal Tracking</span>**

<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">Add time as a dimension to your datasets to observe changes over time, including:</span>

- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Erosion monitoring</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Construction progress tracking</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Fluid movement analysis</span>

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span>**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Multi-Source Data Fusion</span>**

<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">Seamlessly integrate multiple data types into a single voxel grid:</span>

- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">LiDAR point clouds</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Drill hole data</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Seismic datasets</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">IoT sensor data</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">CAD files</span>

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span><span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">This unified approach enables comprehensive analysis across diverse data types.</span>

**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Collaboration and Integration</span>**

- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Project sharing: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Collaborate with team members</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Unity export: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Export projects for game engines</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">API integration: </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Integrate the platform into existing workflows</span>

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span>**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Conclusion &amp; Next Steps</span>**

<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">This quickstart guide has walked you through the core VoxelSpace workflow:</span>

- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Project creation </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">and initial setup</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Data upload </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">for various formats</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Processing </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">raw data into indexed datasets</span>
- **<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Visualization </span>**<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">in the interactive 3D viewer</span>

<span style="font-size: 9.0pt; mso-fareast-font-family: 'Liberation Sans';">Volumetric modeling with voxels captures the full volume of space, enabling insights that traditional surfacemodels cannot provide.</span>

**<span style="font-size: 11.5pt; mso-fareast-font-family: 'Liberation Sans';">Recommended Next Steps</span>**

- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Explore additional processing types for your specific data</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Experiment with spatial lambdas for advanced analysis</span>
- <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Consider upgrading your plan to access:</span>
    - <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Increased storage capacity</span>
    - <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Additional compute hours</span>
    - <span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';">Concurrent job processing</span>

<span style="font-size: 10.5pt; mso-fareast-font-family: 'Liberation Sans';"> </span><span style="font-size: 9.0pt; line-height: 107%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Liberation Sans'; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: FR; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">For more advanced tutorials and documentation, visit the VoxelSpace knowledge base or contact support throughthe platform.</span>