Commands  ›  Element Movement  ›  Placement Move Element Into Detected Space

Placement Move Element Into Detected Space

Element Movement writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document. Document has a non-template 3D view. ≥1 element resolved.

After it runs

Each element translated into detected space. Audit entry + per-element evidence log.

When to use this

Don't use this when

Precise alignment (use ElementAlignment*). Absolute vector moves (use ByDumbVector).

Decision flow

1. Resolve element ids + the clearance threshold (default 500 mm) and step (default 200 mm).
2. Resolve the project's default 3D view for ray casting.
3. In one Transaction, per element: cast six rays (±X, ±Y, ±Z), pick the direction with most clearance > threshold.
4. If no direction passes the threshold, fall back to centring on the most-symmetrical axis.
5. Move each element by step in the chosen direction; report direction + clearance per element.

What you'll see in the chat

on start
I'll push those elements into clear space — casting rays first.
thinking
Casting rays in 6 directions per element to find the best clearance.
on success
Done — {n_moved} element(s) pushed into detected space (avg clearance {avg_clearance_mm} mm).
on failure
Couldn't push elements into space: {error}.

REST API

Not yet exposed

This command does not carry a [RestApi] attribute today. Once tagged, this section will auto-populate with:

  • POST /api/v1/commands/placement_move_element_into_detected_space
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

move into space · clearance-aware move · ray cast move · push into clear room · MEP space-aware

PillarElement Movement