Framed wall panel schema.yaml: Difference between revisions

From Open Source Ecology
Jump to navigation Jump to search
(Created page with "family: framed_wall_panel version: 1.0 description: > Parametric framed wall panel with selectable framed height, module width, stud lumber size, stud spacing, and exterior sheathing orientation. dimension_convention: nominal_width_ft_means: framed_module_width nominal_height_ft_means: framed_panel_height description: > Module height refers to the framed panel height (bottom plate to top plate). Exterior OSB sheathing may extend above the framing and...")
 
No edit summary
 
Line 1: Line 1:
family: framed_wall_panel
module_type: framed_wall_panel
version: 1.0


description: >
description: >
   Parametric framed wall panel with selectable framed height, module width,
   Parametric framed wall panel with dimensional lumber studs and exterior OSB
  stud lumber size, stud spacing, and exterior sheathing orientation.
  sheathing placed on the south face (-Y direction).


dimension_convention:
coordinate_system:
   nominal_width_ft_means: framed_module_width
   x: east_west
   nominal_height_ft_means: framed_panel_height
   y: north_south
   description: >
   z: vertical
    Module height refers to the framed panel height (bottom plate to top plate).
 
    Exterior OSB sheathing may extend above the framing and is not included in
orientation:
    the nominal module height.
  south: -y
  north: +y
  west: -x
  east: +x
  up: +z
  down: -z
 
parameter_space:


parameters:
   nominal_width_ft:
   nominal_width_ft:
     type: float
     type: float
    unit: ft
     min: 0.2708
     min: 0.2708
     max: 8.0
     max: 8
    default: 4.0
    description: >
      Framed module width. The minimum value (0.2708 ft = 3.25 in) represents the
      smallest meaningful filler wall module that can be defined. This corresponds
      approximately to the width of two studs fastened together and represents an
      extreme lower bound used only for filler conditions between modules. Typical
      wall modules are significantly wider.


   nominal_height_ft:
   nominal_height_ft:
     type: float
     type: float
    unit: ft
     min: 4
     min: 4.0
     max: 12
     max: 20.0
    default: 9.0
    description: >
      Framed panel height measured from bottom plate to top plate.


   stud_lumber_nominal:
   stud_lumber_nominal:
     type: enum
     type: enum
     allowed:
     allowed:
       - "2x2"
       - 2x2
       - "2x3"
       - 2x3
       - "2x4"
       - 2x4
       - "2x6"
       - 2x6
       - "2x8"
       - 2x8
       - "2x10"
       - 2x10
       - "2x12"
       - 2x12
    default: "2x6"
    description: >
      Nominal stud and plate lumber size.


   stud_spacing_oc_in:
   stud_spacing_oc_in:
Line 56: Line 46:
       - 16
       - 16
       - 24
       - 24
    default: 24
    description: >
      Stud spacing on center in inches.


   osb_thickness_in:
   osb_thickness_in:
Line 67: Line 54:
       - 0.625
       - 0.625
       - 0.75
       - 0.75
    default: 0.4375
    description: >
      Exterior OSB sheathing thickness.
  exterior_face:
    type: enum
    allowed:
      - north
      - south
      - east
      - west
    default: south
    description: >
      Direction faced by the sheathed exterior side.
  reference_house_orientation:
    type: enum
    allowed:
      - faces_south
    default: faces_south
    description: >
      Global orientation convention.
design_rules:
  sheathing_layers:
    type: fixed
    value: 1
    description: >
      One layer of sheathing is used.
  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.
  standard_module_width_ft:
    type: fixed
    value: 4.0
    description: >
      Preferred standard module width.
  preferred_module_heights_ft:
    type: list
    values:
      - 8.0
      - 9.0
      - 10.0
    description: >
      Preferred standard framed panel heights.


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


   right_edge:
   west_edge:
     type: wall_edge
     type: wall_edge
     orientation: east
     description: edge that connects to adjacent wall module
     description: >
     position: [0, 0, 0]
      Right connection edge in local module coordinates.
    normal: [-1, 0, 0]


   top_edge:
   east_edge:
     type: wall_edge
     type: wall_edge
     orientation: up
     description: edge that connects to adjacent wall module
     description: >
     position: [nominal_width_ft, 0, 0]
      Top edge of module.
    normal: [1, 0, 0]


   bottom_edge:
   bottom:
     type: wall_edge
     type: foundation_interface
     orientation: down
     description: interface to foundation or floor
     description: >
     position: [0, 0, 0]
      Bottom edge of module.
    normal: [0, 0, -1]


derived_fields:
  top:
  stud_actual_thickness_in:
    type: ceiling_interface
     source: stud_lumber_nominal
     description: interface to roof or upper wall
     description: >
     position: [0, 0, nominal_height_ft]
      Actual lumber thickness derived from nominal stud size.
    normal: [0, 0, 1]


   stud_actual_depth_in:
   exterior_face:
     source: stud_lumber_nominal
     type: exterior_surface
     description: >
     description: exterior sheathing surface
      Actual lumber depth derived from nominal stud size.
    direction: south


   framed_panel_thickness_in:
   interior_face:
     formula: stud_actual_depth_in
     type: interior_surface
     description: >
     description: interior drywall or finish surface
      Framed wall thickness before exterior sheathing.
    direction: north


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


   panel_family_id:
   default_materials:
     formula: >
     studs: dimensional_lumber
      wall_{nominal_width_ft}x{nominal_height_ft}_{stud_lumber_nominal}_{stud_spacing_oc_in}oc_osb{osb_thickness_in}_{exterior_face}
     sheathing: osb
     description: >
      Deterministic identifier for compiled module variants.


constraints:
  structural_role: wall_panel
  - nominal_width_ft >= 0.2708
  - 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]

Latest revision as of 03:36, 11 March 2026

module_type: framed_wall_panel

description: >

 Parametric framed wall panel with dimensional lumber studs and exterior OSB
 sheathing placed on the south face (-Y direction).

coordinate_system:

 x: east_west
 y: north_south
 z: vertical

orientation:

 south: -y
 north: +y
 west: -x
 east: +x
 up: +z
 down: -z

parameter_space:

 nominal_width_ft:
   type: float
   min: 0.2708
   max: 8
 nominal_height_ft:
   type: float
   min: 4
   max: 12
 stud_lumber_nominal:
   type: enum
   allowed:
     - 2x2
     - 2x3
     - 2x4
     - 2x6
     - 2x8
     - 2x10
     - 2x12
 stud_spacing_oc_in:
   type: enum
   allowed:
     - 16
     - 24
 osb_thickness_in:
   type: enum
   allowed:
     - 0.4375
     - 0.5
     - 0.625
     - 0.75

interfaces:

 west_edge:
   type: wall_edge
   description: edge that connects to adjacent wall module
   position: [0, 0, 0]
   normal: [-1, 0, 0]
 east_edge:
   type: wall_edge
   description: edge that connects to adjacent wall module
   position: [nominal_width_ft, 0, 0]
   normal: [1, 0, 0]
 bottom:
   type: foundation_interface
   description: interface to foundation or floor
   position: [0, 0, 0]
   normal: [0, 0, -1]
 top:
   type: ceiling_interface
   description: interface to roof or upper wall
   position: [0, 0, nominal_height_ft]
   normal: [0, 0, 1]
 exterior_face:
   type: exterior_surface
   description: exterior sheathing surface
   direction: south
 interior_face:
   type: interior_surface
   description: interior drywall or finish surface
   direction: north

metadata:

 default_materials:
   studs: dimensional_lumber
   sheathing: osb
 structural_role: wall_panel