Commands › Ventilation › Design Ventilation System

Design Ventilation System

Ventilation writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document must be open. User must have Adelphos JSON file. At least one level must exist in the model. Appropriate MEP types (duct, pipe, cable tray) must be loaded in the model.

After it runs

MEP elements (ducts, pipes, trays), fittings (elbows, tees, transitions), and blocks are created. Log file is written next to the JSON file with .ventilation.log.txt extension. Neural Loading dialog shows completion summary.

When to use this

User wants to design the ventilation system from AutoCAD JSON export.
User wants to import MEP ductwork and equipment from coordinated model.
User wants automated ventilation routing from a coordinated JSON model.
User says "design the ventilation" or "create ventilation system".

Don't use this when

Not for autonomous AI execution. This command requires interactive Revit UI input (dialogs, picks, or manual confirmation).

Inputs

Name	Kind	Type	Required	Default	Description
`BasePoint`	selection	`XYZ`	yes	—	Base point for ventilation placement "Pick Revit basepoint (target origin for import)"
`JsonPath`	config	`string`	no	null	Path to Adelphos JSON file

Returns

Name	Type	Description
`DuctsCreated`	`int`	Number of MEP curve segments created
`ElbowsPlaced`	`int`	Number of elbow fittings placed
`TeesPlaced`	`int`	Number of tee fittings placed
`TransitionsPlaced`	`int`	Number of transitions placed
`BlocksPlaced`	`int`	Number of family instances placed

Decision flow

check: jsonPath.isValid → proceed
check: basePoint.isSelected → proceed
check: dto.Edges.count > 0 → proceed
resolve: excelMapper.exists → autoMap silently

What you'll see in the chat

on start

Designing your ventilation system...
Setting up ventilation import...
Preparing to create your ventilation ductwork...

thinking

Reading JSON ventilation data...
Loading block mapping configuration...
Resolving MEP types and levels...
Building node coordinate system...
Creating MEP segments...
Building fitting index...
Placing elbow fittings...
Placing tee fittings...
Placing transitions...
Importing equipment blocks...
Finalizing ventilation model...

on success

Ventilation system created successfully! {DuctsCreated} segments, {ElbowsPlaced} elbows, {TeesPlaced} tees placed.

on failure

Couldn't create ventilation 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/design_ventilation_system
Request body schema (from [RestApiParam])
Response schema (from [RestApiResponse])
curl / JS / Python code examples

Keywords & intent patterns

design vent · design ventilation · design the vent system · design the ventilation · design the ventilation system · can you please design the ventilation · please design the vent · design the ventilation please
Patterns: design * ventilation · create * ventilation · design * vent · ventilation * design · vent * system

Related commands	`ImportCommand` · `DesignPipeworkCommand` · `DesignContainmentCommand`
Pillar	Ventilation

Design Ventilation System

When to use this

Inputs

Returns

Decision flow

What you'll see in the chat

REST API

Keywords & intent patterns

Related