Update app/components.py

app/components.py

@@ -83,12 +83,15 @@ def initialize_components():
     migrate_component_types()
 
 def migrate_component_types():
-    """Add 'type' key to existing components for backward compatibility."""
+    """Add 'type' key and rename 'tilt' to 'surface_tilt' for existing components for backward compatibility."""
     for comp_type in st.session_state.project_data["components"]:
         for component in st.session_state.project_data["components"][comp_type]:
             if "type" not in component:
                 component["type"] = comp_type
                 logger.info(f"Added type '{comp_type}' to component '{component['name']}'")
+            if comp_type != "floors" and "tilt" in component:
+                component["surface_tilt"] = component.pop("tilt")
+                logger.info(f"Renamed 'tilt' to 'surface_tilt' for component '{component['name']}'")
 
 def display_component_tab(comp_type: str):
     """
@@ -186,13 +189,13 @@ def display_component_tab(comp_type: str):
                 elevation_angle = ORIENTATION_MAP[elevation]
                 surface_azimuth = (elevation_angle + rotation) % 360.0
                 
-                # Tilt
+                # Surface Tilt
                 default_tilt = 0.0 if comp_type in ["roofs", "skylights"] else 90.0
-                tilt = st.number_input(
-                    "Tilt (°)",
+                surface_tilt = st.number_input(
+                    "Surface Tilt (°)",
                     min_value=0.0,
                     max_value=180.0,
-                    value=float(editor_state.get("tilt", default_tilt)),
+                    value=float(editor_state.get("surface_tilt", default_tilt)),
                     step=1.0,
                     format="%.0f",
                     help="Tilt angle of the component relative to horizontal (0° = horizontal, 90° = vertical)."
@@ -323,7 +326,7 @@ def display_component_tab(comp_type: str):
                 component_data["elevation"] = elevation
                 component_data["rotation"] = rotation
                 component_data["surface_azimuth"] = surface_azimuth
-                component_data["tilt"] = tilt
+                component_data["surface_tilt"] = surface_tilt
             
             if comp_type == "floors":
                 component_data["contact_with_ground_percentage"] = contact_with_ground_percentage
@@ -381,7 +384,7 @@ def display_wall_window_table(comp_type: str, components: List[Dict[str, Any]]):
     cols[1].write("**U-Value**")
     cols[2].write("**Area (m²)**")
     cols[3].write("**Surface Azimuth (°)**")
-    cols[4].write("**Tilt (°)**")
+    cols[4].write("**Surface Tilt (°)**")
     if comp_type == "walls":
         cols[5].write("**Edit**")
         cols[6].write("**Delete**")
@@ -397,7 +400,7 @@ def display_wall_window_table(comp_type: str, components: List[Dict[str, Any]]):
         cols[1].write(f"{comp.get('u_value', 0.0):.3f}")
         cols[2].write(f"{comp['area']:.2f}")
         cols[3].write(f"{comp.get('surface_azimuth', 0.0):.0f}")
-        cols[4].write(f"{comp.get('tilt', 90.0):.0f}")
+        cols[4].write(f"{comp.get('surface_tilt', 90.0):.0f}")
         if comp_type == "windows":
             cols[5].write(f"{comp.get('shading_coefficient', 1.0):.2f}")
         
@@ -412,7 +415,7 @@ def display_wall_window_table(comp_type: str, components: List[Dict[str, Any]]):
                     "area": comp["area"],
                     "elevation": comp.get("elevation", ORIENTATION_OPTIONS[0]),
                     "rotation": comp.get("rotation", 0.0),
-                    "tilt": comp.get("tilt", 90.0),
+                    "surface_tilt": comp.get("surface_tilt", 90.0),
                     "is_edit": True
                 }
                 
@@ -445,7 +448,7 @@ def display_roof_skylight_table(comp_type: str, components: List[Dict[str, Any]]
     cols[1].write("**U-Value**")
     cols[2].write("**Area (m²)**")
     cols[3].write("**Surface Azimuth (°)**")
-    cols[4].write("**Tilt (°)**")
+    cols[4].write("**Surface Tilt (°)**")
     if comp_type == "roofs":
         cols[5].write("**Edit**")
         cols[6].write("**Delete**")
@@ -461,7 +464,7 @@ def display_roof_skylight_table(comp_type: str, components: List[Dict[str, Any]]
         cols[1].write(f"{comp.get('u_value', 0.0):.3f}")
         cols[2].write(f"{comp['area']:.2f}")
         cols[3].write(f"{comp.get('surface_azimuth', 0.0):.0f}")
-        cols[4].write(f"{comp.get('tilt', 0.0):.0f}")
+        cols[4].write(f"{comp.get('surface_tilt', 0.0):.0f}")
         if comp_type == "skylights":
             cols[5].write(f"{comp.get('shading_coefficient', 1.0):.2f}")
         
@@ -476,7 +479,7 @@ def display_roof_skylight_table(comp_type: str, components: List[Dict[str, Any]]
                     "area": comp["area"],
                     "elevation": comp.get("elevation", ORIENTATION_OPTIONS[0]),
                     "rotation": comp.get("rotation", 0.0),
-                    "tilt": comp.get("tilt", 0.0),
+                    "surface_tilt": comp.get("surface_tilt", 0.0),
                     "is_edit": True
                 }
                 
@@ -649,7 +652,7 @@ def display_components_help():
     * **Walls, Roofs, Floors**: Opaque components that use constructions from the Construction section.
     * **Windows, Skylights**: Transparent components that use fenestrations from the Material Library section.
     * **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).
+    * **Surface Tilt**: Angle of the component relative to horizontal (0° = horizontal, 90° = vertical).
     * **Parent Component**: The wall or roof that contains a window or skylight.
     * **Shading Coefficient (SC)**: Factor for shading devices on windows/skylights (0.0 to 1.0).
     
@@ -662,7 +665,7 @@ def display_components_help():
     **Tips:**
     
     * Use elevation (A, B, C, D) and rotation to set the surface azimuth.
-    * For roofs and skylights, set tilt to 0° for flat surfaces.
+    * For roofs and skylights, set surface tilt to 0° for flat surfaces.
     * Ensure the total area of windows doesn't exceed the area of their parent walls.
     * Ensure the total area of skylights doesn't exceed the area of their parent roofs.
     """)