Upload main.py

main.py

@@ -0,0 +1,544 @@
+"""
+HVAC Load Calculator - Main Module
+
+This is the main module for the HVAC Load Calculator application. It serves as the central
+orchestrator for the application, handling navigation between different modules and managing
+the overall application flow.
+
+Developed by: Dr Majed Abuseif, Deakin University
+© 2025
+"""
+
+import streamlit as st
+import logging
+import os
+import sys
+from typing import Dict, List, Any, Optional, Tuple
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
+logger = logging.getLogger(__name__)
+
+# Add the current directory to the path so we can import our modules
+sys.path.append(os.path.dirname(os.path.abspath(__file__)))
+
+# Import modules as they are developed
+from intro import display_intro_page
+from building_information import display_building_info_page
+from climate_data import display_climate_page
+from materials_library import display_materials_page
+from construction import display_construction_page
+from components import display_components_page
+from data.internal_loads import display_internal_loads_page
+from hvac_loads import display_hvac_loads_page
+from building_energy import display_building_energy_page
+from renewable_energy import display_renewable_energy_page
+from embodied_energy import display_embodied_energy_page
+from materials_cost import display_materials_cost_page
+
+class HVACApp:
+    """
+    Main class for the HVAC Load Calculator application.
+    Handles navigation, session state initialization, and module integration.
+    """
+    
+    def __init__(self):
+        """
+        Initialize the HVAC Load Calculator application.
+        Sets up the page configuration and initializes session state if needed.
+        """
+        # Configure the Streamlit page
+        st.set_page_config(
+            page_title="HVAC Load Calculator",
+            page_icon="🌡️",
+            layout="wide",
+            initial_sidebar_state="expanded"
+        )
+        
+        # Initialize session state if it doesn't exist
+        self._initialize_session_state()
+        
+        # Set up the application layout
+        self.setup_layout()
+    
+    def _initialize_session_state(self):
+        """
+        Initialize the session state structure if it doesn't exist.
+        This creates the basic structure for storing all application data.
+        """
+        # Initialize current page if not set
+        if 'current_page' not in st.session_state:
+            st.session_state.current_page = "Intro"
+        
+        # Initialize project data structure if not set
+        if 'project_data' not in st.session_state:
+            st.session_state.project_data = {
+                "project_name": "",
+                "building_info": {
+                    "project_name": "",
+                    "floor_area": 100.0,
+                    "building_height": 3.0,
+                    "indoor_design_temp": 24.0,
+                    "indoor_design_rh": 50.0,
+                    "ventilation_rate": 0.1,
+                    "orientation_angle": 0.0,
+                    "operation_hours": 8,
+                    "building_type": "Office"
+                },
+                "climate_data": {},
+                "materials": {
+                    "library": {},
+                    "project": {}
+                },
+                "fenestrations": {
+                    "library": {},
+                    "project": {}
+                },
+                "constructions": {
+                    "library": {},
+                    "project": {}
+                },
+                "components": {
+                    "walls": [],
+                    "roofs": [],
+                    "floors": [],
+                    "windows": [],
+                    "doors": [],
+                    "skylights": []
+                },
+                "internal_loads": {
+                    "people": [],
+                    "lighting": {},
+                    "equipment": {}
+                },
+                "hvac_loads": {
+                    "cooling": {
+                        "hourly": [],
+                        "peak": 0,
+                        "summary_tables": {},
+                        "charts": {}
+                    },
+                    "heating": {
+                        "hourly": [],
+                        "peak": 0,
+                        "summary_tables": {},
+                        "charts": {}
+                    }
+                },
+                "building_energy": {
+                    "hvac_type": "",
+                    "cop": 0.0,
+                    "energy_consumption": {
+                        "cooling": 0,
+                        "heating": 0,
+                        "lighting": 0,
+                        "equipment": 0,
+                        "total": 0
+                    },
+                    "charts": {}
+                },
+                "renewable_energy": {
+                    "pv_system_size_kw": 0,
+                    "pv_generation_kwh": 0,
+                    "net_energy_kwh": 0,
+                    "zero_energy_status": "",
+                    "charts": {}
+                },
+                "embodied_energy": {
+                    "total_embodied_carbon_kgco2e": 0,
+                    "breakdown_by_component": {},
+                    "charts": {}
+                },
+                "materials_cost": {
+                    "total_cost_usd": 0,
+                    "breakdown_by_component": {},
+                    "charts": {}
+                }
+            }
+        
+        # Initialize UI state variables
+        if 'debug_mode' not in st.session_state:
+            st.session_state.debug_mode = False
+        
+        if 'rerun_pending' not in st.session_state:
+            st.session_state.rerun_pending = False
+    
+    def setup_layout(self):
+        """
+        Set up the main application layout with sidebar navigation and main content area.
+        """
+        # Create the sidebar
+        st.sidebar.title("HVAC Load Calculator")
+        st.sidebar.markdown("---")
+        
+        # Navigation section in sidebar
+        st.sidebar.subheader("Navigation")
+        
+        # Define all available pages
+        pages = [
+            "Intro",
+            "Building Information",
+            "Climate Data",
+            "Material Library",
+            "Construction",
+            "Building Components",
+            "Internal Loads",
+            "HVAC Loads",
+            "Building Energy",
+            "Renewable Energy",
+            "Embodied Energy",
+            "Materials Cost"
+        ]
+        
+        # Create the navigation radio buttons
+        selected_page = st.sidebar.radio(
+            "Go to",
+            pages,
+            index=pages.index(st.session_state.current_page)
+        )
+        
+        # Update the current page if changed
+        if selected_page != st.session_state.current_page:
+            st.session_state.current_page = selected_page
+            # Clear any temporary form states when changing pages
+            for key in list(st.session_state.keys()):
+                if key.endswith("_form_state") or key.endswith("_editor"):
+                    st.session_state.pop(key, None)
+        
+        # Add application info to sidebar
+        st.sidebar.markdown("---")
+        st.sidebar.info(
+            "HVAC Load Calculator v3.0.0\n\n"
+            "Based on ASHRAE CTF/TFM methods\n\n"
+            "Developed by: Dr Majed Abuseif\n\n"
+            "School of Architecture and Built Environment\n\n"
+            "Deakin University\n\n"
+            "© 2025"
+        )
+        
+        # Add help section to sidebar
+        st.sidebar.markdown("### Help")
+        st.sidebar.write("Learn about CTF/TFM methods:")
+        st.sidebar.markdown("[ASHRAE Handbook](https://www.ashrae.org/technical-resources/bookstore/handbook)")
+        
+        # Debug mode toggle (for development)
+        if st.sidebar.checkbox("Debug Mode", value=st.session_state.debug_mode):
+            st.session_state.debug_mode = True
+        else:
+            st.session_state.debug_mode = False
+        
+        # Display the selected page content
+        self.display_page(st.session_state.current_page)
+        
+        # Handle any pending reruns (for form submissions that need to refresh)
+        if st.session_state.rerun_pending:
+            st.session_state.rerun_pending = False
+            st.rerun()
+    
+    def display_page(self, page: str):
+        """
+        Display the content for the selected page by calling the appropriate module function.
+        
+        Args:
+            page: The name of the page to display
+        """
+        if page == "Intro":
+            # Call the implemented intro module
+            display_intro_page()
+        elif page == "Building Information":
+            # Call the implemented building information module
+            display_building_info_page()
+        elif page == "Climate Data":
+            # Call the implemented climate data module
+            display_climate_page()
+        elif page == "Material Library":
+            # Call the implemented material library module
+            display_materials_page()
+        elif page == "Construction":
+            # Call the implemented construction module
+            display_construction_page()
+        elif page == "Building Components":
+            # Call the implemented components module
+            display_components_page()
+        elif page == "Internal Loads":
+            # Call the implemented internal loads module
+            display_internal_loads_page()
+        elif page == "HVAC Loads":
+            # Call the implemented HVAC loads module
+            display_hvac_loads_page()
+        elif page == "Building Energy":
+            # Call the implemented building energy module
+            display_building_energy_page()
+        elif page == "Renewable Energy":
+            # Call the implemented renewable energy module
+            display_renewable_energy_page()
+        elif page == "Embodied Energy":
+            # Call the implemented embodied energy module
+            display_embodied_energy_page()
+        elif page == "Materials Cost":
+            # Call the implemented materials cost module
+            display_materials_cost_page()
+        else:
+            st.error(f"Unknown page: {page}")
+    
+    # Placeholder display methods until actual modules are implemented
+    def _display_intro_placeholder(self):
+        st.info("This is a placeholder for the Intro module. The actual module will be implemented in Stage 2.")
+        st.markdown("""
+        ### About
+        The HVAC Load Calculator is a tool for calculating heating and cooling loads for buildings.
+        
+        ### Features
+        - Building information input
+        - Climate data selection
+        - Material and construction library
+        - Component definition
+        - Internal loads calculation
+        - HVAC load calculation using CTF/TFM methods
+        - Building energy consumption estimation
+        - Renewable energy sizing
+        - Embodied energy calculation
+        - Materials cost estimation
+        
+        ### Project Management
+        """)
+        
+        col1, col2, col3 = st.columns(3)
+        with col1:
+            st.button("Start New Project")
+        with col2:
+            st.file_uploader("Import Project", type=["json"])
+        with col3:
+            st.button("Export Project")
+    
+    def _display_building_info_placeholder(self):
+        st.info("This is a placeholder for the Building Information module. The actual module will be implemented in Stage 3.")
+        
+        with st.form("building_info_form_placeholder"):
+            st.text_input("Project Name", value=st.session_state.project_data["building_info"]["project_name"])
+            st.number_input("Floor Area (square meters)", value=st.session_state.project_data["building_info"]["floor_area"])
+            st.number_input("Building Height (meters)", value=st.session_state.project_data["building_info"]["building_height"])
+            st.number_input("Indoor Design Temperature (°C)", value=st.session_state.project_data["building_info"]["indoor_design_temp"])
+            st.number_input("Indoor Design Relative Humidity (%)", value=st.session_state.project_data["building_info"]["indoor_design_rh"])
+            st.slider("Orientation Angle (°)", min_value=-180, max_value=180, value=int(st.session_state.project_data["building_info"]["orientation_angle"]))
+            st.slider("Operation Hours (hours/day)", min_value=0, max_value=24, value=st.session_state.project_data["building_info"]["operation_hours"])
+            st.selectbox("Building Type", ["Office", "Classroom", "Retail", "Restaurant", "Hotel", "Hospital", "Residential"])
+            
+            st.form_submit_button("Save")
+        
+        st.button("Continue to Climate Data")
+    
+    def _display_climate_data_placeholder(self):
+        st.info("This is a placeholder for the Climate Data module. The actual module will be implemented in Stage 4.")
+        
+        st.file_uploader("Upload EPW File", type=["epw"])
+        
+        st.markdown("### Climate Data Summary")
+        st.markdown("Location: Not selected")
+        st.markdown("Climate Zone: Not available")
+        st.markdown("Design Temperatures: Not available")
+        
+        col1, col2 = st.columns(2)
+        with col1:
+            st.button("Back to Building Information")
+        with col2:
+            st.button("Continue to Material Library")
+    
+    def _display_material_library_placeholder(self):
+        st.info("This is a placeholder for the Material Library module. The actual module will be implemented in Stage 5.")
+        
+        tab1, tab2 = st.tabs(["Materials", "Fenestrations"])
+        
+        with tab1:
+            st.markdown("### Library Materials")
+            st.markdown("Material list will appear here")
+            
+            st.markdown("### Project Materials")
+            st.markdown("User-defined materials will appear here")
+            
+            st.markdown("### Material Editor")
+            st.text_input("Material Name")
+            st.selectbox("Category", ["Finishing Materials", "Structural Materials", "Sub-Structural Materials", "Insulation"])
+            st.number_input("Thermal Conductivity (W/m·K)", min_value=0.01, value=0.1)
+            st.button("Save Material")
+        
+        with tab2:
+            st.markdown("### Library Fenestrations")
+            st.markdown("Fenestration list will appear here")
+            
+            st.markdown("### Project Fenestrations")
+            st.markdown("User-defined fenestrations will appear here")
+            
+            st.markdown("### Fenestration Editor")
+            st.text_input("Fenestration Name")
+            st.number_input("U-Value (W/m²·K)", min_value=0.1, value=2.8)
+            st.number_input("SHGC", min_value=0.0, max_value=1.0, value=0.7)
+            st.button("Save Fenestration")
+        
+        col1, col2 = st.columns(2)
+        with col1:
+            st.button("Back to Climate Data")
+        with col2:
+            st.button("Continue to Construction")
+    
+    def _display_construction_placeholder(self):
+        st.info("This is a placeholder for the Construction module. The actual module will be implemented in Stage 6.")
+        
+        st.markdown("### Library Constructions")
+        st.markdown("Construction list will appear here")
+        
+        st.markdown("### Project Constructions")
+        st.markdown("User-defined constructions will appear here")
+        
+        st.markdown("### Construction Editor")
+        st.text_input("Construction Name")
+        st.selectbox("Component Type", ["Wall", "Roof", "Floor"])
+        st.markdown("Layer editor will appear here")
+        st.button("Save Construction")
+        
+        col1, col2 = st.columns(2)
+        with col1:
+            st.button("Back to Material Library")
+        with col2:
+            st.button("Continue to Building Components")
+    
+    def _display_components_placeholder(self):
+        st.info("This is a placeholder for the Building Components module. The actual module will be implemented in Stage 7.")
+        
+        tabs = st.tabs(["Walls", "Roofs", "Floors", "Windows", "Doors", "Skylights"])
+        
+        for i, tab in enumerate(tabs):
+            with tab:
+                st.markdown(f"### {['Walls', 'Roofs', 'Floors', 'Windows', 'Doors', 'Skylights'][i]}")
+                st.markdown("Component list will appear here")
+                st.button(f"Add New {['Wall', 'Roof', 'Floor', 'Window', 'Door', 'Skylight'][i]}")
+        
+        col1, col2 = st.columns(2)
+        with col1:
+            st.button("Back to Construction")
+        with col2:
+            st.button("Continue to Internal Loads")
+    
+    def _display_internal_loads_placeholder(self):
+        st.info("This is a placeholder for the Internal Loads module. The actual module will be implemented in Stage 8.")
+        
+        tabs = st.tabs(["People", "Lighting", "Equipment"])
+        
+        with tabs[0]:
+            st.number_input("Number of People", min_value=1, value=10)
+            st.selectbox("Activity Level", ["Seated, at Rest", "Light Office Work", "Standing, Light Work"])
+        
+        with tabs[1]:
+            st.number_input("Lighting Power Density (W/m²)", min_value=0.0, value=10.0)
+            st.selectbox("Fixture Type", ["LED", "Fluorescent", "Incandescent"])
+        
+        with tabs[2]:
+            st.number_input("Equipment Power Density (W/m²)", min_value=0.0, value=15.0)
+        
+        col1, col2 = st.columns(2)
+        with col1:
+            st.button("Back to Building Components")
+        with col2:
+            st.button("Continue to HVAC Loads")
+    
+    def _display_hvac_loads_placeholder(self):
+        st.info("This is a placeholder for the HVAC Loads module. The actual module will be implemented in Stage 9.")
+        
+        st.button("Calculate HVAC Loads")
+        
+        st.markdown("### Results")
+        st.markdown("Peak Cooling Load: Not calculated")
+        st.markdown("Peak Heating Load: Not calculated")
+        
+        st.markdown("### Load Breakdown")
+        st.markdown("Charts will appear here")
+        
+        col1, col2 = st.columns(2)
+        with col1:
+            st.button("Back to Internal Loads")
+        with col2:
+            st.button("Continue to Building Energy")
+    
+    def _display_building_energy_placeholder(self):
+        st.info("This is a placeholder for the Building Energy module. The actual module will be implemented in Stage 10.")
+        
+        st.selectbox("HVAC System Type", ["Heat Pump", "Boiler + Chiller", "VRF", "Other"])
+        st.number_input("COP/Efficiency", min_value=0.1, value=3.5)
+        st.button("Calculate Energy Consumption")
+        
+        st.markdown("### Results")
+        st.markdown("Total Annual Energy Consumption: Not calculated")
+        
+        st.markdown("### Energy Breakdown")
+        st.markdown("Charts will appear here")
+        
+        col1, col2 = st.columns(2)
+        with col1:
+            st.button("Back to HVAC Loads")
+        with col2:
+            st.button("Continue to Renewable Energy")
+    
+    def _display_renewable_energy_placeholder(self):
+        st.info("This is a placeholder for the Renewable Energy module. The actual module will be implemented in Stage 11.")
+        
+        st.markdown("### PV System Sizing")
+        st.markdown("Required PV System Size for Net-Zero: Not calculated")
+        st.number_input("Custom PV System Size (kWp)", min_value=0.0, value=10.0)
+        st.button("Calculate PV Generation")
+        
+        st.markdown("### Results")
+        st.markdown("Annual PV Generation: Not calculated")
+        st.markdown("Net Energy Consumption: Not calculated")
+        st.markdown("Zero Energy Status: Not calculated")
+        
+        st.markdown("### Energy Balance")
+        st.markdown("Charts will appear here")
+        
+        col1, col2 = st.columns(2)
+        with col1:
+            st.button("Back to Building Energy")
+        with col2:
+            st.button("Continue to Embodied Energy")
+    
+    def _display_embodied_energy_placeholder(self):
+        st.info("This is a placeholder for the Embodied Energy module. The actual module will be implemented in Stage 12.")
+        
+        st.button("Calculate Embodied Carbon")
+        
+        st.markdown("### Results")
+        st.markdown("Total Embodied Carbon: Not calculated")
+        
+        st.markdown("### Carbon Breakdown")
+        st.markdown("Charts will appear here")
+        
+        col1, col2 = st.columns(2)
+        with col1:
+            st.button("Back to Renewable Energy")
+        with col2:
+            st.button("Continue to Materials Cost")
+    
+    def _display_materials_cost_placeholder(self):
+        st.info("This is a placeholder for the Materials Cost module. The actual module will be implemented in Stage 13.")
+        
+        st.button("Calculate Material Cost")
+        
+        st.markdown("### Results")
+        st.markdown("Total Material Cost: Not calculated")
+        
+        st.markdown("### Cost Breakdown")
+        st.markdown("Charts will appear here")
+        
+        st.button("Back to Embodied Energy")
+
+
+# Main entry point
+if __name__ == "__main__":
+    try:
+        app = HVACApp()
+    except Exception as e:
+        st.error(f"An error occurred: {str(e)}")
+        logger.exception("Application error")
+
+
+sys.path.append(os.path.join(os.path.dirname(__file__), 'data'))
+