Commands  ›  Ventilation Systems  ›  Ventilation Create Extract System From Grilles

Ventilation Create Extract System From Grilles

Ventilation Systems writes to model Public API · not yet exposed

Coming soon

Before you run this

One or more extract grilles selected. A Mechanical Equipment family for the AHU / fan unit exists in the model or the project standard provides one.

After it runs

A new Mechanical Duct System is created with the selected grilles assigned to it; system name + abbreviation set; selection moved to the new system.

When to use this

Don't use this when

Supply systems (run the matching supply-side command), VAV / mixed systems, or grilles that should sit on more than one extract system.

Decision flow

1. Read the selected grilles and verify each has an extract connector available.
2. Resolve the system type from the project standard (or the active preset).
3. Create a new MechanicalSystem in one Transaction; assign every grille to it.
4. Set the system name + abbreviation from the room or zone.
5. Report the new system id and how many grilles joined it.

What you'll see in the chat

on start
I'll group those extract grilles into a single mechanical duct system now.
thinking
Reading the selected grilles and confirming each has a free extract connector.
Creating the mechanical system and assigning every grille.
on success
Done — extract system "{system_name}" created with {n_grilles} grilles attached.
on failure
Couldn't create the extract system: {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/ventilation_create_extract_system_from_grilles
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

create extract system · extract system from grilles · mechanical duct system · group extract grilles · ventilation system

PillarVentilation Systems