Commands  ›  Element Alignment  ›  Element Alignment Match Slope From Reference

Element Alignment Match Slope From Reference

Element Alignment writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document. 1 reference + ≥1 mover resolved. Both have recoverable directions.

After it runs

Each mover rotated in place so |dir − refDir| ≈ 0.

When to use this

Don't use this when

Intersection-point-based slope alignment (use MatchSlopeIntersection). Height-only alignment.

Decision flow

1. Resolve the reference element + mover elements.
2. Read the reference direction vector.
3. Per mover, compute the rotation that takes its direction onto the reference (rotate about Z when planar; full 3D otherwise).
4. In one Transaction, ElementTransformUtils.RotateElement each mover about its start point.
5. Report movers rotated, mean rotation angle and any skipped (no recoverable direction).

What you'll see in the chat

on start
I'll match those elements to the reference direction now.
thinking
Reading the reference direction and computing the rotation per mover.
on success
Done — {moved} element(s) rotated to match the reference direction (mean rotation {mean_angle_deg}°).
on failure
Couldn't match slope: {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_slope_from_reference
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

match slope · align direction · parallel run · drainage gradient match · MEP slope alignment

PillarElement Alignment