SISSF

Spatial Intelligence Scene State Format:

• A platform-agnostic, human and machine readable 3D scene representation standard (wiki).
• A Python library for working with the Spatial Intelligence Scene State Format (pip install sissf).

Features

• Parse and generate scene-state files with 3D model instances and transforms
• Support for architecture definitions (rooms, walls, floors, ceilings)
• Scene graph representation for semantic and spatial relationships
• Quaternion-based rotations for accurate transformations
• Compatible with Holodeck, Objaverse, and AI2-THOR asset sources
• Geometry utilities for 3D bounding boxes, points, and transforms

Installation

From pypi Package

sissf

# https://pypi.org/project/sissf/
pip install sissf

From Local Repository

pip install -e .

# Or install with visualization support
pip install -e ".[viz]"

# Install all optional dependencies (dev tools, visualization, examples)
pip install -e ".[all]"

Requirements

• Python >= 3.10
• numpy >= 1.24.0
• scipy >= 1.10.0

Examples

• visualize_scene.py - Complete Python script for trimesh visualization
• visualize_scene.ipynb - Interactive Jupyter notebook walkthrough
• visualize_scene.ipynb - Interactive Google colab walkthrough
• scene_graph_example.py - Scene graph creation, querying, and format conversion

Documentation

• Scene State Format - 3D model instances and transforms
• Architecture Format - Building geometry (rooms, walls, floors, ceilings)
• Scene Graph Format - Semantic and spatial relationships between objects

Acknowledgements

• smartscenes libsg
• smartscenes sstk