Commands  ›  Clash Manager / Solver  ›  Clash Solver Move Device To Nearest Host

Clash Solver Move Device To Nearest Host

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

Coming soon

Before you run this

Active document; device + target host resolvable; device is FamilyInstance with LocationPoint; host category matches device's current host family.

After it runs

One MoveElement inside a single Transaction if projection succeeds.

When to use this

Don't use this when

Full host-reassignment — separate workflow (delete + recreate).

Inputs

NameKindTypeRequiredDefaultDescription
PresetKind config string no "clash_tolerances" Deterministic config preset

Decision flow

1) Resolve device (FamilyInstance) and targetHost (HostObject subclass: Wall, Ceiling, Floor, RoofBase).
2) WireError if device not FamilyInstance or host not HostObject.
3) Read device LocationPoint; WireError if missing.
4) Collect side faces of targetHost via HostObjectUtils.GetSideFaces (wall) / .GetBottomFaces (ceiling) / .GetTopFaces (floor).
5) Project device point onto every face; pick projection with smallest distance.
6) delta = projection - devicePoint. If delta zero → no-op.
7) Forecast gate with the delta; if introduces new clashes → WireError + no-op.
8) Transaction "ClashSolver::MoveToHost"; MoveElement(doc, device.Id, delta); commit.

What you'll see in the chat

on start
Projecting device onto target host surface…
thinking
Resolving device + host…
Gathering target host faces…
Choosing nearest projection and delta…
Forecasting before move…
on success
Moved device by {delta_ft} ft onto host.
on failure
Move-to-host 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_move_device_to_nearest_host
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

clashsolvermovedevicetonearesthost · move device to host · solver re-host move

PillarClash Manager / Solver