Wall Schema for Iconic CAD Workflow

family: framed_wall_panel version: 1.0

description: >

 Parametric framed wall panel with selectable nominal width, nominal height,
 stud lumber size, stud spacing, and exterior sheathing orientation.

parameters:

 nominal_width_ft:
   type: float
   unit: ft
   min: 1.0
   max: 8.0
   default: 4.0
   description: Overall nominal module width

 nominal_height_ft:
   type: float
   unit: ft
   min: 4.0
   max: 20.0
   default: 9.0
   description: Overall nominal module height

 stud_lumber_nominal:
   type: enum
   allowed:
     - "2x2"
     - "2x3"
     - "2x4"
     - "2x6"
     - "2x8"
     - "2x10"
     - "2x12"
   default: "2x6"
   description: Nominal framing lumber size used for studs and plates

 stud_spacing_oc_in:
   type: enum
   allowed:
     - 16
     - 24
   default: 24
   description: Stud spacing on center in inches

 osb_thickness_in:
   type: enum
   allowed:
     - 0.4375
     - 0.5
     - 0.625
     - 0.75
   default: 0.4375
   description: Exterior sheathing thickness

 exterior_face:
   type: enum
   allowed:
     - north
     - south
     - east
     - west
   default: south
   description: Direction faced by the sheathed exterior side of the module

 reference_house_orientation:
   type: enum
   allowed:
     - faces_south
   default: faces_south
   description: Global orientation convention for design reference

design_rules:

 sheathing_layers:
   type: fixed
   value: 1
   description: One layer of OSB on exterior side only

 sheathing_material:
   type: fixed
   value: OSB
   description: Exterior sheathing material for this schema version

 sheathing_side_rule:
   type: fixed
   value: exterior_only
   description: OSB is applied only to the exterior face

 nominal_module_width_rule:
   type: variable
   description: Module width is user-selectable from 1 ft to 8 ft nominal

 nominal_module_height_rule:
   type: variable
   description: Module height is user-selectable from 4 ft to 20 ft nominal

 standard_nominal_width_ft:
   type: fixed
   value: 4.0
   description: Preferred standard nominal module width

 standard_nominal_heights_ft:
   type: list
   values:
     - 8.0
     - 9.0
     - 10.0
   description: Preferred standard nominal module heights

interfaces:

 left_edge:
   type: wall_edge
   orientation: west
   description: Left connection edge in local module coordinates

 right_edge:
   type: wall_edge
   orientation: east
   description: Right connection edge in local module coordinates

 top_edge:
   type: wall_edge
   orientation: up
   description: Top edge of module

 bottom_edge:
   type: wall_edge
   orientation: down
   description: Bottom edge of module

derived_fields:

 stud_actual_thickness_in:
   source: stud_lumber_nominal
   description: Actual lumber thickness derived from nominal lumber size

 stud_actual_depth_in:
   source: stud_lumber_nominal
   description: Actual lumber depth derived from nominal lumber size

 framed_panel_thickness_in:
   formula: stud_actual_depth_in
   description: Framed wall thickness before sheathing

 overall_panel_thickness_in:
   formula: stud_actual_depth_in + osb_thickness_in
   description: Total panel thickness including exterior OSB

 sheathing_face_local:
   source: exterior_face
   description: Exterior face direction in module semantics

 panel_family_id:
   formula: >
     wall_{nominal_width_ft}x{nominal_height_ft}_{stud_lumber_nominal}_{stud_spacing_oc_in}oc_osb{osb_thickness_in}_{exterior_face}
   description: Deterministic identifier for compiled module variants

constraints:

 - nominal_width_ft >= 1.0
 - nominal_width_ft <= 8.0
 - nominal_height_ft >= 4.0
 - nominal_height_ft <= 20.0
 - stud_spacing_oc_in in [16, 24]
 - stud_lumber_nominal in ["2x2","2x3","2x4","2x6","2x8","2x10","2x12"]
 - osb_thickness_in in [0.4375, 0.5, 0.625, 0.75]
 - exterior_face in [north, south, east, west]