Commands  ›  Architecture / Coordination  ›  Architecture Highlight Unused Risers In Current View

Architecture Highlight Unused Risers In Current View

Architecture / Coordination writes to model Public API · not yet exposed

Coming soon

Before you run this

Active view contains riser shafts (Shaft Opening or generic-model risers). MEP services modelled or linked. View filter for "Unused Risers" defined or auto-created.

After it runs

Riser elements with no services passing through receive a graphic override (default red); used risers untouched. View filter persisted on the view.

When to use this

Don't use this when

Schemes with no MEP services modelled, structural risers (lifts, stairs), or non-shaft openings (e.g. escape stair voids).

Decision flow

1. Find every riser shaft visible on the active view.
2. For each riser, intersect its 3D envelope against MEP elements (host + linked).
3. Mark a riser "unused" if no MEP elements intersect.
4. Apply a graphic override to the unused risers in the active view.
5. Report counts: total risers, unused, and ids of the unused ones.

What you'll see in the chat

on start
I'll find any unused risers on this view and highlight them.
thinking
Intersecting each riser shaft with MEP services to find vacant ones.
on success
Done — {n_unused} of {n_total} risers unused. Highlighted in red on the active view.
on failure
Couldn't run the riser audit: {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/architecture_highlight_unused_risers_in_current_view
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

unused riser · riser audit · vacant shaft · riser highlight · coordination QA

PillarArchitecture / Coordination