Commands  ›  Architecture / Roofs  ›  Architecture Add Flat Roof At Top Level From Existing Floor Footprint

Architecture Add Flat Roof At Top Level From Existing Floor Footprint

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

Coming soon

Before you run this

A top-level floor exists with a closed boundary. Top level defined in Levels. Flat-roof type configured in the project. No existing roof at the top level.

After it runs

One Floor (or Roof) element placed at the top level following the existing top floor's footprint, in the project flat-roof type, with the configured perimeter offset.

When to use this

Don't use this when

Pitched roofs (use the pitched-roof commands), buildings with multiple roof zones at different heights, or where the top floor footprint doesn't match the roof footprint (e.g. set-back terraces).

Decision flow

1. Find the top level and the floor placed at that level.
2. Read the floor's boundary curve loop.
3. Apply the configured perimeter offset (positive for terrace, negative for parapet inset).
4. Create a Floor / Roof in the project flat-roof type, snapped to the offset boundary, in one Transaction.
5. Report the new roof element id and the boundary length.

What you'll see in the chat

on start
I'll add a flat roof from the top-floor footprint now.
thinking
Reading the top floor's boundary and applying the perimeter offset.
on success
Done — flat roof placed at {top_level} following the existing footprint ({area} m²).
on failure
Couldn't add the flat roof: {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_add_flat_roof_at_top_level_from_existing_floor_footprint
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

flat roof · roof from footprint · top level roof · parapet upstand · roof generation

PillarArchitecture / Roofs