Commands  ›  Architecture / Roofs  ›  Architecture Add Pitched Roof At Top Level Derived From Linked Site Topology

Architecture Add Pitched Roof At Top Level Derived From Linked Site Topology

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

Coming soon

Before you run this

A linked site model with TopographySurface or contour data. Top level defined. Building footprint complete at the top level. Pitched-roof type configured in the project.

After it runs

One pitched Roof at the top level following the building footprint, ridge oriented per the site contour slope, with the configured pitch angle on each plane.

When to use this

Don't use this when

Flat sites (use the simple pitched-roof command), buildings with multiple roof zones, or where local planning specifies a fixed ridge direction regardless of slope.

Decision flow

1. Read the linked site's TopographySurface and compute the prevailing slope vector across the building footprint.
2. Derive a ridge axis perpendicular to the slope vector, projected onto the top level.
3. Read the building footprint from the top floor.
4. Build a pitched roof in one Transaction with two slope planes meeting on the ridge.
5. Report ridge orientation, pitch and ridge length.

What you'll see in the chat

on start
I'll generate a pitched roof aligned to the site slope now.
thinking
Reading the linked site topology and computing the prevailing slope.
Orienting the ridge perpendicular to the slope and building the slope planes.
on success
Done — pitched roof placed with ridge {ridge_orientation}° and {pitch}° pitch ({ridge_length} m ridge).
on failure
Couldn't generate the pitched 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_pitched_roof_at_top_level_derived_from_linked_site_topology
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

pitched roof from site · contour-driven roof · site topology roof · ridge orientation · planning roof

PillarArchitecture / Roofs