How hari-prabhat/sih-area-specific-shelter works
ThermoShelter AI is an early-stage passive-shelter design and thermal-screening platform. The principal Python/Streamlit workflow takes a user’s location and shelter requirements through climate-aware sizing and recommendations, thermal simulation, optional optimization, comparison, and visualization. Material and climate services support the engineering calculations; the README describes local weather and rule-based recommendations, not live APIs or trained AI. The tree also contains a separate React design-studio frontend with its own client-side thermal engine. Unsampled modules are included only where README capabilities and paths support them; their detailed call wiring is not inferred.
Main entry points: feature_studio.py Feature Studios · simulation_service.py Thermal Simulation · App.tsx React Studio · recommender.py Rule Recommender
Components 27
User Interaction
- Streamlit App
app.py - Feature Studios
components/feature_studio.py
Design Exploration
- Design Inputs
components/inputs.py - Recommendations
components/recommendations.py - Rule Recommender
services/recommender.py - Design Optimizer
services/optimize.py - Design Comparison
components/comparison.py
Thermal Engineering
- Material Catalog
services/material_service.py - Local Climate Data
services/climate_service.py - Thermal Simulation
services/simulation_service.py - Thermal Calculations
services/thermal.py - Geometry & Formulas
services/formulas.py - Solar Model
services/solar.py - Ventilation Model
services/ventilation.py - Comfort Metrics
services/comfort.py
Results & Visualization
- Analysis Charts
components/charts.py - Results Dashboard
components/dashboard.py - 3D Shelter View
services/visual3d.py - Result Export
components/export.py
React Studio
- React Studio
thermoshelter-design-studio/src/App.tsx - Design Workflow
thermoshelter-design-studio/src/components/DesignStudio.tsx - Climate Input
thermoshelter-design-studio/src/components/ClimateInput.tsx - Comparative Analysis
thermoshelter-design-studio/src/components/ComparativeAnalysis.tsx - Client Thermal Engine
thermoshelter-design-studio/src/utils/thermalEngine.ts - Client Materials
thermoshelter-design-studio/src/data/materials.ts - Shelter 3D View
thermoshelter-design-studio/src/components/ShelterModel3D.tsx
Other components
- Designer
Connections 28
- Designer → Streamlit App: provides inputs
- Streamlit App → Feature Studios: dispatches views
- Feature Studios → Design Inputs: collects requirements
- Feature Studios → Recommendations: renders guidance
- Feature Studios → Rule Recommender: requests designs
- Rule Recommender → Design Optimizer: optimizes candidates
- Rule Recommender → Thermal Simulation: evaluates designs
- Feature Studios → Thermal Simulation: runs comparisons
- Thermal Simulation → Local Climate Data: reads weather
- Thermal Simulation → Material Catalog: reads properties
- Thermal Simulation → Geometry & Formulas: uses calculations
- Thermal Simulation → Thermal Calculations: models heat transfer
- Thermal Simulation → Solar Model: models solar gain
- Thermal Simulation → Ventilation Model: models ventilation
- Thermal Simulation → Comfort Metrics: assesses comfort
- Feature Studios → Design Comparison: shows baseline comparison
- Feature Studios → Analysis Charts: renders analysis
- Feature Studios → Results Dashboard: presents results
- Feature Studios → 3D Shelter View: builds shelter view
- Feature Studios → Result Export: exports results
- Designer → React Studio: opens studio
- React Studio → Design Workflow: shows design workflow
- React Studio → Climate Input: shows climate controls
- React Studio → Comparative Analysis: shows comparisons
- Design Workflow → Client Thermal Engine: calculates performance
- Comparative Analysis → Client Thermal Engine: calculates comparison
- Client Thermal Engine → Client Materials: uses material data
- React Studio → Shelter 3D View: shows shelter model