Commands  ›  Lighting Layout  ›  Lighting Add Lights To Rooms From Config

Lighting Add Lights To Rooms From Config

Lighting Layout writes to model Public API · not yet exposed

Coming soon

Before you run this

Lighting config JSON loaded for the project (room type → fitting + lux target + spacing). Lighting families loaded. Rooms placed and have a Department / Room Type parameter set.

After it runs

Lighting fittings placed in each selected room according to the config; circuit parameter and room reference set; audit entry written.

When to use this

Don't use this when

Bespoke lighting design (use Dialux import), emergency-only lighting (use the EM lighting command), or rooms that need photometric calculation rather than spec-driven layout.

Inputs

NameKindTypeRequiredDefaultDescription
PresetKind config string no "placement_config" Deterministic config preset

Decision flow

1. Read each selected room's geometry and Room Type parameter.
2. Look up the matching lighting config entry (fitting, spacing, mounting height).
3. Lay out fittings on a grid that fits inside the room boundary.
4. Place each fitting in one Transaction; set circuit + room reference.
5. Report fittings placed per room and any rooms skipped (e.g. no config entry).

What you'll see in the chat

on start
I'll place the lighting from your project config now — checking room types first.
thinking
Matching each room's type to the lighting config entry.
Laying fittings out on a grid sized to each room.
on success
Done — {n_placed} fittings placed across {n_rooms} rooms. {n_skipped} rooms skipped: {skip_reasons}.
on failure
Couldn't place the lighting: {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/lighting_add_lights_to_rooms_from_config
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

place lights · lighting layout · lighting from config · lighting preset · room lighting

PillarLighting Layout