thatopen-core-fragments

Initialize ThatOpen FragmentsManager workers and query BIM fragment data.

17|1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/Impertio-Studio/ThatOpen-Claude-Skill-Package --skill thatopen-core-fragments-impertio-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: thatopen-core-fragments
Source: https://github.com/Impertio-Studio/ThatOpen-Claude-Skill-Package/tree/main/skills/source/thatopen-core/thatopen-core-fragments
Command: npx skills add https://github.com/Impertio-Studio/ThatOpen-Claude-Skill-Package --skill thatopen-core-fragments-impertio-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents fragment-system failures and production issues by showing how to correctly initialize the Fragments worker, load fragment binaries, query BIM element data, and safely dispose models to avoid GPU/memory leaks.

Core Features & Use Cases

  • Fragment-first pipeline (IFC → .frag → fast reloads): Convert IFC once with IfcLoader, then reload the stored fragment binary to skip repeated WASM parsing.
  • Correct worker lifecycle & API usage: Use FragmentsManager.init(workerURL) before any fragment operation to enable raycasting, data extraction, and model queries.
  • Targeted element operations with ModelIdMap: Highlight, raycast, and extract IFC properties/positions/bounding boxes by model UUID + local element IDs.
  • Multi-model coordination alignment: Apply base coordination to align federated models into a shared world origin.
  • Anti-pattern guardrails: Cover common production mistakes such as worker version mismatch, missing disposal, skipping coordinate alignment, and forgetting to await async worker calls.

Quick Start

Tell the AI to initialize FragmentsManager with a worker URL matching your @thatopen/fragments version, then load and raycast fragments using ModelIdMap targeting the loaded model IDs.

Frequently Asked Questions about thatopen-core-fragments

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I load and query BIM fragments safely without memory leaks?

To load BIM fragments safely, initialize the worker via FragmentsManager.init(workerURL), use ModelIdMap for element targeting, and strictly dispose models after operations to prevent GPU and memory leaks.

Why does raycasting fail on loaded BIM fragments?

Raycasting fails if you skip FragmentsManager.init(workerURL) before operations or use a worker version mismatched with your @thatopen/fragments library, preventing proper worker-based data extraction.

How do I convert IFC to fragments for fast reloading?

Convert IFC files once using IfcLoader to generate a fragment binary, then reload the stored .frag file to skip repeated WASM parsing and accelerate BIM geometry rendering workflows.

How do I highlight or extract properties from specific BIM elements?

Use ModelIdMap to target specific elements by combining the model UUID and local element IDs, enabling precise highlight, reset, and async queries for IFC properties, positions, and bounding boxes.

What is the best way to align multiple federated BIM models in a shared origin?

Apply base coordination alignment to align federated models into a shared world origin, ensuring multi-model coordination is accurate before performing raycasting or element extraction operations.

What happens if I forget to await async worker calls in the fragments system?

Forgetting to await async worker calls causes incomplete data extraction and unreliable BIM geometry queries, leading to silent failures when targeting elements or retrieving model properties.