Facade JSON Parser
Parses Facade JSON data into Curves, Heights, and Programs.
Overview
Parses Facade JSON data into Curves, Heights, and Programs.
Inputs (6)
- Facade_JSON (Text): JSON string representing facade data
- Filter_Building (Text): Filter by building name
- Filter_Tower (Text): Filter by tower ID
- Filter_Program (Text): Filter by program name
- Filter_Level (Integer): Filter by level index
- ExactMatch (Boolean): Require exact match for filters
Outputs (5)
- BoundsExt (Curve): Open Exterior Physical Lines
- BoundsClosed (Curve): Closed Master Polygon for orientation
- Heights (Number): Floor-to-floor height
- Programs (Text): Tags/Labels
- Info (Text): Method, assumptions, simplifications and references.
Method, assumptions and simplifications
The same notes appear in the component's Info output.
Method
- Expects JSON of the form building -> program -> list of floors, each floor with tower_id, floor_index, true_z, height, BoundsClosed and BoundsExt (segment lists of Line, Arc or Polyline).
- Buildings, programs, towers and levels are filtered. Text filters match if any entry matches: ExactMatch True needs equal text (case-insensitive); otherwise the entry is contained in the name, or used as a wildcard pattern with * and ?.
- Segments are rebuilt and joined (0.01 tolerance); BoundsClosed takes the first joined curve and closes it if open; floors without a BoundsClosed polygon give a null item (kept for index alignment) and a warning. All curves are moved up by true_z.
- For every exterior curve one item is output in each tree: the curve, the closed outline, the floor height and a label building | tower | program - Lvl n. Branch paths are (building index; program index).
Assumptions
- The JSON is a facade export with the keys above (not the BIM Attribute Serializer payload).
- Segment coordinates are relative to the floor level; true_z gives the absolute level.
Simplifications and limits
- Missing true_z or height read as 0; missing floor_index reads as -1.
- Branch indices count only the buildings and programs that pass the filters, so paths shift when filters change.
Workflow
- Facade JSON text -> Facade_JSON; BoundsExt and Heights -> facade modules such as Facade Module: Vertical Fins or Rhythmic Balconies.