Commands  ›  Clash Manager / Solver  ›  Clash Solver Offset Service Under All Beams In View

Clash Solver Offset Service Under All Beams In View

Clash Manager / Solver writes to model Public API · not yet exposed

Coming soon

Before you run this

Active view with StructuralFraming elements visible.

After it runs

Zero or more ElementTransformUtils.MoveElement calls, each inside its own Transaction.

When to use this

Don't use this when

Per-element targeted offsets — use OFFSET_SERVICE_AROUND_DUCT or MOVE_OBJECT_DOWN.

Inputs

NameKindTypeRequiredDefaultDescription
PresetKind config string no "clash_tolerances" Deterministic config preset

Decision flow

1) Enumerate StructuralFraming in active view; WireError if none.
2) beam_soffit_z_ft = min over beams of bb.Min.Z (lowest underside in view).
3) Gather candidate services from element ids (Bot) OR FilteredElementCollector scoped to active view for Pipes/Ducts/CableTrays (Human).
4) For each service: compute drop_ft = max(0, (service bb.Max.Z - beam_soffit_z_ft) + envelope_ft).
5) If drop_ft > 1e-6, delegate TryDirectionalMoveOnService.ProbeAndMove(doc, service, -Z, drop_ft, threshold_ft, centreFallback=false). Otherwise emit {already_below_beams}.
6) Aggregate and emit summary.

What you'll see in the chat

on start
Dropping services below all in-view beams…
thinking
Enumerating beams + min soffit…
Dropping each candidate service via DirectionalMoveService…
on success
Processed {elements_processed} services; moved {elements_moved}.
on failure
Offset under beams failed: {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/clash_solver_offset_service_under_all_beams_in_view
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

clashsolveroffsetserviceunderallbeamsinview · offset under beams · solver drop below beams

PillarClash Manager / Solver