Update app/components.py

app/components.py

@@ -1,8 +1,8 @@
 """
-HVAC Load Calculator - Building Components Module
+BuildSustain - Building Components Module
 
 This module handles the definition of building envelope components (walls, roofs, floors,
-windows, doors, skylights) for the HVAC Load Calculator application. It allows users to
+windows, doors, skylights) for the BuildSustain application. It allows users to
 assign constructions and fenestrations to specific components, define their areas,
 orientations, and other relevant properties.
 
@@ -25,7 +25,7 @@ logger = logging.getLogger(__name__)
 # Define constants
 COMPONENT_TYPES = ["Wall", "Roof", "Floor", "Window", "Door", "Skylight"]
 ORIENTATION_OPTIONS = ["A (North)", "B (South)", "C (East)", "D (West)", "Custom"]
-ORIENTATION_MAP = {'A (North)': 0.0, 'B (South)': 180.0, 'C (East)': 90.0, 'D (West)': 270.0, 'Custom': None}
+ORIENTATION_MAP = {'A (North)': 0.0, 'B (South)': 180.0, 'C (East)': 90.0, 'D (West)': 270.0, 'Custom': 0.0}
 
 def display_components_page():
     """
@@ -156,7 +156,7 @@ def display_component_tab(comp_type: str):
             )
             
             # Component-specific inputs
-            if comp_type in ["walls", "windows", "doors"]:
+            if comp_type in ["walls", "windows", "doors", "roofs", "skylights"]:
                 # Elevation (orientation)
                 elevation = st.selectbox(
                     "Elevation",
@@ -165,51 +165,42 @@ def display_component_tab(comp_type: str):
                     help="Orientation of the component relative to the building orientation angle."
                 )
                 
-                # Custom rotation if elevation is custom
-                rotation = 0.0
-                if elevation == "Custom":
-                    rotation = st.number_input(
-                        "Rotation (°)",
-                        min_value=0.0,
-                        max_value=359.9,
-                        value=float(editor_state.get("rotation", 0.0)),
-                        format="%.1f",
-                        help="Custom rotation angle in degrees (0° = North, 90° = East, 180° = South, 270° = West)."
-                    )
-                else:
-                    rotation = ORIENTATION_MAP[elevation]
-                
-                # Tilt
-                tilt = st.number_input(
-                    "Tilt (°)",
-                    min_value=0.0,
-                    max_value=180.0,
-                    value=float(editor_state.get("tilt", 90.0)),
-                    format="%.1f",
-                    help="Tilt angle of the component relative to horizontal (0° = horizontal, 90° = vertical)."
-                )
-            
-            elif comp_type in ["roofs", "skylights"]:
-                # Orientation
-                orientation = st.number_input(
-                    "Orientation (°)",
+                # Rotation
+                rotation = st.number_input(
+                    "Rotation (°)",
                     min_value=0.0,
                     max_value=359.9,
-                    value=float(editor_state.get("orientation", 0.0)),
+                    value=float(editor_state.get("rotation", 0.0)),
                     format="%.1f",
-                    help="Orientation angle in degrees (0° = North, 90° = East, 180° = South, 270° = West)."
+                    help="Rotation angle in degrees to adjust the elevation (0° = North, 90° = East, 180° = South, 270° = West)."
                 )
                 
+                # Calculate surface azimuth
+                elevation_angle = ORIENTATION_MAP[elevation]
+                surface_azimuth = (elevation_angle + rotation) % 360.0
+                
                 # Tilt
+                default_tilt = 0.0 if comp_type in ["roofs", "skylights"] else 90.0
                 tilt = st.number_input(
                     "Tilt (°)",
                     min_value=0.0,
                     max_value=180.0,
-                    value=float(editor_state.get("tilt", 30.0)),
+                    value=float(editor_state.get("tilt", default_tilt)),
                     format="%.1f",
                     help="Tilt angle of the component relative to horizontal (0° = horizontal, 90° = vertical)."
                 )
             
+            elif comp_type == "floors":
+                # Contact with ground percentage
+                contact_with_ground_percentage = st.number_input(
+                    "Contact with Ground (%)",
+                    min_value=0.0,
+                    max_value=100.0,
+                    value=float(editor_state.get("contact_with_ground_percentage", 0.0)),
+                    format="%.1f",
+                    help="Percentage of the floor in contact with the ground (0% = fully above ground, 100% = fully in contact)."
+                )
+            
             # Construction or fenestration selection
             if comp_type in ["walls", "roofs", "floors"]:
                 construction_options = list(available_items.keys())
@@ -223,6 +214,43 @@ def display_component_tab(comp_type: str):
                     index=construction_options.index(editor_state.get("construction", "")) if editor_state.get("construction", "") in construction_options else 0,
                     help="Select the construction assembly for this component."
                 )
+                
+                # Extract material properties from the first layer
+                absorptivity = 0.7
+                emissivity = 0.9
+                colour = "Unknown"
+                if construction in available_items and "layers" in available_items[construction]:
+                    first_layer = available_items[construction]["layers"][0]
+                    if "material" in first_layer:
+                        material_data = get_material_data(first_layer["material"])
+                        if material_data:
+                            absorptivity = material_data.get("absorptivity", 0.7)
+                            emissivity = material_data.get("emissivity", 0.9)
+                            colour = material_data.get("colour", "Unknown")
+                
+                # Material property inputs
+                absorptivity = st.number_input(
+                    "Absorptivity",
+                    min_value=0.0,
+                    max_value=1.0,
+                    value=float(editor_state.get("absorptivity", absorptivity)),
+                    format="%.2f",
+                    help="Solar absorptivity of the component's outer surface (0.0 to 1.0)."
+                )
+                emissivity = st.number_input(
+                    "Emissivity",
+                    min_value=0.0,
+                    max_value=1.0,
+                    value=float(editor_state.get("emissivity", emissivity)),
+                    format="%.2f",
+                    help="Thermal emissivity of the component's outer surface (0.0 to 1.0)."
+                )
+                colour = st.text_input(
+                    "Colour",
+                    value=editor_state.get("colour", colour),
+                    help="Colour of the component's outer surface."
+                )
+            
             else:  # Windows, doors, skylights
                 # For fenestrations, we need to select a parent component
                 parent_components = get_parent_components(comp_type)
@@ -250,6 +278,54 @@ def display_component_tab(comp_type: str):
                     index=fenestration_options.index(editor_state.get("fenestration", "")) if editor_state.get("fenestration", "") in fenestration_options else 0,
                     help="Select the fenestration type for this component."
                 )
+                
+                if comp_type == "doors":
+                    # Extract material properties from the first layer
+                    absorptivity = 0.7
+                    emissivity = 0.9
+                    colour = "Unknown"
+                    if fenestration in available_items and "layers" in available_items[fenestration]:
+                        first_layer = available_items[fenestration]["layers"][0]
+                        if "material" in first_layer:
+                            material_data = get_material_data(first_layer["material"])
+                            if material_data:
+                                absorptivity = material_data.get("absorptivity", 0.7)
+                                emissivity = material_data.get("emissivity", 0.9)
+                                colour = material_data.get("colour", "Unknown")
+                    
+                    # Material property inputs
+                    absorptivity = st.number_input(
+                        "Absorptivity",
+                        min_value=0.0,
+                        max_value=1.0,
+                        value=float(editor_state.get("absorptivity", absorptivity)),
+                        format="%.2f",
+                        help="Solar absorptivity of the door's outer surface (0.0 to 1.0)."
+                    )
+                    emissivity = st.number_input(
+                        "Emissivity",
+                        min_value=0.0,
+                        max_value=1.0,
+                        value=float(editor_state.get("emissivity", emissivity)),
+                        format="%.2f",
+                        help="Thermal emissivity of the door's outer surface (0.0 to 1.0)."
+                    )
+                    colour = st.text_input(
+                        "Colour",
+                        value=editor_state.get("colour", colour),
+                        help="Colour of the door's outer surface."
+                    )
+                
+                if comp_type in ["windows", "skylights"]:
+                    # Shading Coefficient
+                    shading_coefficient = st.number_input(
+                        "Shading Coefficient (SC)",
+                        min_value=0.0,
+                        max_value=1.0,
+                        value=float(editor_state.get("shading_coefficient", 1.0)),
+                        format="%.2f",
+                        help="Shading coefficient for external or internal shading devices (0.0 to 1.0)."
+                    )
             
             # Submit buttons
             col1, col2 = st.columns(2)
@@ -269,40 +345,49 @@ def display_component_tab(comp_type: str):
                 "area": area
             }
             
-            if comp_type in ["walls", "windows", "doors"]:
+            if comp_type in ["walls", "windows", "doors", "roofs", "skylights"]:
                 component_data["elevation"] = elevation
                 component_data["rotation"] = rotation
+                component_data["surface_azimuth"] = surface_azimuth
                 component_data["tilt"] = tilt
             
-            elif comp_type in ["roofs", "skylights"]:
-                component_data["orientation"] = orientation
-                component_data["tilt"] = tilt
+            if comp_type == "floors":
+                component_data["contact_with_ground_percentage"] = contact_with_ground_percentage
             
             if comp_type in ["walls", "roofs", "floors"]:
                 component_data["construction"] = construction
+                component_data["absorptivity"] = absorptivity
+                component_data["emissivity"] = emissivity
+                component_data["colour"] = colour
                 # Get U-value from construction if available
                 if construction in available_items:
                     component_data["u_value"] = available_items[construction].get("u_value", 0.0)
                 else:
                     component_data["u_value"] = 0.0
-            else:
+            else:  # Windows, doors, skylights
                 component_data["fenestration"] = fenestration
                 component_data["parent_component"] = parent_component
                 # Get U-value and other properties from fenestration if available
                 if fenestration in available_items:
                     component_data["u_value"] = available_items[fenestration].get("u_value", 0.0)
                     if comp_type == "doors":
-                        component_data["solar_absorptivity"] = available_items[fenestration].get("solar_absorptivity", 0.7)
+                        component_data["absorptivity"] = absorptivity
+                        component_data["emissivity"] = emissivity
+                        component_data["colour"] = colour
                     else:
                         component_data["shgc"] = available_items[fenestration].get("shgc", 0.7)
                         component_data["visible_transmittance"] = available_items[fenestration].get("visible_transmittance", 0.7)
+                        component_data["shading_coefficient"] = shading_coefficient
                 else:
                     component_data["u_value"] = 0.0
                     if comp_type == "doors":
-                        component_data["solar_absorptivity"] = 0.7
+                        component_data["absorptivity"] = absorptivity
+                        component_data["emissivity"] = emissivity
+                        component_data["colour"] = colour
                     else:
                         component_data["shgc"] = 0.7
                         component_data["visible_transmittance"] = 0.7
+                        component_data["shading_coefficient"] = shading_coefficient
             
             # Handle edit mode
             if is_edit:
@@ -327,29 +412,35 @@ def display_component_tab(comp_type: str):
 def display_wall_window_table(comp_type: str, components: List[Dict[str, Any]]):
     """Display a table of walls or windows with appropriate columns."""
     # Create column headers
-    cols = st.columns([2, 1, 1, 1, 1, 1, 1, 1])
+    cols = st.columns([2, 1, 1, 1, 1, 1, 1] if comp_type == "walls" else [2, 1, 1, 1, 1, 1, 1, 1])
     cols[0].write("**Name**")
     cols[1].write("**U-Value**")
     cols[2].write("**Area (m²)**")
-    cols[3].write("**Elevation**")
-    cols[4].write("**Rotation (°)**")
-    cols[5].write("**Tilt (°)**")
-    cols[6].write("**Edit**")
-    cols[7].write("**Delete**")
+    cols[3].write("**Surface Azimuth (°)**")
+    cols[4].write("**Tilt (°)**")
+    if comp_type == "walls":
+        cols[5].write("**Edit**")
+        cols[6].write("**Delete**")
+    else:  # windows
+        cols[5].write("**SC**")
+        cols[6].write("**Edit**")
+        cols[7].write("**Delete**")
     
     # Display each component
     for idx, comp in enumerate(components):
-        cols = st.columns([2, 1, 1, 1, 1, 1, 1, 1])
+        cols = st.columns([2, 1, 1, 1, 1, 1, 1] if comp_type == "walls" else [2, 1, 1, 1, 1, 1, 1, 1])
         cols[0].write(comp["name"])
         cols[1].write(f"{comp.get('u_value', 0.0):.3f}")
         cols[2].write(f"{comp['area']:.2f}")
-        cols[3].write(comp.get("elevation", "N/A"))
-        cols[4].write(f"{comp.get('rotation', 0.0):.1f}")
-        cols[5].write(f"{comp.get('tilt', 90.0):.1f}")
+        cols[3].write(f"{comp.get('surface_azimuth', 0.0):.1f}")
+        cols[4].write(f"{comp.get('tilt', 90.0):.1f}")
+        if comp_type == "windows":
+            cols[5].write(f"{comp.get('shading_coefficient', 1.0):.2f}")
         
         # Edit button
         edit_key = f"edit_{comp_type}_{comp['name']}_{idx}"
-        with cols[6].container():
+        edit_col = 5 if comp_type == "walls" else 6
+        with cols[edit_col].container():
             if st.button("Edit", key=edit_key):
                 editor_data = {
                     "index": idx,
@@ -361,11 +452,15 @@ def display_wall_window_table(comp_type: str, components: List[Dict[str, Any]]):
                     "is_edit": True
                 }
                 
-                if comp_type in ["walls", "roofs", "floors"]:
+                if comp_type == "walls":
                     editor_data["construction"] = comp.get("construction", "")
-                else:  # Windows, doors, skylights
+                    editor_data["absorptivity"] = comp.get("absorptivity", 0.7)
+                    editor_data["emissivity"] = comp.get("emissivity", 0.9)
+                    editor_data["colour"] = comp.get("colour", "Unknown")
+                else:  # windows
                     editor_data["fenestration"] = comp.get("fenestration", "")
                     editor_data["parent_component"] = comp.get("parent_component", "")
+                    editor_data["shading_coefficient"] = comp.get("shading_coefficient", 1.0)
                 
                 st.session_state[f"{comp_type}_editor"] = editor_data
                 st.session_state[f"{comp_type}_action"] = {"action": "edit", "id": str(uuid.uuid4())}
@@ -373,7 +468,8 @@ def display_wall_window_table(comp_type: str, components: List[Dict[str, Any]]):
         
         # Delete button
         delete_key = f"delete_{comp_type}_{comp['name']}_{idx}"
-        with cols[7].container():
+        delete_col = 6 if comp_type == "walls" else 7
+        with cols[delete_col].container():
             if st.button("Delete", key=delete_key):
                 st.session_state.project_data["components"][comp_type].pop(idx)
                 st.success(f"{comp_type[:-1].capitalize()} '{comp['name']}' deleted!")
@@ -383,42 +479,55 @@ def display_wall_window_table(comp_type: str, components: List[Dict[str, Any]]):
 def display_roof_skylight_table(comp_type: str, components: List[Dict[str, Any]]):
     """Display a table of roofs or skylights with appropriate columns."""
     # Create column headers
-    cols = st.columns([2, 1, 1, 1, 1, 1, 1])
+    cols = st.columns([2, 1, 1, 1, 1, 1, 1] if comp_type == "roofs" else [2, 1, 1, 1, 1, 1, 1, 1])
     cols[0].write("**Name**")
     cols[1].write("**U-Value**")
     cols[2].write("**Area (m²)**")
-    cols[3].write("**Orientation (°)**")
+    cols[3].write("**Surface Azimuth (°)**")
     cols[4].write("**Tilt (°)**")
-    cols[5].write("**Edit**")
-    cols[6].write("**Delete**")
+    if comp_type == "roofs":
+        cols[5].write("**Edit**")
+        cols[6].write("**Delete**")
+    else:  # skylights
+        cols[5].write("**SC**")
+        cols[6].write("**Edit**")
+        cols[7].write("**Delete**")
     
     # Display each component
     for idx, comp in enumerate(components):
-        cols = st.columns([2, 1, 1, 1, 1, 1, 1])
+        cols = st.columns([2, 1, 1, 1, 1, 1, 1] if comp_type == "roofs" else [2, 1, 1, 1, 1, 1, 1, 1])
         cols[0].write(comp["name"])
         cols[1].write(f"{comp.get('u_value', 0.0):.3f}")
         cols[2].write(f"{comp['area']:.2f}")
-        cols[3].write(f"{comp.get('orientation', 0.0):.1f}")
+        cols[3].write(f"{comp.get('surface_azimuth', 0.0):.1f}")
         cols[4].write(f"{comp.get('tilt', 0.0):.1f}")
+        if comp_type == "skylights":
+            cols[5].write(f"{comp.get('shading_coefficient', 1.0):.2f}")
         
         # Edit button
         edit_key = f"edit_{comp_type}_{comp['name']}_{idx}"
-        with cols[5].container():
+        edit_col = 5 if comp_type == "roofs" else 6
+        with cols[edit_col].container():
             if st.button("Edit", key=edit_key):
                 editor_data = {
                     "index": idx,
                     "name": comp["name"],
                     "area": comp["area"],
-                    "orientation": comp.get("orientation", 0.0),
+                    "elevation": comp.get("elevation", ORIENTATION_OPTIONS[0]),
+                    "rotation": comp.get("rotation", 0.0),
                     "tilt": comp.get("tilt", 0.0),
                     "is_edit": True
                 }
                 
-                if comp_type in ["roofs"]:
+                if comp_type == "roofs":
                     editor_data["construction"] = comp.get("construction", "")
+                    editor_data["absorptivity"] = comp.get("absorptivity", 0.7)
+                    editor_data["emissivity"] = comp.get("emissivity", 0.9)
+                    editor_data["colour"] = comp.get("colour", "Unknown")
                 else:  # skylights
                     editor_data["fenestration"] = comp.get("fenestration", "")
                     editor_data["parent_component"] = comp.get("parent_component", "")
+                    editor_data["shading_coefficient"] = comp.get("shading_coefficient", 1.0)
                 
                 st.session_state[f"{comp_type}_editor"] = editor_data
                 st.session_state[f"{comp_type}_action"] = {"action": "edit", "id": str(uuid.uuid4())}
@@ -426,7 +535,8 @@ def display_roof_skylight_table(comp_type: str, components: List[Dict[str, Any]]
         
         # Delete button
         delete_key = f"delete_{comp_type}_{comp['name']}_{idx}"
-        with cols[6].container():
+        delete_col = 6 if comp_type == "roofs" else 7
+        with cols[delete_col].container():
             if st.button("Delete", key=delete_key):
                 st.session_state.project_data["components"][comp_type].pop(idx)
                 st.success(f"{comp_type[:-1].capitalize()} '{comp['name']}' deleted!")
@@ -436,29 +546,35 @@ def display_roof_skylight_table(comp_type: str, components: List[Dict[str, Any]]
 def display_floor_table(comp_type: str, components: List[Dict[str, Any]]):
     """Display a table of floors with appropriate columns."""
     # Create column headers
-    cols = st.columns([2, 1, 1, 1, 1])
+    cols = st.columns([2, 1, 1, 1, 1, 1])
     cols[0].write("**Name**")
     cols[1].write("**U-Value**")
     cols[2].write("**Area (m²)**")
-    cols[3].write("**Edit**")
-    cols[4].write("**Delete**")
+    cols[3].write("**Contact with Ground (%)**")
+    cols[4].write("**Edit**")
+    cols[5].write("**Delete**")
     
     # Display each component
     for idx, comp in enumerate(components):
-        cols = st.columns([2, 1, 1, 1, 1])
+        cols = st.columns([2, 1, 1, 1, 1, 1])
         cols[0].write(comp["name"])
         cols[1].write(f"{comp.get('u_value', 0.0):.3f}")
         cols[2].write(f"{comp['area']:.2f}")
+        cols[3].write(f"{comp.get('contact_with_ground_percentage', 0.0):.1f}")
         
         # Edit button
         edit_key = f"edit_{comp_type}_{comp['name']}_{idx}"
-        with cols[3].container():
+        with cols[4].container():
             if st.button("Edit", key=edit_key):
                 editor_data = {
                     "index": idx,
                     "name": comp["name"],
                     "area": comp["area"],
                     "construction": comp.get("construction", ""),
+                    "contact_with_ground_percentage": comp.get("contact_with_ground_percentage", 0.0),
+                    "absorptivity": comp.get("absorptivity", 0.7),
+                    "emissivity": comp.get("emissivity", 0.9),
+                    "colour": comp.get("colour", "Unknown"),
                     "is_edit": True
                 }
                 
@@ -468,7 +584,7 @@ def display_floor_table(comp_type: str, components: List[Dict[str, Any]]):
         
         # Delete button
         delete_key = f"delete_{comp_type}_{comp['name']}_{idx}"
-        with cols[4].container():
+        with cols[5].container():
             if st.button("Delete", key=delete_key):
                 st.session_state.project_data["components"][comp_type].pop(idx)
                 st.success(f"{comp_type[:-1].capitalize()} '{comp['name']}' deleted!")
@@ -481,26 +597,24 @@ def display_door_table(comp_type: str, components: List[Dict[str, Any]]):
     cols = st.columns([2, 1, 1, 1, 1, 1, 1, 1])
     cols[0].write("**Name**")
     cols[1].write("**U-Value**")
-    cols[2].write("**Solar Abs.**")
-    cols[3].write("**Elevation**")
-    cols[4].write("**Rotation (°)**")
-    cols[5].write("**Tilt (°)**")
-    cols[6].write("**Edit**")
-    cols[7].write("**Delete**")
+    cols[2].write("**Absorptivity**")
+    cols[3].write("**Surface Azimuth (°)**")
+    cols[4].write("**Tilt (°)**")
+    cols[5].write("**Edit**")
+    cols[6].write("**Delete**")
     
     # Display each component
     for idx, comp in enumerate(components):
         cols = st.columns([2, 1, 1, 1, 1, 1, 1, 1])
         cols[0].write(comp["name"])
         cols[1].write(f"{comp.get('u_value', 0.0):.3f}")
-        cols[2].write(f"{comp.get('solar_absorptivity', 0.7):.2f}")
-        cols[3].write(comp.get("elevation", "N/A"))
-        cols[4].write(f"{comp.get('rotation', 0.0):.1f}")
-        cols[5].write(f"{comp.get('tilt', 90.0):.1f}")
+        cols[2].write(f"{comp.get('absorptivity', 0.7):.2f}")
+        cols[3].write(f"{comp.get('surface_azimuth', 0.0):.1f}")
+        cols[4].write(f"{comp.get('tilt', 90.0):.1f}")
         
         # Edit button
         edit_key = f"edit_{comp_type}_{comp['name']}_{idx}"
-        with cols[6].container():
+        with cols[5].container():
             if st.button("Edit", key=edit_key):
                 editor_data = {
                     "index": idx,
@@ -511,6 +625,9 @@ def display_door_table(comp_type: str, components: List[Dict[str, Any]]):
                     "tilt": comp.get("tilt", 90.0),
                     "fenestration": comp.get("fenestration", ""),
                     "parent_component": comp.get("parent_component", ""),
+                    "absorptivity": comp.get("absorptivity", 0.7),
+                    "emissivity": comp.get("emissivity", 0.9),
+                    "colour": comp.get("colour", "Unknown"),
                     "is_edit": True
                 }
                 
@@ -520,7 +637,7 @@ def display_door_table(comp_type: str, components: List[Dict[str, Any]]):
         
         # Delete button
         delete_key = f"delete_{comp_type}_{comp['name']}_{idx}"
-        with cols[7].container():
+        with cols[6].container():
             if st.button("Delete", key=delete_key):
                 st.session_state.project_data["components"][comp_type].pop(idx)
                 st.success(f"{comp_type[:-1].capitalize()} '{comp['name']}' deleted!")
@@ -597,6 +714,25 @@ def get_parent_components(comp_type: str) -> Dict[str, Any]:
     
     return parent_components
 
+def get_material_data(material_name: str) -> Optional[Dict[str, Any]]:
+    """
+    Get material data from session state.
+    
+    Args:
+        material_name: Name of the material
+    
+    Returns:
+        Dict of material properties or None if not found
+    """
+    if "materials" in st.session_state.project_data:
+        if "library" in st.session_state.project_data["materials"]:
+            if material_name in st.session_state.project_data["materials"]["library"]:
+                return st.session_state.project_data["materials"]["library"][material_name]
+        if "project" in st.session_state.project_data["materials"]:
+            if material_name in st.session_state.project_data["materials"]["project"]:
+                return st.session_state.project_data["materials"]["project"][material_name]
+    return None
+
 def display_components_help():
     """
     Display help information for the building components page.
@@ -610,9 +746,11 @@ def display_components_help():
     
     * **Walls, Roofs, Floors**: Opaque components that use constructions from the Construction section.
     * **Windows, Doors, Skylights**: Transparent components that use fenestrations from the Material Library section.
-    * **Orientation**: Direction the component faces (A=North, B=South, C=East, D=West).
+    * **Surface Azimuth**: Direction the component faces, calculated as elevation plus rotation (0° = North, 90° = East, 180° = South, 270° = West).
     * **Tilt**: Angle of the component relative to horizontal (0° = horizontal, 90° = vertical).
     * **Parent Component**: The wall or roof that contains a window, door, or skylight.
+    * **Absorptivity/Emissivity**: Thermal properties of the outer surface material.
+    * **Shading Coefficient (SC)**: Factor for shading devices on windows/skylights (0.0 to 1.0).
     
     **Workflow:**
     
@@ -622,8 +760,8 @@ def display_components_help():
     
     **Tips:**
     
-    * For walls, use the elevation options (A, B, C, D) to easily align with the building orientation.
-    * For roofs and skylights, specify the orientation angle directly.
+    * Use elevation (A, B, C, D) and rotation to set the surface azimuth.
+    * For roofs and skylights, set tilt to 0° for flat surfaces.
     * Ensure the total area of windows and doors doesn't exceed the area of their parent walls.
     * Ensure the total area of skylights doesn't exceed the area of their parent roofs.
-    """)
+    """)