Commands  ›  Element Alignment  ›  Element Alignment Match Height By Underside

Element Alignment Match Height By Underside

Element Alignment writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document. 1 reference + ≥1 mover resolved. Bounding boxes available.

After it runs

Each mover translated by (0, 0, dz) feet. Audit entry written.

When to use this

Don't use this when

Top-face alignment (ByTop). Centre alignment (ByCentre).

Decision flow

1. Resolve the reference element + mover elements.
2. Read each bbox min Z; skip bbox-less movers with a recoverable warning.
3. Compute ΔZ = ref.minZ − mover.minZ per mover.
4. In one Transaction, translate each mover by (0, 0, ΔZ).
5. Report movers moved, total ΔZ and any skipped.

What you'll see in the chat

on start
I'll match the undersides of those elements to the reference now.
thinking
Reading bbox min Z on each element and computing the ΔZ to apply.
on success
Done — {moved} element(s) moved to share the reference underside ({total_dz_mm} mm shift).
on failure
Couldn't match undersides: {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/element_alignment_match_height_by_underside
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

match underside elevation · headroom alignment · underside of element · MEP alignment · z align bottom

PillarElement Alignment