mabuseif/HVAC

1# User Guide2 3## Getting Started4 5### Installation61. Ensure you have Python 3.8 or higher installed72. Install the required dependencies:8   ```9   pip install -r requirements.txt10   ```113. Run the application:12   ```13   streamlit run app.py14   ```15 16### Navigation17The application has three main sections accessible from the sidebar:18- **Cooling Load Calculator**: Calculate cooling loads for buildings19- **Heating Load Calculator**: Calculate heating loads for buildings20- **Scenario Comparison**: Compare saved calculation scenarios21 22## Using the Calculators23 24### Building Information251. Select a location from the dropdown262. Enter the indoor design temperature273. Enter the building volume284. Enter the air changes per hour29 30### Adding Components311. **Walls, Roofs, and Floors**:32   - Enter component details (area, U-value, orientation)33   - Click "Add Component"34   - To edit or delete components, use the buttons next to each entry35 362. **Windows and Doors**:37   - Enter details (orientation, area, U-value, glass type, shading)38   - Click "Add Window/Door"39   - To edit or delete windows/doors, use the buttons next to each entry40 413. **Internal Loads**:42   - Enter occupancy information43   - Specify lighting details44   - Add appliances with quantities45   - Add custom heat sources if needed46 47### Calculating Results481. Navigate through all tabs to enter required information492. Click "Calculate" on the final tab503. View the results including:51   - Total load in kW52   - Recommended system size53   - Load breakdown by component54   - Visualizations of heat gains/losses55 56### Saving Scenarios57After calculating results:581. Enter a scenario name and description592. Click "Save Scenario"603. The scenario will be saved for future comparison61 62## Comparing Scenarios63 641. Navigate to the "Scenario Comparison" page652. Select the calculator type (cooling, heating, or all)663. Select at least two scenarios to compare674. Click "Compare Selected Scenarios"685. View the comparison results:69   - Total load comparison70   - Load breakdown comparison71   - Differences between scenarios72   - Interpretation of results736. Download the comparison data as CSV if needed74 75## Tips for Effective Use76 771. **Base Case Analysis**:78   - Create a base case scenario first79   - Make incremental changes for subsequent scenarios80   - Compare to see the impact of each change81 822. **Custom Heat Sources**:83   - Use the custom heat sources feature for equipment not in the predefined list84   - Enter the name and wattage for each custom source85 863. **Component Editing**:87   - You can edit or delete components after adding them88   - This allows for quick adjustments without starting over89 904. **Scenario Management**:91   - Give descriptive names to scenarios92   - Add detailed descriptions to remember what each scenario represents93   - Use the comparison tool to identify the most efficient building configuration94