Commands  ›  Element Alignment  ›  Element Alignment Match Height By Centre

Element Alignment Match Height By Centre

Element Alignment writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document. Reference + at least one mover resolved. All elements expose a bounding box.

After it runs

Each mover translated by (0, 0, dz) feet to match reference centre. Audit entry written.

When to use this

Don't use this when

Top-face alignment (use ByTop). Underside (use ByUnderside). Horizontal moves.

Decision flow

1. Resolve the reference element + mover elements.
2. Read each bbox centre Z; skip bbox-less movers with a recoverable warning.
3. Compute ΔZ = ref.centreZ − mover.centreZ 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 centreline elevations of those elements to the reference now.
thinking
Reading bbox centre Z on each element and computing the ΔZ to apply.
on success
Done — {moved} element(s) moved to share the reference centreline ({total_dz_mm} mm shift).
on failure
Couldn't match centreline heights: {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_centre
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

match centre elevation · centreline alignment · centre of element · MEP alignment · z align centre

PillarElement Alignment