Skip to content
Roboscope Docs

Roboscope 2 Documentation

AR-powered spatial intelligence and inspection platform with LiDAR scanning, 3D marker placement, and real-time collaboration
Get Started API Reference Data Model

Platform Overview

Section titled “Platform Overview”

Roboscope 2 is a comprehensive AR inspection platform that combines iOS ARKit with a robust backend API to provide:

  • LiDAR Scanning: Capture real-world environments with millimeter precision
  • 3D Marker Placement: Place and manage spatial annotations in AR
  • Model Alignment: Automatically align 3D models with real spaces using ICP algorithms
  • Space Calibration: Transform marker coordinates to calibrated coordinate systems
  • Real-time Collaboration: Presence tracking and distributed locking
  • Export/Import: Move sessions between spaces and environments

Quick Start Guide

Set up your development environment and create your first work session in minutes.

Data Model

Understand the core entities: Spaces, Work Sessions, Markers, and Marker Details.

API Reference

Complete REST API documentation with examples for all endpoints.

iOS Integration

Integrate the Roboscope API into your iOS ARKit application.

Marker Details

Learn how to calculate and use marker metrics for spatial measurements.

Workflows

Common workflows and patterns for inspection, alignment, and collaboration.

Core Concepts

Section titled “Core Concepts”

Spaces

Section titled “Spaces”

Spaces represent physical locations or rooms. Each space can have:

  • 3D model files (GLB/USDC)
  • Calibration vectors for coordinate transformations
  • Multiple work sessions

Work Sessions

Section titled “Work Sessions”

Work sessions are inspection or repair activities within a space. Features:

  • Session types: inspection, repair, other
  • Status tracking: draft, active, done, archived
  • Version control with optimistic concurrency
  • Export/import capabilities

Markers

Section titled “Markers”

3D spatial annotations placed in AR. Each marker has:

  • Four corner points defining a quadrilateral in 3D space
  • Optional label and color
  • Custom properties (arbitrary JSON metadata)
  • Calibrated coordinates (transformed via space calibration)

Marker Details

Section titled “Marker Details”

One-to-one measurement data for markers:

  • Center location (longitudinal/cross)
  • Distance metrics (X/Z distances)
  • Size measurements (width/length)
  • Custom measurement properties

Architecture

Section titled “Architecture”

The platform consists of multiple components working together:

  • iOS App: ARKit-based scanning and marker placement
  • REST API: Rust backend with Axum framework
  • PostgreSQL: Primary data store with PostGIS extensions
  • Redis: Real-time presence and caching
  • Portal: Next.js web interface for data visualization

Key Features

Section titled “Key Features”

1. Spatial Data Model

Section titled “1. Spatial Data Model”
  • 3D Point Arrays: Four corner points per marker with [x, y, z] coordinates
  • Calibration: Space-level calibration vectors transform raw AR coordinates
  • Metrics: Automatic calculation of center, width, length, and distances

2. Real-time Collaboration

Section titled “2. Real-time Collaboration”
  • Presence Tracking: Know who’s active in each session
  • Distributed Locks: Prevent concurrent editing conflicts
  • Heartbeat System: Auto-cleanup of stale presence

3. Export/Import

Section titled “3. Export/Import”
  • Session Portability: Export complete sessions with all markers
  • Space Migration: Move sessions between different spaces
  • Data Backup: JSON-based export format for archival

4. Custom Properties

Section titled “4. Custom Properties”
  • Flexible Metadata: Store arbitrary JSON on markers and details
  • Domain-Specific Data: Severity levels, categories, inspector notes
  • Queryable: GIN indexes for fast JSON property searches