Commands › Lighting › Design Lighting System

Design Lighting System

Lighting writes to model Public API · not yet exposed

Coming soon

Before you run this

Active Revit document must be open. Adelphos JSON file must exist at the configured path. Cable tray family types must be loaded. Level must exist near the base point Z. For hosting resolution, ceiling elements or a 2700mm fake ceiling height is used.

After it runs

MEP segments, fittings, lighting fixtures, detail lines, and text notes are created. Fixtures are placed using intelligent hosting resolution (ceiling/wall/floor detection). A run log and placement report are written.

When to use this

User wants to import a lighting layout from AutoCAD via Adelphos JSON.
User needs to place luminaires with correct ceiling hosting and containment routes.

Don't use this when

Creating lighting manually. Importing fire alarm or small power systems. Editing existing lighting layouts.

Inputs

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

Returns

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

What you'll see in the chat

on start

Importing lighting system from JSON...
Setting up lighting layout with fixture hosting...

thinking

Reading JSON lighting data...
Resolving MEP types and levels...
Creating MEP segments...
Calculating lux levels and placing fixtures...
Importing polylines and text annotations...
Finalizing lighting model...

on success

Lighting imported! Created {CurvesCreated} segments, {ElbowsPlaced} elbows, {BlocksPlaced} fixtures.

on failure

Lighting import 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/design_lighting_system
Request body schema (from [RestApiParam])
Response schema (from [RestApiResponse])
curl / JS / Python code examples

Keywords & intent patterns

design lighting · design the lighting · lighting system · create lighting · place lights
Patterns: design * lighting · create * lighting · lighting * design · place * lights

Related commands	`DesignContainmentSystemCommand` · `DesignSmallPowerSystemCommand` · `DesignFireAlarmSystemCommand` · `DesignMechPowerSystemCommand`
Pillar	Lighting