Adapter: The Sculptor

Adapter: The Sculptor (Method 1) - V2 (Rationalized)

JSON Masterplan (Beta) Nickname: AD_SCULPT

Overview

Adapter: The Sculptor (Method 1) - V2 (Rationalized)

Inputs (5)

  • Massing (Brep): Massing (Brep List)
  • TowerIDs (Text): TowerIDs (Str List)
  • BuildingNames (Text): BuildingNames (Str List)
  • RecipeJSON (Text): RecipeJSON (Str)
  • RepeatLast (Boolean): RepeatLast (Bool)

Outputs (2)

  • JSON_Payload (Text): Output JSON Payload
  • Info (Text): Method, assumptions, simplifications and references.

Method, assumptions and simplifications

The same notes appear in the component's Info output.

Method

  1. Massing Breps are grouped by BuildingNames (default Building_01); each building takes its base level from the lowest bounding-box Z of its Breps and its top from the highest.
  2. RecipeJSON is a list of objects with floors, program and height (defaults 1, Office, 4.0 m); each object is expanded into that many floors, stacked upwards from the building base. If RecipeJSON cannot be read, a warning is shown and one 4.0 m Mixed_Use floor is used.
  3. Floor levels are added while the level is more than 0.1 m below the building top; when the recipe runs out the stack stops, unless RepeatLast is True, in which case the last floor type repeats to the top.
  4. Each Brep is cut by a horizontal plane 0.01 m above every floor level that lies inside its own bounding box (0.05 m tolerance); the section curves are dropped back by 0.01 m.
  5. Section curves are rationalised to arcs and lines (tolerance 0.05 m, angle 0.1 rad, segments 0.1 to 1000 m) and each segment is written as Line, Arc (start, mid, end) or Polyline (0.01 m tolerance), with coordinates rounded to 4 decimals. A segment that cannot be written as an arc is written as a polyline; if a segment cannot be written at all a warning says the boundary is open.
  6. Every section becomes one block named Floor_relative level_TowerID (level with up to 2 decimals; repeated names within a building get the suffix _2, _3 and so on), with tower_id, program, floor_height, floors = 1 and base_z relative to the building base; the JSON_Payload lists buildings with true_base_elevation and their blocks.

Assumptions

  • Model units are metres; the default floor height is 4.0 m.
  • TowerIDs and BuildingNames are parallel to Massing; missing entries fall back to Main_Mass and Building_01.
  • All Breps of one building share one floor grid measured from the lowest Brep of that building.

Simplifications and limits

  • One block per section curve and per floor: floors are not merged into multi-floor blocks.
  • Free-form section curves are approximated by arcs, lines and polylines.
  • Breps that do not reach a grid level inside their own height get no section at that level, so a Brep that starts between grid levels loses its lowest part.

Workflow

  • Massing Breps (with tower and building names) -> AD_SCULPT -> Masterplan Engine (JSON payload).