area error

app.py

@@ -1,4 +1,1285 @@
-"""
+# ========== CITATION TAB ==========
+        with gr.Tab("📄 About & Credits"):
+            gr.Markdown("""
+            ## About This Tool
+            
+            This application demonstrates how artificial intelligence can convert single 2D photographs into interactive 3D models automatically.
+            
+            ### What Makes This Special
+            
+            **Traditional Approach:**
+            - Need special equipment (3D scanner, multiple cameras)
+            - Requires technical expertise
+            - Time-consuming process
+            - Expensive
+            
+            **This Tool:**
+            - ✅ Works with any photo
+            - ✅ No technical knowledge required
+            - ✅ Results in 20-30 seconds
+            - ✅ Completely free
+            
+            ---
+            
+            ## The Technology
+            
+            ### AI Models Used
+            
+            This tool uses state-of-the-art artificial intelligence models:
+            
+            **GLPN (Global-Local Path Networks)**
+            - Published 2022 by researchers in South Korea
+            - Trained on thousands of indoor scenes
+            - Can estimate depth from a single image
+            - Fast and efficient
+            
+            **DPT (Dense Prediction Transformer)**
+            - Published 2021 by researchers in Germany
+            - Uses advanced transformer architecture
+            - More accurate but slower
+            - Better for complex scenes
+            
+            ### How It Works (Simple)
+            
+            1. **AI looks at photo** → Recognizes objects, patterns, perspective
+            2. **Estimates distance** → Figures out what's close, what's far
+            3. **Creates 3D points** → Places colored dots in 3D space
+            4. **Builds surface** → Connects dots into smooth shape
+            
+            ---
+            
+            ## Academic References
+            
+            If you use this tool for academic work, here are the papers to cite:
+            
+            **For GLPN:**
+            ```
+            Kim et al. (2022). "Global-Local Path Networks for Monocular Depth 
+            Estimation with Vertical CutDepth." IEEE Conference on Computer 
+            Vision and Pattern Recognition (CVPR).
+            ```
+            
+            **For DPT:**
+            ```
+            Ranftl et al. (2021). "Vision Transformers for Dense Prediction." 
+            IEEE International Conference on Computer Vision (ICCV).
+            ```
+            
+            **For 3D Surface Reconstruction:**
+            ```
+            Kazhdan et al. (2006). "Poisson Surface Reconstruction." 
+            Eurographics Symposium on Geometry Processing.
+            ```
+            
+            ---
+            
+            ## Open Source Software
+            
+            This application is built using free, open-source software:
+            
+            **Core Technologies:**
+            - **Transformers** (Hugging Face) - AI model library
+            - **PyTorch** - Machine learning framework
+            - **Open3D** - 3D data processing
+            - **Plotly** - Interactive visualization
+            - **Gradio** - Web interface
+            
+            **Supporting Libraries:**
+            - NumPy - Mathematical computing
+            - SciPy - Scientific computing
+            - Matplotlib - Data visualization
+            - Pillow - Image processing
+            
+            All of these are free and maintained by amazing communities!
+            
+            ---
+            
+            ## Free Software to Use Your Models
+            
+            **Recommended for Beginners:**
+            
+            **Blender** (Most Popular)
+            - Website: blender.org
+            - Free and powerful
+            - Huge community and tutorials
+            - Works on Windows, Mac, Linux
+            
+            **MeshLab** (Simpler)
+            - Website: meshlab.net
+            - Easy to learn
+            - Good for viewing and basic editing
+            - Cross-platform
+            
+            **Online Viewers** (No Installation)
+            - 3dviewer.net
+            - clara.io
+            - Just upload and view in browser
+            
+            ---
+            
+            ## License & Usage
+            
+            **Can I Use This Freely?**
+            - ✅ Yes! Personal use
+            - ✅ Yes! Educational use
+            - ✅ Yes! Research use
+            - ✅ Yes! Commercial projects
+            - ✅ Yes! Share the results
+            
+            **What's Included:**
+            - The application is free to use
+            - All models you create are yours
+            - No hidden fees or restrictions
+            - No registration required
+            
+            **Attribution:**
+            - If publishing research, cite the papers above
+            - Mentioning this tool is appreciated but not required
+            - Share with others who might find it useful!
+            
+            ---
+            
+            ## Privacy & Your Data
+            
+            **Your Photos:**
+            - Processed temporarily for reconstruction
+            - NOT stored permanently
+            - NOT shared with anyone
+            - Deleted after processing
+            
+            **Your 3D Models:**
+            - Generated on-demand
+            - Downloaded to your computer
+            - You have complete control
+            - Keep them private or share them
+            
+            **No Account Needed:**
+            - No registration required
+            - No personal information collected
+            - No tracking or analytics
+            - Your privacy is respected
+            
+            ---
+            
+            ## Acknowledgments
+            
+            **Thanks To:**
+            
+            - **Research Teams** who developed GLPN and DPT models
+            - **Hugging Face** for hosting this application
+            - **Open Source Community** for all the amazing tools
+            - **You** for using and sharing this tool!
+            
+            **Special Recognition:**
+            - Kim et al. (GLPN research team)
+            - Ranftl et al. (DPT research team)
+            - Open3D developers
+            - Gradio team
+            
+            ---
+            
+            ## Limitations & Responsible Use
+            
+            **What This Tool Cannot Do:**
+            - ❌ Recover hidden information (backside of objects)
+            - ❌ Provide precise measurements
+            - ❌ Work with mirrors or transparent objects
+            - ❌ Replace professional surveys
+            
+            **Best Used For:**
+            - ✅ Visualization and exploration
+            - ✅ Learning and education
+            - ✅ Creative projects
+            - ✅ Documentation and memory preservation
+            
+            **Please Use Responsibly:**
+            - Respect privacy when photographing spaces
+            - Don't photograph private property without permission
+            - Consider cultural sensitivities
+            - Use for positive purposes
+            
+            ---
+            
+            ## Frequently Asked Questions
+            
+            **Is this really free?**
+            Yes! Completely free with no hidden costs.
+            
+            **Do I need to create an account?**
+            No account needed. Just upload and use.
+            
+            **Can I use it for my business?**
+            Yes! Commercial use is allowed.
+            
+            **Who owns the 3D models I create?**
+            You do! They're yours to keep and use.
+            
+            **Can I share this tool with others?**
+            Please do! Share the link freely.
+            
+            **Will this always be free?**
+            The plan is to keep it free and accessible.
+            
+            **Can I suggest improvements?**
+            Yes! Use the Community tab on Hugging Face.
+            
+            ---
+            
+            ## Contact & Support
+            
+            **Having Issues?**
+            - Check the "Step-by-Step Guide" tab
+            - Review the "How It Works" tab
+            - Try refreshing the page
+            - Try a different photo
+            
+            **Want to Report a Bug?**
+            - Use the Hugging Face Community tab
+            - Describe what happened
+            - Include what photo type you used
+            
+            **Want to Learn More?**
+            - Explore all the tabs in this application
+            - Try the example projects
+            - Experiment with different photos
+            - Watch Blender tutorials online
+            
+            ---
+            
+            ## Future Development
+            
+            **Potential Future Features:**
+            - Mobile app version
+            - Batch processing (multiple photos at once)
+            - Better color accuracy
+            - Improved mesh quality
+            - More export formats
+            
+            **Your Feedback Matters:**
+            - What features would you like?
+            - What improvements are needed?
+            - What's working well?
+            - Share your ideas!
+            
+            ---
+            
+            ## Educational Resources
+            
+            **Want to Learn More About 3D?**
+            
+            **Blender Tutorials:**
+            - Blender Guru (YouTube)
+            - Blender official tutorials
+            - CG Cookie courses
+            
+            **3D Concepts:**
+            - Khan Academy - 3D graphics basics
+            - Coursera - Computer Graphics courses
+            - YouTube - search "3D modeling basics"
+            
+            **AI & Computer Vision:**
+            - Fast.ai courses (free)
+            - Google AI education
+            - MIT OpenCourseWare
+            
+            ---
+            
+            ## Version History
+            
+            **Version 1.0** (Current)
+            - Initial release
+            - GLPN and DPT models
+            - Interactive 3D viewer
+            - Multiple export formats
+            - Quality metrics
+            
+            **Planned Updates:**
+            - Performance improvements
+            - Additional models
+            - Enhanced visualization
+            - More documentation
+            
+            ---
+            
+            ## Thank You!
+            
+            Thank you for using this tool! We hope it helps you:
+            - Learn about 3D technology
+            - Create interesting projects
+            - Preserve important memories
+            - Explore new possibilities
+            
+            **Please share this tool with others who might find it useful!**
+            
+            ---
+            
+            *Built with ❤️ using open source technology*
+            
+            *Making 3D accessible to everyone*
+            """)
+            gr.Markdown("""
+            ## About This Tool
+            
+            This application demonstrates how artificial intelligence can convert single 2D photographs into interactive 3D models automatically.
+            
+            ### What Makes This Special
+            
+            **Traditional Approach:**
+            - Need special equipment (3D scanner, multiple cameras)
+            - Requires technical expertise
+            - Time-consuming process
+            - Expensive
+            
+            **This Tool:**
+            - ✅ Works with any photo
+            - ✅ No technical knowledge required
+            - ✅ Results in 20-30 seconds
+            - ✅ Completely free
+            
+            ---
+            
+            ## The Technology
+            
+            ### AI Models Used
+            
+            This tool uses state-of-the-art artificial intelligence models:
+            
+            **GLPN (Global-Local Path Networks)**
+            - Published 2022 by researchers in South Korea
+            - Trained on thousands of indoor scenes
+            - Can estimate depth from a single image
+            - Fast and efficient
+            
+            **DPT (Dense Prediction Transformer)**
+            - Published 2021 by researchers in Germany
+            - Uses advanced transformer architecture
+            - More accurate but slower
+            - Better for complex scenes
+            
+            ### How It Works (Simple)
+            
+            1. **AI looks at photo** → Recognizes objects, patterns, perspective
+            2. **Estimates distance** → Figures out what's close, what's far
+            3. **Creates 3D points** → Places colored dots in 3D space
+            4. **Builds surface** → Connects dots into smooth shape
+            
+            ---
+            
+            ## Academic References
+            
+            If you use this tool for academic work, here are the papers to cite:
+            
+            **For GLPN:**
+            ```
+            Kim et al. (2022). "Global-Local Path Networks for Monoc        with gr.Tab("💡 Example Applications"):
+            gr.Markdown("""
+            ## What Can You Do With This Tool?
+            
+            Here are some practical ways people use 3D reconstruction from photos:
+            
+            ---
+            
+            ###
+
+ 1. Education & Learning
+            
+            **For Students:**
+            - Create 3D models for school projects
+            - Visualize concepts in 3D
+            - Learn about spatial relationships
+            - Make presentations more engaging
+            
+            **For Teachers:**
+            - Demonstrate 3D concepts
+            - Create teaching materials
+            - Show real-world examples
+            - Make lessons interactive
+            
+            **Example Project:**
+            *"Historical Site Documentation"*
+            - Photograph local historical building
+            - Create 3D model
+            - Present to class
+            - Discuss architecture and history
+            
+            ---
+            
+            ### 2. Documentation & Preservation
+            
+            **Personal Use:**
+            - Document your home or apartment
+            - Keep memories of places
+            - Record spaces before moving
+            - Create virtual tours
+            
+            **Professional Use:**
+            - Document buildings or sites
+            - Record current conditions
+            - Create visual archives
+            - Support reports with 3D visuals
+            
+            **Example Project:**
+            *"Before Renovation Record"*
+            - Photograph rooms before remodeling
+            - Create 3D documentation
+            - Compare before and after
+            - Remember original layout
+            
+            ---
+            
+            ### 3. Creative Projects & Art
+            
+            **Digital Art:**
+            - Create 3D art from photos
+            - Generate unique perspectives
+            - Combine multiple models
+            - Use in digital compositions
+            
+            **3D Printing:**
+            - Print real-world objects
+            - Create physical models
+            - Make miniatures
+            - Prototype designs
+            
+            **Example Project:**
+            *"Memory Object"*
+            - Photograph meaningful object
+            - Create 3D model
+            - 3D print a copy
+            - Gift to someone special
+            
+            ---
+            
+            ### 4. Research & Analysis
+            
+            **Academic Research:**
+            - Document field sites
+            - Create visual data
+            - Support observations
+            - Share findings visually
+            
+            **Spatial Analysis:**
+            - Understand space relationships
+            - Measure rough proportions
+            - Visualize environments
+            - Present findings
+            
+            **Example Project:**
+            *"Room Layout Study"*
+            - Photograph different room types
+            - Generate 3D models
+            - Compare spatial arrangements
+            - Analyze patterns
+            
+            ---
+            
+            ### 5. Presentations & Communication
+            
+            **Business:**
+            - Visualize spaces for clients
+            - Create facility documentation
+            - Support proposals with 3D views
+            - Make meetings more engaging
+            
+            **Meetings:**
+            - Show locations remotely
+            - Discuss spaces collaboratively
+            - Share 3D perspectives
+            - Improve understanding
+            
+            **Example Project:**
+            *"Office Space Presentation"*
+            - Photograph current office
+            - Show layout in 3D
+            - Discuss rearrangement ideas
+            - Visualize proposals
+            
+            ---
+            
+            ### 6. Personal Projects
+            
+            **Home Projects:**
+            - Plan furniture arrangements
+            - Visualize renovations
+            - Document DIY progress
+            - Share with contractors
+            
+            **Hobbies:**
+            - Model making reference
+            - Gaming environments
+            - Virtual reality content
+            - Photo experiments
+            
+            **Example Project:**
+            *"Furniture Planning"*
+            - Photograph empty room
+            - Create 3D model
+            - Visualize furniture placement
+            - Plan shopping list
+            
+            ---
+            
+            ## Step-by-Step Example Projects
+            
+            ### Project 1: Document Your Living Space (Easy)
+            
+            **Time Required:** 30 minutes
+            
+            **Steps:**
+            1. Clean and organize your room (5 min)
+            2. Take 4 photos from each corner (5 min)
+            3. Upload each photo to this tool (5 min)
+            4. Download all 3D models (2 min)
+            5. View in 3D viewer or Blender (13 min)
+            
+            **What You Learn:**
+            - How to take good 3D photos
+            - Understanding depth maps
+            - Basic 3D file handling
+            
+            **What You Get:**
+            - 3D record of your space
+            - Practice with the tool
+            - Files you can keep forever
+            
+            ---
+            
+            ### Project 2: Create a 3D Memory (Intermediate)
+            
+            **Time Required:** 1-2 hours
+            
+            **Steps:**
+            1. Choose a meaningful object or place
+            2. Photograph from best angle
+            3. Generate 3D model
+            4. Download and open in Blender
+            5. Clean up and refine the model
+            6. Export and share or 3D print
+            
+            **What You Learn:**
+            - Photo composition for 3D
+            - Basic Blender navigation
+            - 3D file editing
+            
+            **What You Get:**
+            - Preserved memory in 3D
+            - New 3D skills
+            - Shareable or printable model
+            
+            ---
+            
+            ### Project 3: Before/After Comparison (Advanced)
+            
+            **Time Required:** Multiple sessions
+            
+            **Steps:**
+            1. Photograph space "before" changes
+            2. Create and save 3D model
+            3. Make changes (rearrange, renovate, etc.)
+            4. Photograph "after"
+            5. Create new 3D model
+            6. Compare side-by-side
+            
+            **What You Learn:**
+            - Temporal documentation
+            - Consistent photography
+            - Comparative analysis
+            
+            **What You Get:**
+            - Visual record of changes
+            - Story to tell
+            - Evidence of transformation
+            
+            ---
+            
+            ## Success Stories & Use Cases
+            
+            ### Education Sector
+            
+            **High School Science Class:**
+            - Students photograph local landmarks
+            - Create 3D models for geology project
+            - Present findings with 3D visualizations
+            - Learn about spatial concepts
+            
+            **University Architecture Course:**
+            - Document existing buildings
+            - Analyze spatial design
+            - Create reference models
+            - Support design proposals
+            
+            ---
+            
+            ### Personal Use
+            
+            **Moving Day Documentation:**
+            - Photograph apartment before leaving
+            - Create 3D memory of first home
+            - Share with family
+            - Return virtually anytime
+            
+            **Home Improvement:**
+            - Document kitchen before renovation
+            - Plan new layout
+            - Show contractors the space
+            - Track progress over time
+            
+            ---
+            
+            ### Professional Use
+            
+            **Real Estate:**
+            - Create 3D views of properties
+            - Send to remote clients
+            - Show spatial relationships
+            - Enhance listings
+            
+            **Interior Design:**
+            - Document client spaces
+            - Visualize existing conditions
+            - Plan interventions
+            - Communicate ideas
+            
+            ---
+            
+            ## Tips from Experienced Users
+            
+            ### Photography Tips:
+            
+            "Take photos during the day with natural light - the results are much better!"
+            
+            "I always include something with known size (like a door) for reference."
+            
+            "Multiple photos from different angles give you more options."
+            
+            ### Processing Tips:
+            
+            "GLPN is usually good enough - save the DPT for special projects."
+            
+            "Download everything right away - don't rely on the browser to keep it."
+            
+            "The point cloud view is great for checking quality before downloading."
+            
+            ### Usage Tips:
+            
+            "Blender has a learning curve but YouTube tutorials help a lot."
+            
+            "For 3D printing, check if it says 'Watertight' before printing."
+            
+            "Keep your original photos - you can always regenerate if needed."
+            
+            ---
+            
+            ## Getting Started Checklist
+            
+            **Before You Begin:**
+            - [ ] Have photos ready (or know what to photograph)
+            - [ ] Check photos are clear and well-lit
+            - [ ] Read the Step-by-Step Guide
+            - [ ] Decide what you want to do with the model
+            
+            **During Processing:**
+            - [ ] Upload photo
+            - [ ] Choose model (GLPN for speed)
+            - [ ] Click Start Reconstruction
+            - [ ] Wait patiently (10-30 seconds)
+            
+            **After Processing:**
+            - [ ] Explore in 3D viewer
+            - [ ] Check quality metrics
+            - [ ] Download ZIP file
+            - [ ] Save to organized folder
+            
+            **Next Steps:**
+            - [ ] Install Blender or MeshLab (optional)
+            - [ ] Open and view your models
+            - [ ] Experiment and have fun!
+            - [ ] Try more photos
+            
+            ---
+            
+            ## Inspiration Gallery
+            
+            **What Others Have Created:**
+            
+            - Childhood bedroom preserved in 3D
+            - Local coffee shop virtual tour
+            - Grandmother's garden memorial
+            - Student archaeology site documentation
+            - Home office layout planning
+            - Miniature 3D printed childhood home
+            - Historical building digital archive
+            - Room escape game environments
+            
+            **Your Turn!**
+            
+            What will you create? The possibilities are endless!
+            """)
+            gr.Markdown("""
+            ## Real-World Applications in Geography & Urban Planning
+            
+            ### 1. Heritage Documentation
+            
+            **Use Case**: Document historic buildings in rapidly changing neighborhoods
+            
+            **Process:**
+            - Photograph building facades at street level
+            - Generate 3D models for digital archive
+            - Monitor condition over time
+            - Support preservation applications
+            
+            **Geographic Value:**
+            - Creates permanent spatial record
+            - Supports heritage impact assessments
+            - Enables virtual access for research
+            - Documents threatened architecture
+            
+            **Best For:**
+            - Historic districts
+            - Vernacular architecture
+            - Cultural landscapes
+            - Disappearing urban forms
+            
+            ---
+            
+            ### 2. Informal Settlement Mapping
+            
+            **Use Case**: Participatory documentation of underserved neighborhoods
+            
+            **Process:**
+            - Community members photograph homes
+            - Generate spatial database
+            - Identify infrastructure needs
+            - Plan upgrading strategies
+            
+            **Geographic Value:**
+            - Bottom-up data collection
+            - Empowers marginalized communities
+            - Reveals spatial patterns
+            - Supports equitable planning
+            
+            **Best For:**
+            - Slum upgrading projects
+            - Land tenure documentation
+            - Infrastructure planning
+            - Social housing programs
+            
+            ---
+            
+            ### 3. Public Space Analysis
+            
+            **Use Case**: Assess quality and design of plazas, parks, streets
+            
+            **Process:**
+            - Document existing conditions
+            - Analyze spatial proportions
+            - Measure enclosure ratios
+            - Evaluate accessibility
+            
+            **Geographic Value:**
+            - Quantifies urban design qualities
+            - Supports design guidelines
+            - Enables comparative analysis
+            - Informs placemaking
+            
+            **Best For:**
+            - Plaza redesign projects
+            - Street improvement plans
+            - Pedestrian zone studies
+            - Active transportation planning
+            
+            ---
+            
+            ### 4. Climate Adaptation Assessment
+            
+            **Use Case**: Analyze built environment for heat mitigation strategies
+            
+            **Process:**
+            - Document building orientations
+            - Map shade patterns
+            - Identify green infrastructure
+            - Assess ventilation corridors
+            
+            **Geographic Value:**
+            - Supports urban heat island analysis
+            - Identifies vulnerable areas
+            - Plans cooling strategies
+            - Integrates with climate models
+            
+            **Best For:**
+            - Heat action plans
+            - Green infrastructure siting
+            - Ventilation studies
+            - Solar access analysis
+            
+            ---
+            
+            ### 5. Neighborhood Change Documentation
+            
+            **Use Case**: Track gentrification and urban transformation
+            
+            **Process:**
+            - Photograph neighborhoods over time
+            - Document building changes
+            - Map new construction
+            - Analyze displacement patterns
+            
+            **Geographic Value:**
+            - Longitudinal spatial data
+            - Supports equity research
+            - Documents displacement
+            - Informs anti-displacement policies
+            
+            **Best For:**
+            - Gentrification studies
+            - Displacement research
+            - Community advocacy
+            - Policy evaluation
+            
+            ---
+            
+            ### 6. Economic Geography Analysis
+            
+            **Use Case**: Study retail corridors and commercial districts
+            
+            **Process:**
+            - Document storefronts
+            - Map business types
+            - Analyze spatial patterns
+            - Track vacancies
+            
+            **Geographic Value:**
+            - Reveals economic vitality
+            - Identifies spatial clusters
+            - Supports business districts
+            - Informs economic development
+            
+            **Best For:**
+            - Main street revitalization
+            - Business improvement districts
+            - Commercial corridor studies
+            - Retail market analysis
+            
+            ---
+            
+            ### 7. Disaster Response & Recovery
+            
+            **Use Case**: Rapid assessment after natural disasters
+            
+            **Process:**
+            - Pre-disaster documentation
+            - Post-event damage assessment
+            - Track reconstruction progress
+            - Support recovery planning
+            
+            **Geographic Value:**
+            - Before/after comparisons
+            - Rapid field assessment
+            - Low-cost documentation
+            - Supports resilience planning
+            
+            **Best For:**
+            - Hurricane damage assessment
+            - Earthquake recovery
+            - Flood impact studies
+            - Emergency planning
+            
+            ---
+            
+            ### 8. Participatory Urban Design
+            
+            **Use Case**: Community-led design processes
+            
+            **Process:**
+            - Residents document favorite places
+            - Identify problem areas
+            - Visualize existing conditions
+            - Co-create design solutions
+            
+            **Geographic Value:**
+            - Inclusive decision-making
+            - Local knowledge capture
+            - Empowers communities
+            - Builds social capital
+            
+            **Best For:**
+            - Community design charrettes
+            - Participatory budgeting
+            - Neighborhood planning
+            - Public engagement
+            
+            ---
+            
+            ## Sample Projects
+            
+            ### Project 1: Historic Downtown Survey
+            
+            **Objective**: Document all buildings in historic district
+            
+            **Methodology:**
+            1. Grid-based photo survey (both sides of street)
+            2. Process 50-100 images
+            3. Generate 3D archive
+            4. Import to GIS with attributes
+            5. Create online map for community
+            
+            **Deliverables:**
+            - 3D model library
+            - Condition assessment database
+            - Interactive web map
+            - Preservation recommendations
+            
+            **Timeline**: 1 week field work, 1 week processing
+            
+            ---
+            
+            ### Project 2: Walkability Assessment
+            
+            **Objective**: Evaluate pedestrian environment quality
+            
+            **Methodology:**
+            1. Photograph street sections every 50m
+            2. Generate 3D models of streetscape
+            3. Measure enclosure ratios
+            4. Assess visual complexity
+            5. Calculate walkability scores
+            
+            **Deliverables:**
+            - Walkability heat maps
+            - Design recommendations
+            - Before/after visualizations
+            - Implementation priorities
+            
+            **Timeline**: 3 days field work, 2 days analysis
+            
+            ---
+            
+            ### Project 3: Affordable Housing Study
+            
+            **Objective**: Document threatened affordable housing
+            
+            **Methodology:**
+            1. Community members photograph buildings
+            2. Train residents in photo techniques
+            3. Generate spatial inventory
+            4. Map displacement risk
+            5. Advocate for protections
+            
+            **Deliverables:**
+            - Community-generated database
+            - Risk assessment maps
+            - Policy recommendations
+            - Advocacy toolkit
+            
+            **Timeline**: 2 weeks participatory mapping
+            
+            ---
+            
+            ## Integration Examples
+            
+            ### Example 1: QGIS Urban Analysis
+            
+            **Workflow:**
+            ```
+            1. Capture: Street-level photos of commercial corridor
+            2. Process: Generate point clouds for each block
+            3. Import: Load into QGIS as point cloud layers
+            4. Georeference: Add GPS coordinates from field notes
+            5. Analyze: Calculate building heights, facade areas
+            6. Visualize: Create 3D scene with basemap
+            7. Export: Web scene for public viewing
+            ```
+            
+            **Result**: Interactive 3D corridor analysis
+            
+            ---
+            
+            ### Example 2: SketchUp Context Model
+            
+            **Workflow:**
+            ```
+            1. Capture: Photos of project site and surroundings
+            2. Process: Generate mesh models
+            3. Import: Load OBJ files into SketchUp
+            4. Arrange: Position in site context
+            5. Design: Add proposed building massing
+            6. Test: Shadow studies, view corridors
+            7. Present: Renderings for community meeting
+            ```
+            
+            **Result**: Context-sensitive design proposals
+            
+            ---
+            
+            ### Example 3: Multi-temporal Change Analysis
+            
+            **Workflow:**
+            ```
+            1. Baseline: Document neighborhood (Year 0)
+            2. Monitor: Re-photograph annually (Years 1-5)
+            3. Process: Generate comparable 3D models
+            4. Compare: Identify changes in built form
+            5. Quantify: Measure new construction, demolitions
+            6. Analyze: Correlate with demographic changes
+            7. Report: Visualize gentrification patterns
+            ```
+            
+            **Result**: Longitudinal urban change study
+            
+            ---
+            
+            ## Research Applications
+            
+            ### Urban Morphology
+            - Building type classification
+            - Form-based analysis
+            - Density calculations
+            - Spatial pattern recognition
+            
+            ### Social Geography
+            - Neighborhood character assessment
+            - Place identity studies
+            - Community asset mapping
+            - Vernacular architecture documentation
+            
+            ### Environmental Geography
+            - Urban heat island analysis
+            - Green infrastructure mapping
+            - Microclimate studies
+            - Sustainable urbanism metrics
+            
+            ### Historical Geography
+            - Temporal change analysis
+            - Heritage landscape documentation
+            - Urban evolution studies
+            - Preservation planning
+            
+            ---
+            
+            ## Cost-Benefit Analysis
+            
+            ### Traditional Methods vs. This Tool
+            
+            **Terrestrial Laser Scanning (TLS):**
+            - Equipment: $30,000 - $100,000
+            - Training: Weeks to months
+            - Processing: Specialized software
+            - **This tool**: Free, smartphone camera, instant results
+            
+            **Professional Photogrammetry:**
+            - Software: $2,000 - $10,000/year
+            - Processing: Hours per model
+            - Expertise: Technical specialist needed
+            - **This tool**: Free, 20 seconds, user-friendly
+            
+            **Drone Survey:**
+            - Equipment: $1,000 - $15,000
+            - License: FAA Part 107 required (USA)
+            - Weather: Limited by conditions
+            - **This tool**: No permits, works at street level
+            
+            ### Return on Investment
+            
+            **For Research:**
+            - Rapid data collection
+            - Low barrier to entry
+            - Enables exploratory studies
+            - Supports grant applications
+            
+            **For Practice:**
+            - Quick site assessments
+            - Client presentations
+            - Community engagement
+            - Design iteration
+            
+            **For Education:**
+            - Hands-on learning
+            - Real-world projects
+            - Accessible technology
+            - Portfolio development
+            
+            ---
+            
+            ## Limitations & When to Use Alternatives
+            
+            ### Use This Tool When:
+            - ✅ Preliminary assessment needed
+            - ✅ Budget is limited
+            - ✅ Rapid documentation required
+            - ✅ Community participation desired
+            - ✅ Teaching/learning application
+            - ✅ Concept visualization needed
+            
+            ### Use Professional Methods When:
+            - ❌ Legal/engineering requirements
+            - ❌ Precise measurements needed
+            - ❌ Large area coverage required
+            - ❌ Absolute accuracy critical
+            - ❌ Official documentation needed
+            - ❌ Structural analysis required
+            
+            ### Complementary Approaches:
+            - Combine with GPS for georeferencing
+            - Use with traditional surveys for scale
+            - Integrate with census data for demographics
+            - Link with property records for attributes
+            - Connect with climate data for analysis
+            """)
+            gr.Markdown("""
+            ## Real-World Applications in Geography & Urban Planning
+            
+            ### 1. Heritage Documentation
+            
+            **Use Case**: Document historic buildings in rapidly changing neighborhoods
+            
+            **Process:**
+            - Photograph building facades at street level
+            - Generate 3D models for digital archive
+            - Monitor condition over time
+            - Support preservation applications
+            
+            **Geographic Value:**
+            - Creates permanent spatial record
+            - Supports heritage impact assessments
+            - Enables virtual access for research
+            - Documents threatened architecture
+            
+            **Best For:**
+            - Historic districts
+            - Vernacular architecture
+            - Cultural landscapes
+            - Disappearing urban forms
+            
+            ---
+            
+            ### 2. Informal Settlement Mapping
+            
+            **Use Case**: Participatory documentation of underserved neighborhoods
+            
+            **Process:**
+            - Community members photograph homes
+            - Generate spatial database
+            - Identify infrastructure needs
+            - Plan upgrading strategies
+            
+            **Geographic Value:**
+            - Bottom-up data collection
+            - Empowers marginalized communities
+            - Reveals spatial patterns
+            - Supports equitable planning
+            
+            **Best For:**
+            - Slum upgrading projects
+            - Land tenure documentation
+            - Infrastructure planning
+            - Social housing programs
+            
+            ---
+            
+            ### 3. Public Space Analysis
+            
+            **Use Case**: Assess quality and design of plazas, parks, streets
+            
+            **Process:**
+            - Document existing conditions
+            - Analyze spatial proportions
+            - Measure enclosure ratios
+            - Evaluate accessibility
+            
+            **Geographic Value:**
+            - Quantifies urban design qualities
+            - Supports design guidelines
+            - Enables comparative analysis
+            - Informs placemaking
+            
+            **Best For:**
+            - Plaza redesign projects
+            - Street improvement plans
+            - Pedestrian zone studies
+            - Active transportation planning
+            
+            ---
+            
+            ### 4. Climate Adaptation Assessment
+            
+            **Use Case**: Analyze built environment for heat mitigation strategies
+            
+            **Process:**
+            - Document building orientations
+            - Map shade patterns
+            - Identify green infrastructure
+            - Assess ventilation corridors
+            
+            **Geographic Value:**
+            - Supports urban heat island analysis
+            - Identifies vulnerable areas
+            - Plans cooling strategies
+            - Integrates with climate models
+            
+            **Best For:**
+            - Heat action plans
+            - Green infrastructure siting
+            - Ventilation studies
+            - Solar access analysis
+            
+            ---
+            
+            ### 5. Neighborhood Change Documentation
+            
+            **Use Case**: Track gentrification and urban transformation
+            
+            **Process:**
+            - Photograph neighborhoods over time
+            - Document building changes
+            - Map new construction
+            - Analyze displacement patterns
+            
+            **Geographic Value:**
+            - Longitudinal spatial data
+            - Supports equity research
+            - Documents displacement
+            - Informs anti-displacement policies
+            
+            **Best For:**
+            - Gentrification studies
+            - Displacement research
+            - Community advocacy
+            - Policy evaluation
+            
+            ---
+            
+            ### 6. Economic Geography Analysis
+            
+            **Use Case**: Study retail corridors and commercial districts
+            
+            **Process:**
+            - Document storefronts
+            - Map business types
+            - Analyze spatial patterns
+            - Track vacancies
+            
+            **Geographic Value:**
+            - Reveals economic vitality
+            - Identifies spatial clusters
+            - Supports business districts
+            - Informs economic development
+            
+            **Best For:**
+            - Main street revitalization
+            - Business improvement districts
+            - Commercial corridor studies
+            - Retail market analysis
+            
+            ---
+            
+            ### 7. Disaster Response & Recovery
+            
+            **Use Case**: Rapid assessment after natural disasters
+            
+            **Process:**
+            - Pre-disaster documentation
+            - Post-event damage assessment
+            - Track reconstruction"""
 Advanced 3D Reconstruction from Single Images
 Academic-grade pipeline with quality metrics, multiple export formats, and interactive visualization
 """
@@ -22,145 +1303,430 @@ import zipfile
 # LITERATURE REVIEW & THEORETICAL BACKGROUND
 # ============================================================================
 THEORY_TEXT = """
-## Theoretical Background
+## How It Works (Simple Explanation)
+
+### What This Tool Does
+
+This application takes a single photograph and creates a 3D model of what's in the picture. It's like going from a flat image to something you can view from different angles.
+
+**The Basic Process:**
+
+1. **Input**: You upload a regular photo (JPG, PNG, etc.)
+2. **Analysis**: AI figures out how far away everything is
+3. **3D Creation**: Converts the flat image into a 3D shape
+4. **Output**: You get an interactive 3D model you can rotate and explore
+
+### Why This Is Useful
+
+**Educational Applications:**
+- Teaching 3D concepts visually
+- Demonstrating spatial relationships
+- Creating interactive presentations
+- Generating content for projects
+
+**Documentation:**
+- Preserving memories in 3D
+- Recording spaces and objects
+- Creating digital archives
+- Sharing spatial information
+
+**Creative Projects:**
+- 3D art from photos
+- Game asset creation
+- Virtual tours
+- Visualization projects
+
+### The Technology Behind It
+
+**Step 1: Depth Estimation**
+- The AI looks at your photo and estimates distance
+- It learned from thousands of example images
+- Creates a "depth map" showing near vs far
+- Like how your brain judges distance with one eye
+
+**Step 2: 3D Point Creation**
+- Each pixel becomes a 3D point in space
+- Points have X, Y, Z coordinates (position)
+- Points keep their RGB color from the photo
+- Result: A cloud of colored dots in 3D space
+
+**Step 3: Surface Creation**
+- Connects the dots to make a smooth surface
+- Like connecting the dots in a puzzle
+- Creates triangles between nearby points
+- Result: A solid 3D mesh you can view
+
+### Two AI Models to Choose From
+
+**GLPN (Recommended)**
+- Faster processing (~2-3 seconds)
+- Good for most photos
+- Best for: Indoor scenes, buildings, objects
+- Think of it as: Quick and reliable
+
+**DPT (High Quality)**
+- Slower but more accurate (~6-10 seconds)
+- Better for complex scenes
+- Best for: Landscapes, detailed scenes
+- Think of it as: Slower but more precise
+
+### What You Get
+
+**Depth Map Visualization:**
+- Side-by-side comparison: original photo vs depth
+- Warmer colors (yellow/red) = closer objects
+- Cooler colors (blue/purple) = farther objects
+- Helps you understand the 3D structure
+
+**Interactive 3D Viewer:**
+- Rotate: Click and drag to spin around
+- Zoom: Scroll to get closer or farther
+- Pan: Right-click and drag to move view
+- Works right in your web browser
+
+**Downloadable Files:**
+- Multiple 3D formats (PLY, OBJ, STL)
+- Can open in 3D software like Blender
+- Can be used for 3D printing
+- Compatible with many programs
+
+### Understanding Quality Metrics
+
+**Point Cloud Size:**
+- More points = more detail
+- Typical: 200,000 - 500,000 points
+- Think of it like: More pixels = clearer image
+
+**Processing Time:**
+- Usually 10-30 seconds total
+- Depends on image size and model choice
+- Faster with GPU, slower with just CPU
+
+**Mesh Quality:**
+- **Vertices**: Corner points of the shape (more = more detail)
+- **Triangles**: Faces of the shape (how it's built)
+- **Watertight**: Whether it's a closed solid (important for 3D printing)
+
+### Limitations (Important to Know)
+
+**What This Can't Do:**
+- ❌ See hidden parts (backside of objects)
+- ❌ Give exact real-world measurements
+- ❌ Work well with mirrors or glass
+- ❌ Reconstruct from blurry photos
+
+**What This Can Do:**
+- ✅ Show spatial relationships
+- ✅ Create viewable 3D models
+- ✅ Work with regular photos
+- ✅ Generate exportable files
+
+### Best Results Come From:
+
+**Good Photos:**
+- Clear, not blurry
+- Well-lit (daytime or bright lighting)
+- Shows depth (not flat scenes)
+- Has texture and detail
+
+**Photo Types:**
+- ✅ Rooms with furniture
+- ✅ Buildings from street level
+- ✅ Objects on tables
+- ✅ Outdoor scenes with structures
+
+**Avoid:**
+- ❌ Pure white walls (no texture)
+- ❌ Mirrors or reflective surfaces
+- ❌ Very dark or overexposed photos
+- ❌ Motion blur or low resolution
 
-### Depth Estimation Models
+### Comparing to Other Methods
+
+**vs. Taking Multiple Photos:**
+- Pro: Only need one photo
+- Con: Less accurate than multiple angles
+- Use when: You only have one image
+
+**vs. 3D Scanner:**
+- Pro: Free, no special equipment
+- Con: Less precise
+- Use when: Quick visualization needed
+
+**vs. Manual 3D Modeling:**
+- Pro: Automatic, much faster
+- Con: Less control over details
+- Use when: Speed is important
+
+### File Formats Explained
+
+**PLY Format:**
+- Most common for 3D points
+- Stores color information
+- Opens in most 3D software
+
+**OBJ Format:**
+- Standard 3D format
+- Very compatible
+- Good for editing
+
+**STL Format:**
+- Used for 3D printing
+- No color, just shape
+- Needed for 3D printers
+
+### Next Steps After Creating Your Model
+
+**View It:**
+- Use the interactive viewer here
+- Download and open in free software (Blender, MeshLab)
+- Share the file with others
+
+**Edit It:**
+- Import into 3D editing software
+- Clean up or modify
+- Add textures or materials
+
+**Use It:**
+- 3D print physical objects
+- Include in presentations
+- Create virtual tours
+- Generate game assets
+
+### Free Software to View Your 3D Models
+
+**Blender** (Most Popular)
+- Free and powerful
+- Works on Windows, Mac, Linux
+- Download: blender.org
+
+**MeshLab** (Simpler)
+- Good for beginners
+- View and edit meshes
+- Download: meshlab.net
+
+**Online Viewers** (No Installation)
+- 3dviewer.net
+- clara.io
+- Just drag and drop your file
+
+### Common Questions
+
+**Q: Why don't measurements match reality?**
+A: The tool creates relative sizes, not absolute. To get real measurements, you'd need to add a scale reference.
+
+**Q: Why is the backside empty?**
+A: The camera can only see what's in front. Hidden surfaces can't be reconstructed.
+
+**Q: Can I use this for 3D printing?**
+A: Yes! Use the STL file. Check if it says "Watertight: ✓" for best results.
+
+**Q: Why does it look different from the photo?**
+A: The tool estimates 3D shape from 2D clues. It's not perfect but gives a good approximation.
+
+**Q: How accurate is it?**
+A: Good for visualization and understanding spatial layout. Not suitable for engineering or precise work.
+"""
+
+### 3D Reconstruction for Urban Geography
+
+**Urban Morphology Analysis:**
+- Digital elevation models (DEMs) from street-level photography
+- Building facade reconstruction for urban texture analysis
+- Volumetric analysis of built environments
+- Spatial pattern recognition in urban landscapes
+
+**Applications in Urban Planning:**
+- Rapid assessment of building conditions
+- Historic preservation documentation
+- Public space analysis
+- Visual impact assessments
+- Community engagement visualizations
+
+### Depth Estimation Technology
 
 **GLPN (Global-Local Path Networks)**
-- Paper: "Global-Local Path Networks for Monocular Depth Estimation with Vertical CutDepth" (Kim et al., 2022)
-- Architecture: Hierarchical transformer with selective feature fusion
-- Key Innovation: Vertical CutDepth module that preserves boundary information
-- Training Dataset: NYU Depth V2 (indoor scenes with RGB-D pairs)
-- Advantages: Better boundary preservation, efficient for real-time applications
-- Network Depth: SegFormer-B4 backbone (~62M parameters)
+- Paper: Kim et al., CVPR 2022
+- Optimized for: Indoor/outdoor architectural scenes
+- Training: NYU Depth V2 (urban indoor environments)
+- Best for: Building interiors, street-level views, architectural details
+- Geographic advantage: Fast processing for field documentation
 
 **DPT (Dense Prediction Transformer)**
-- Paper: "Vision Transformers for Dense Prediction" (Ranftl et al., 2021)
-- Architecture: Vision Transformer (ViT) backbone with convolutional decoder
-- Key Innovation: Multi-scale feature reassembly from transformer tokens
-- Training: Multiple datasets (NYU Depth V2, KITTI, etc.)
-- Advantages: Superior global context understanding, better generalization
-- Network Depth: ViT-Large backbone (~344M parameters)
-
-### 3D Reconstruction Pipeline
-
-Our pipeline follows these theoretical steps:
-
-**1. Monocular Depth Estimation (Ill-posed Problem)**
-   - Challenge: Infinite 3D scenes can project to the same 2D image
-   - Solution: Deep learning provides probabilistic solution learned from data
-   - Limitation: Scale ambiguity - absolute depth cannot be determined
-   - Output: Relative depth map (closer vs farther, not actual distances)
-
-**2. Point Cloud Generation (Back-projection)**
-   - Uses pinhole camera model: X = (u - cx) × Z / fx, Y = (v - cy) × Z / fy
-   - Where: (u,v) = pixel coordinates, (cx,cy) = principal point, fx,fy = focal length, Z = depth
-   - Assumption: Focal length = 500 pixels (reasonable for typical cameras)
-   - Result: 3D point (X,Y,Z) for each pixel with RGB color
-   - Coordinate system: Right-handed (X=right, Y=down, Z=forward)
-
-**3. Statistical Outlier Removal**
-   - Method: For each point, compute distance to k nearest neighbors
-   - Threshold: Remove points where mean distance > μ + σ×std_ratio
-   - Parameters used: k=20 neighbors, std_ratio=2.0
-   - Purpose: Remove depth estimation errors and noise
-   - Typical removal: 5-15% of points
-
-**4. Normal Estimation**
-   - Method: Principal Component Analysis (PCA) on local neighborhoods
-   - Search: Hybrid (radius=0.1 OR max 30 neighbors)
-   - Orientation: Align normals toward viewpoint (camera)
-   - Purpose: Required for surface reconstruction
-   - Result: Surface orientation vector for each point
-
-**5. Poisson Surface Reconstruction**
-   - Paper: Kazhdan et al., "Poisson Surface Reconstruction" (2006)
-   - Mathematical basis: Solves Poisson equation ∇²χ = ∇·V
-     - V = vector field constructed from oriented normals
-     - χ = indicator function (1 inside surface, 0 outside)
-     - Surface = isosurface where χ = 0.5
-   - Implementation: Octree-based (depth=10 = 1024³ grid resolution)
-   - Advantages: Creates watertight (closed) meshes, smooth surfaces
-   - Characteristics: May add extra geometry to close surface
-   - Output: Triangulated mesh with vertices and faces
-
-**6. Mesh Post-processing**
-   - Rotation: 180° around X-axis (flip upside-down to correct orientation)
-   - Normal computation: Per-vertex normals for smooth shading
-   - Density filtering: Remove low-density vertices (bottom 1% percentile)
-
-### Quality Metrics Explained
-
-**Manifold Properties:**
-- **Edge Manifold**: Each edge shared by exactly 2 faces (no T-junctions)
-- **Vertex Manifold**: Neighborhood of each vertex is topologically equivalent to disk
-- Importance: Non-manifold geometry causes issues in 3D printing and simulation
-
-**Watertight (2-Manifold):**
-- Definition: Closed surface with no boundaries or holes
-- Topological: Can distinguish inside from outside
-- Practical: Required for 3D printing, volume calculations
-
-**Geometric Properties:**
-- **Surface Area**: Total area of all triangular faces (arbitrary units)
-- **Volume**: Enclosed volume, only valid if watertight (arbitrary units³)
-- **Euler Characteristic**: χ = V - E + F (V=vertices, E=edges, F=faces)
-  - For closed surface: χ = 2 - 2g (g = genus/number of holes)
-  - Sphere: χ = 2, Torus: χ = 0
-
-### Limitations & Theoretical Constraints
-
-**Inherent to Monocular Depth:**
-1. **Scale Ambiguity**: Cannot determine absolute scale from single image
-2. **Occlusions**: Hidden surfaces cannot be reconstructed (single viewpoint)
-3. **Texture Dependence**: Homogeneous regions have uncertain depth
-4. **Domain Gap**: Models trained on indoor data struggle with outdoor scenes
-
-**Reconstruction Artifacts:**
-1. **Poisson smoothing**: May blur fine geometric details
-2. **Surface completion**: Adds geometry to create closed surface
-3. **Color interpolation**: Vertex colors are approximate
-4. **Topology changes**: May connect separate objects
-
-**Computational Constraints:**
-1. **Memory**: Large images require more RAM/VRAM
-2. **Processing time**: Scales with image size and model complexity
-3. **Single-threaded Poisson**: Limited parallelization in our implementation
-
-### Comparison with Alternative Methods
-
-**Multi-view Stereo (MVS):**
-- Pro: More accurate, resolves scale ambiguity
-- Con: Requires multiple images from different viewpoints
-- Use case: When you can capture multiple photos
-
-**Structure from Motion (SfM):**
-- Pro: Recovers camera poses and 3D structure
-- Con: Requires video or image sequence with overlap
-- Use case: 3D scanning from video
-
-**LiDAR/Depth Sensors:**
-- Pro: Direct depth measurement, accurate scale
-- Con: Expensive hardware, limited to available sensors
-- Use case: When hardware is available (e.g., iPhone Pro)
-
-**Neural Radiance Fields (NeRF):**
-- Pro: Novel view synthesis, high quality
-- Con: Requires many images, long training time
-- Use case: Static scene reconstruction with many views
-
-**Gaussian Splatting:**
-- Pro: Real-time rendering, high quality
-- Con: Requires multiple views, complex pipeline
-- Use case: Real-time applications with capture rig
-
-### Future Directions in Research
-
-1. **Self-supervised Learning**: Training without ground truth depth
-2. **Diffusion Models**: Probabilistic depth with uncertainty estimation
-3. **Semantic Integration**: Object-aware reconstruction
-4. **Multi-modal Fusion**: Combining depth, semantics, and geometry
-5. **Real-time Performance**: Optimization for mobile and edge devices
+- Paper: Ranftl et al., ICCV 2021
+- Optimized for: Complex urban scenes
+- Training: Multiple datasets (urban and natural environments)
+- Best for: Wide-area urban landscapes, complex built environments
+- Geographic advantage: Superior accuracy for planning-grade documentation
+
+### Spatial Data Pipeline
+
+Our reconstruction pipeline generates geospatially-relevant data:
+
+**1. Monocular Depth Estimation**
+   - Challenge: Extracting 3D spatial information from 2D photographs
+   - Application: Similar to photogrammetry but from single images
+   - Output: Relative depth maps for spatial analysis
+   - Use case: Quick field assessment without specialized equipment
+
+**2. Point Cloud Generation (Spatial Coordinates)**
+   - Creates 3D coordinate system (X, Y, Z) from pixels
+   - Each point: Geographic location + RGB color information
+   - Compatible with: GIS software, CAD tools, spatial databases
+   - Use case: Integration with existing urban datasets
+
+**3. 3D Mesh Generation (Surface Models)**
+   - Creates continuous surface from discrete points
+   - Similar to: Digital terrain models (DTMs) for buildings
+   - Output formats: Compatible with ArcGIS, QGIS, SketchUp
+   - Use case: 3D city models, urban visualization
+
+### Spatial Quality Metrics
+
+**For Urban Planning Applications:**
+
+- **Point Cloud Density**: 290K+ points = high spatial resolution
+- **Geometric Accuracy**: Manifold checks ensure valid topology
+- **Surface Continuity**: Watertight meshes = complete volume calculations
+- **Data Fidelity**: Triangle count indicates level of detail
+
+**Limitations for Geographic Applications:**
+
+1. **Scale Ambiguity**: Requires ground control points for absolute measurements
+2. **Single Viewpoint**: Cannot capture occluded facades or hidden spaces
+3. **No Georeferencing**: Outputs in local coordinates, not global (lat/lon)
+4. **Weather Dependent**: Best results with clear, well-lit conditions
+
+### Comparison with Traditional Geospatial Methods
+
+**vs. Terrestrial Laser Scanning (TLS):**
+- Pro: Much cheaper, faster, more accessible
+- Con: Lower accuracy, no absolute scale
+- Use case: Preliminary surveys, community documentation
+
+**vs. Photogrammetry (Structure-from-Motion):**
+- Pro: Works with single image, faster processing
+- Con: Less accurate, cannot resolve scale
+- Use case: Quick assessments, emergency documentation
+
+**vs. Aerial/Drone Imagery:**
+- Pro: Works at street level, captures facades
+- Con: Limited coverage area, ground-level perspective only
+- Use case: Pedestrian-scale analysis, building details
+
+**vs. LiDAR:**
+- Pro: Much lower cost, consumer cameras sufficient
+- Con: Lower precision, no absolute measurements
+- Use case: Educational purposes, preliminary studies
+
+### Urban Planning Applications
+
+**1. Heritage & Cultural Documentation**
+   - Document historic buildings before renovation
+   - Create virtual archives of cultural sites
+   - Community participation through simple photography
+   - Low-cost alternative to professional surveys
+
+**2. Urban Design Visualization**
+   - Visualize existing conditions in 3D
+   - Communicate proposals to stakeholders
+   - Analyze shadow impacts and sightlines
+   - Virtual walkthroughs for community feedback
+
+**3. Housing & Building Assessment**
+   - Rapid condition surveys
+   - Informal settlement documentation
+   - Building envelope analysis
+   - Slum upgrading planning
+
+**4. Public Space Analysis**
+   - Document plazas, parks, streetscapes
+   - Analyze spatial enclosure
+   - Assess accessibility features
+   - Before/after comparisons for interventions
+
+**5. Participatory Planning**
+   - Enable community members to document their neighborhoods
+   - Low barrier to entry (smartphone photos)
+   - Inclusive data collection
+   - Bottom-up spatial data generation
+
+**6. Disaster Response & Resilience**
+   - Rapid damage assessment
+   - Pre-disaster documentation
+   - Emergency shelter planning
+   - Recovery monitoring
+
+### Integration with GIS
+
+**Workflow for Urban Planners:**
+
+1. **Capture**: Photograph urban scenes with standard camera
+2. **Process**: Generate 3D model using this tool
+3. **Export**: Download PLY/OBJ files
+4. **Import**: Load into QGIS, ArcGIS Pro, or SketchUp
+5. **Georeference**: Add ground control points for absolute positioning
+6. **Analyze**: Perform spatial analysis with other urban datasets
+7. **Visualize**: Create 3D city models or planning scenarios
+
+**Compatible Software:**
+- **QGIS**: Import point clouds for 3D visualization
+- **ArcGIS Pro**: Integrate with urban datasets
+- **SketchUp**: Building modeling and visualization
+- **CloudCompare**: Point cloud analysis
+- **MeshLab**: Mesh processing and measurements
+
+### Research Applications in Geography
+
+**Urban Morphology Studies:**
+- Building height-to-width ratios
+- Street canyon analysis
+- Urban density measurements
+- Facade complexity metrics
+
+**Social Geography:**
+- Document vernacular architecture
+- Study neighborhood characteristics
+- Analyze gentrification patterns
+- Community asset mapping
+
+**Environmental Geography:**
+- Urban heat island analysis (surface geometry)
+- Wind flow modeling (building arrangements)
+- Green space visibility studies
+- Urban ecology habitat assessment
+
+**Historical Geography:**
+- Track urban change over time
+- Document disappearing landscapes
+- Preserve architectural heritage
+- Study urban development patterns
+
+### Limitations for Professional Practice
+
+**Not Suitable For:**
+- ❌ Legal surveys or cadastral mapping
+- ❌ Engineering-grade measurements
+- ❌ Official building permits
+- ❌ Structural analysis
+
+**Appropriate For:**
+- ✅ Preliminary assessments
+- ✅ Educational purposes
+- ✅ Community engagement
+- ✅ Concept visualization
+- ✅ Research documentation
+- ✅ Public outreach
+
+### Future Directions in Urban Geospatial Technology
+
+1. **Multi-temporal Analysis**: Track urban change with time-series images
+2. **Semantic Segmentation**: Automatic identification of urban features
+3. **Scale Recovery**: Integration with GPS/mapping data for absolute scale
+4. **Mobile Integration**: Real-time reconstruction on smartphones
+5. **Collaborative Mapping**: Community-contributed 3D city models
+6. **Climate Adaptation**: Shadow analysis, ventilation studies
+7. **Equity Mapping**: Document underrepresented neighborhoods
 """
 
 # ============================================================================
@@ -386,12 +1952,43 @@ def process_image(image, model_choice="GLPN (Recommended)", visualization_type="
             'is_watertight': mesh.is_watertight(),
         }
         
-        # Compute surface area safely
+        # Compute surface area safely with multiple methods
+        surface_area_computed = False
         try:
             surface_area = mesh.get_surface_area()
-            metrics['surface_area'] = float(surface_area) if surface_area > 0 else "Unable to compute"
+            print(f"Surface area (Open3D method): {surface_area}")
+            if surface_area > 0:
+                metrics['surface_area'] = float(surface_area)
+                surface_area_computed = True
+            else:
+                print("Open3D returned 0, trying manual calculation...")
         except Exception as e:
-            print(f"Could not compute surface area: {e}")
+            print(f"Open3D surface area failed: {e}")
+        
+        # Fallback: Manual triangle area calculation
+        if not surface_area_computed:
+            try:
+                vertices = np.asarray(mesh.vertices)
+                triangles = np.asarray(mesh.triangles)
+                
+                # Get vertices for each triangle
+                v0 = vertices[triangles[:, 0]]
+                v1 = vertices[triangles[:, 1]]
+                v2 = vertices[triangles[:, 2]]
+                
+                # Calculate area using cross product
+                cross = np.cross(v1 - v0, v2 - v0)
+                areas = 0.5 * np.linalg.norm(cross, axis=1)
+                total_area = np.sum(areas)
+                
+                print(f"Surface area (manual calculation): {total_area}")
+                metrics['surface_area'] = float(total_area)
+                surface_area_computed = True
+            except Exception as e:
+                print(f"Manual surface area calculation failed: {e}")
+                metrics['surface_area'] = "Unable to compute"
+        
+        if not surface_area_computed:
             metrics['surface_area'] = "Unable to compute"
         
         # Compute volume only if watertight
@@ -406,7 +2003,7 @@ def process_image(image, model_choice="GLPN (Recommended)", visualization_type="
             metrics['volume'] = None
         
         print("Metrics computed!")
-        print(f"Surface area: {metrics['surface_area']}")
+        print(f"Final surface area: {metrics['surface_area']}")
         print(f"Edge manifold: {metrics['is_edge_manifold']}")
         print(f"Watertight: {metrics['is_watertight']}")
         
@@ -514,6 +2111,8 @@ def process_image(image, model_choice="GLPN (Recommended)", visualization_type="
         print("Files exported!")
         
         # Create metrics report
+        assessment = _generate_quality_assessment(metrics)
+        
         report = f"""
 ## Reconstruction Complete! ✅
 
@@ -538,7 +2137,7 @@ def process_image(image, model_choice="GLPN (Recommended)", visualization_type="
 - **Volume**: {f"{metrics['volume']:.2f}" if metrics.get('volume') else 'N/A (not watertight)'}
 
 ### Quality Assessment
-{_generate_quality_assessment(metrics)}
+{assessment}
 
 ### Files Exported
 - Point Cloud: PLY format
@@ -564,16 +2163,17 @@ def process_image(image, model_choice="GLPN (Recommended)", visualization_type="
 with gr.Blocks(title="Advanced 3D Reconstruction", theme=gr.themes.Soft()) as demo:
     
     gr.Markdown("""
-    # 🏗️ Advanced 3D Reconstruction from Single Images
+    # 🏗️ 3D Reconstruction from Single Images
+    
+    **Transform any photograph into an interactive 3D model**
     
-    **Academic-grade pipeline for monocular depth estimation and 3D surface reconstruction**
+    Upload a photo to automatically generate:
+    - **Depth maps** showing distance from camera
+    - **3D point clouds** with spatial coordinates
+    - **3D meshes** that can be viewed and exported
+    - **Interactive visualization** you can rotate and explore
     
-    Upload an image to generate:
-    - High-quality depth maps
-    - Colored 3D point clouds
-    - Reconstructed mesh surfaces
-    - Comprehensive quality metrics
-    - Multiple export formats (PLY, OBJ, STL)
+    No special equipment needed - works with any regular photograph!
     """)
     
     with gr.Tabs():
@@ -680,7 +2280,381 @@ with gr.Blocks(title="Advanced 3D Reconstruction", theme=gr.themes.Soft()) as de
             """)
         
         # ========== USAGE GUIDE TAB ==========
-        with gr.Tab("📖 Usage Guide"):
+        with gr.Tab("📖 Step-by-Step Guide"):
+            gr.Markdown("""
+            ## How to Use This Application
+            
+            ### Quick Start (3 Simple Steps)
+            
+            1. **Upload a Photo** → Click the upload area
+            2. **Click "Start Reconstruction"** → Wait 20-30 seconds
+            3. **Explore Your 3D Model** → Rotate, zoom, download
+
+            
+            ---
+            
+            ### Detailed Instructions
+            
+            #### Step 1: Choose Your Photo
+            
+            **What makes a good photo:**
+            - ✅ Clear and in focus
+            - ✅ Good lighting (daytime or bright indoors)
+            - ✅ Shows some depth (not a flat wall)
+            - ✅ Has details and texture
+            
+            **Examples of good photos:**
+            - A room with furniture
+            - A building from the street
+            - A table with objects on it
+            - An outdoor scene with trees and structures
+            
+            **Photos to avoid:**
+            - ❌ Very blurry or dark
+            - ❌ Just a blank wall
+            - ❌ Mirrors or shiny surfaces
+            - ❌ Extreme close-ups
+            
+            ---
+            
+            #### Step 2: Upload Your Image
+            
+            1. Click on the **"Upload Image"** box
+            2. Select a JPG, PNG, or BMP file from your computer
+            3. Wait for it to appear in the box
+            4. You should see a preview of your photo
+            
+            **Tip**: Photos between 500-2000 pixels wide work best
+            
+            ---
+            
+            #### Step 3: Choose Settings (Optional)
+            
+            **Model Selection:**
+            
+            - **GLPN (Recommended)** 
+              - Faster (2-3 seconds)
+              - Good for most photos
+              - Choose this if unsure
+            
+            - **DPT (High Quality)**
+              - Slower (6-10 seconds)
+              - Better quality
+              - Choose for important projects
+            
+            **Visualization Type:**
+            
+            - **Mesh** (default) - Smooth solid surface
+            - **Point Cloud** - Individual colored dots
+            - **Both** - See both representations
+            
+            ---
+            
+            #### Step 4: Generate 3D Model
+            
+            1. Click the big **"🚀 Start Reconstruction"** button
+            2. Wait while it processes (watch the status)
+            3. Processing typically takes 10-30 seconds
+            
+            **What's happening:**
+            - Analyzing your photo for depth
+            - Creating 3D points in space
+            - Building a surface mesh
+            - Generating visualization
+            
+            ---
+            
+            #### Step 5: View Your Results
+            
+            **You'll see four outputs:**
+            
+            **1. Depth Map Comparison**
+            - Left side: Your original photo
+            - Right side: Colored depth map
+              - Yellow/Red = Close to camera
+              - Blue/Purple = Far from camera
+            
+            **2. Interactive 3D Viewer**
+            - **Rotate**: Click and drag left/right
+            - **Zoom**: Use mouse wheel
+            - **Pan**: Right-click and drag
+            - **Reset**: Double-click anywhere
+            
+            **3. Quality Report**
+            - Processing time
+            - Number of 3D points
+            - Mesh statistics
+            - Quality assessment
+            
+            **4. Download Files (ZIP)**
+            - Contains all 3D file formats
+            - Quality metrics in JSON
+            
+            ---
+            
+            ### Understanding Your Results
+            
+            #### The Depth Map
+            
+            This shows how far everything is from the camera:
+            - **Warmer colors** (yellow, orange, red) = closer objects
+            - **Cooler colors** (blue, purple) = farther objects
+            - It's like a heat map for distance!
+            
+            #### The 3D Viewer
+            
+            You can explore your model from any angle:
+            - Spin it around to see different sides
+            - Zoom in to see details
+            - Zoom out to see the whole scene
+            - It's like holding the object in your hands
+            
+            #### Quality Metrics Explained
+            
+            **Processing Time:**
+            - How long it took to create the model
+            - Typically 10-30 seconds
+            - Longer for larger images or DPT model
+            
+            **Point Count:**
+            - How many 3D points were created
+            - More points = more detail
+            - Typical range: 200,000 - 500,000 points
+            
+            **Mesh Quality:**
+            - **Vertices**: Number of corner points
+            - **Triangles**: How many faces the shape has
+            - **Watertight**: Whether it's a closed solid
+              - ✓ = Good for 3D printing
+              - ✗ = Has some openings (still usable)
+            
+            ---
+            
+            ### Downloading Your 3D Model
+            
+            #### What's in the ZIP File?
+            
+            When you download, you get 5 files:
+            
+            1. **point_cloud.ply** - The colored 3D points
+            2. **mesh.ply** - The solid surface (with color)
+            3. **mesh.obj** - Standard 3D format (most compatible)
+            4. **mesh.stl** - For 3D printing (no color)
+            5. **metrics.json** - Statistics about the model
+            
+            #### Opening Your Files
+            
+            **Free Software Options:**
+            
+            **Blender** (Recommended for most users)
+            - Download: blender.org
+            - File → Import → Wavefront (.obj)
+            - Full featured 3D software
+            
+            **MeshLab** (Simpler alternative)
+            - Download: meshlab.net
+            - Just drag and drop files
+            - Good for viewing and basic editing
+            
+            **Online Viewers** (No installation needed)
+            - Visit: 3dviewer.net
+            - Drag your OBJ or PLY file onto the page
+            - View immediately in your browser
+            
+            ---
+  
+            
+            ### Troubleshooting Common Issues
+            
+            #### Problem: "No output appears"
+            **Solutions:**
+            - Refresh the page and try again
+            - Try a smaller image (under 2000px)
+            - Make sure image uploaded correctly
+            - Check internet connection
+            
+            #### Problem: "Depth map looks strange"
+            **Causes:**
+            - Photo has mirrors or glass (creates confusion)
+            - Photo is too dark or overexposed
+            - Subject is too uniform (blank wall)
+            
+            **Solutions:**
+            - Try a different photo
+            - Use a photo with more texture and depth
+            - Ensure good lighting
+            
+            #### Problem: "3D model has holes"
+            **This is normal!**
+            - The camera can only see one side
+            - Hidden surfaces can't be reconstructed
+            - This is expected behavior
+            - The model is still usable
+            
+            #### Problem: "Processing is slow"
+            **Normal behavior:**
+            - First time using DPT: Takes longer (downloading model)
+            - Large images: Take more time
+            - Typical range: 10-60 seconds
+            
+            #### Problem: "Colors look wrong"
+            **Explanation:**
+            - Mesh colors are interpolated from photos
+            - Not exact but approximate
+            - Point cloud colors are more accurate
+            - This is a technical limitation
+            
+            ---
+            
+            ### Tips for Best Results
+            
+            #### Photography Tips:
+            
+            **Lighting:**
+            - Use natural daylight when possible
+            - Avoid harsh shadows
+            - Indoor: Turn on room lights
+            - Outdoor: Overcast days work well
+            
+            **Camera Position:**
+            - Hold camera level (not tilted)
+            - Step back to include whole scene
+            - Don't get too close
+            - Include some context around main subject
+            
+            **Subject Selection:**
+            - Choose scenes with depth
+            - Include objects at different distances
+            - Look for texture and detail
+            - Avoid very flat scenes
+            
+            #### What Works Well:
+            
+            - ✅ Living rooms with furniture
+            - ✅ Outdoor buildings
+            - ✅ Desks with items on them
+            - ✅ Kitchen scenes
+            - ✅ Gardens with plants
+            - ✅ Street scenes
+            
+            #### What Doesn't Work:
+            
+            - ❌ Blank white walls
+            - ❌ Mirrors and reflective surfaces
+            - ❌ Very dark rooms
+            - ❌ Photos through windows
+            - ❌ Extreme close-ups
+            - ❌ Moving subjects (blur)
+            
+            ---
+            
+            ### Learning More
+            
+            **If you want to go deeper:**
+            
+            - Check the "How It Works" tab for technical details
+            - Learn Blender for 3D editing (blender.org/tutorials)
+            - Experiment with different photo types
+            - Try both models and compare results
+            
+            **Remember**: This is a learning tool. Have fun, experiment, and don't worry about making mistakes!
+            """)
+            gr.Markdown("""
+            
+            ## Tips for Urban Documentation
+            
+            ### ✅ DO:
+            - Photograph during daytime with good natural light
+            - Include full height of buildings when possible
+            - Capture street-level perspective (pedestrian view)
+            - Document both built form and public space
+            - Take photos perpendicular to main facades
+            - Include contextual elements (trees, furniture, people)
+            - Maintain consistent camera height when documenting corridors
+            
+            ### ❌ AVOID:
+            - Heavy shadows (early morning/late evening)
+            - Reflective glass facades (creates depth errors)
+            - Moving vehicles or people in foreground
+            - Extreme angles (very high or low)
+            - Rainy or foggy conditions
+            - Nighttime or artificial lighting only
+            - Obstruction by trees or street furniture
+            
+           
+            
+            ## Troubleshooting Urban Scenes
+            
+            **Issue: Poor depth on glass buildings**
+            - Solution: Photograph on overcast days (reduces reflections)
+            - Alternative: Focus on non-reflective adjacent structures
+            
+            **Issue: Trees obscure buildings**
+            - Solution: Document in winter (deciduous trees)
+            - Alternative: Multiple angles from different positions
+            
+            **Issue: Busy street with traffic**
+            - Solution: Photograph during quiet times
+            - Alternative: Focus on pedestrian areas
+            
+            **Issue: Very tall buildings**
+            - Solution: Step back to include full height
+            - Alternative: Document sections separately
+            
+            **Issue: Narrow streets (limited view)**
+            - Solution: Multiple overlapping photos
+            - Alternative: Focus on key elements
+            
+            ## Quality Interpretation for Planners
+            
+            ### Point Cloud Statistics:
+            - **300K+ points**: Excellent detail for analysis
+            - **3-5% outliers**: Normal, indicates clean data
+            - **<3% outliers**: Very high quality capture
+            
+            ### Mesh Quality:
+            - **Watertight ✓**: Can calculate volumes (building bulk)
+            - **Watertight ✗**: Surface only (most common for facades)
+            - **High triangle count**: Very detailed model
+            - **Surface area**: Useful for material estimates
+            
+            ### Processing Time:
+            - Typical: 15-30 seconds per image
+            - Acceptable for field documentation
+            - Consider batch processing for large areas
+            
+            ## Advanced Applications
+            
+            ### Multi-temporal Analysis:
+            - Document same location over months/years
+            - Track urban change
+            - Monitor construction progress
+            - Assess intervention impacts
+            - Study gentrification patterns
+            
+            ### Participatory Mapping:
+            - Train community members
+            - Collect distributed data
+            - Map neighborhood assets
+            - Document vernacular architecture
+            - Create collective memory
+            
+            ### Urban Morphology Research:
+            - Building typology classification
+            - Density calculations
+            - Form-based analysis
+            - Pattern recognition
+            - Comparative urban studies
+            
+            ### Climate Adaptation Planning:
+            - Document green infrastructure
+            - Assess shade provision
+            - Plan heat mitigation
+            - Evaluate flood vulnerability
+            - Design cooling corridors
+            
+           
+            """)
             gr.Markdown("""
             ## How to Use This Application
             
@@ -764,12 +2738,6 @@ with gr.Blocks(title="Advanced 3D Reconstruction", theme=gr.themes.Soft()) as de
             - https://www.creators3d.com/online-viewer
             - Just drag and drop your OBJ/PLY file
             
-            ### For 3D Printing:
-            1. Use the `mesh.stl` file
-            2. Check metrics: Look for "Watertight: ✓"
-            3. Import into your slicer (Cura, PrusaSlicer, etc.)
-            4. Scale to desired size
-            5. Slice and print!
             
             ## Tips for Best Results
             
@@ -865,11 +2833,109 @@ with gr.Blocks(title="Advanced 3D Reconstruction", theme=gr.themes.Soft()) as de
             """)
         
         # ========== CITATION TAB ==========
-        with gr.Tab("📄 Citation & Credits"):
+        with gr.Tab("📄 References & Credits"):
             gr.Markdown("""
-            ## How to Cite
+            ## Academic Citations
+            
+            
+            ### Computer Vision Methods:
+            
+            **For GLPN Model:**
+            ```bibtex
+            @inproceedings{kim2022global,
+              title={Global-Local Path Networks for Monocular Depth Estimation with Vertical CutDepth},
+              author={Kim, Doyeon and Ga, Woonghyun and Ahn, Pyungwhan and Joo, Donggyu and Chun, Sehwan and Kim, Junmo},
+              booktitle={Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition},
+              pages={8777--8787},
+              year={2022}
+            }
+            ```
+            
+            **For DPT Model:**
+            ```bibtex
+            @inproceedings{ranftl2021vision,
+              title={Vision Transformers for Dense Prediction},
+              author={Ranftl, Ren{\'e} and Bochkovskiy, Alexey and Koltun, Vladlen},
+              booktitle={Proceedings of the IEEE/CVF International Conference on Computer Vision},
+              pages={12179--12188},
+              year={2021}
+            }
+            ```
+            
+            **For Poisson Reconstruction:**
+            ```bibtex
+            @inproceedings{kazhdan2006poisson,
+              title={Poisson Surface Reconstruction},
+              author={Kazhdan, Michael and Bolitho, Matthew and Hoppe, Hugues},
+              booktitle={Proceedings of the fourth Eurographics symposium on Geometry processing},
+              volume={7},
+              year={2006}
+            }
+            ```
+            
+            
+            
+            ## Open Source Software
+            
+            This application is built with:
+            
+            **Core Technologies:**
+            - **Transformers** (Hugging Face): Deep learning model inference
+            - **Open3D**: 3D geometry processing and point cloud analysis
+            - **PyTorch**: Machine learning framework
+            - **Plotly**: Interactive 3D visualization
+            - **Gradio**: Web application framework
+            
+            **Supporting Libraries:**
+            - **NumPy & SciPy**: Numerical computing
+            - **Matplotlib**: Data visualization
+            - **Pillow**: Image processing
+            
+            **Compatible GIS Software:**
+            - **QGIS**: Free and open source GIS
+            - **ArcGIS Pro**: Professional GIS platform
+            - **CloudCompare**: Point cloud processing
+            - **MeshLab**: Mesh processing and editing
+            - **SketchUp**: 3D modeling for design
+            - **Blender**: Complete 3D creation suite
+            
+            ## License & Usage
+            
+            
+            **Model Licenses:**
+            - GLPN: Apache 2.0 License
+            - DPT: MIT License
+            - Check Hugging Face model cards for details
             
-            If you use this application in your research, please cite the relevant papers:
+            **Generated Outputs:**
+            - You own all 3D models generated
+            - Free to use in publications, presentations, reports
+            - Suitable for academic and professional work
+            - Can be shared publicly or kept private
+            
+            
+            
+            
+            ## Future Development
+            
+            **Planned Enhancements:**
+            - Georeferencing integration
+            - Batch processing capabilities
+            - Mobile app version
+            - Real-time processing
+            - Multi-language support
+            
+            **Research Opportunities:**
+            - Integration with social data
+            - Machine learning for urban features
+            - Temporal change detection
+            - Climate adaptation tools
+            - Community data platforms
+            
+            ---
+            """)
+            gr.Markdown("""
+          
             
             ### For GLPN Model:
             ```bibtex
@@ -900,31 +2966,26 @@ with gr.Blocks(title="Advanced 3D Reconstruction", theme=gr.themes.Soft()) as de
             - **Plotly**: Interactive 3D visualization
             - **Gradio**: Web interface
             
-            ## License & Usage
-            
-            - **Code**: MIT License
-            - **Generated 3D Models**: You own the outputs
-            
-            ## Contact & Support
-            
-            For issues, questions, or suggestions, use the Community tab on Hugging Face.
             """)
     
     # ========== FOOTER ==========
     gr.Markdown("""
     ---
     
-    ### 🎓 PhD Application Demo
+    This application demonstrates:
+    - **Artificial Intelligence**: Deep learning for depth estimation
+    - **Computer Vision**: Understanding 3D from 2D images
+    - **3D Graphics**: Point clouds and mesh generation
+    - **Software Development**: Building user-friendly applications
+    - **Practical Applications**: Making complex technology accessible
     
-    This application demonstrates comprehensive understanding of:
-    - Computer vision and deep learning
-    - 3D geometry and reconstruction
-    - Software engineering best practices
-    - Research methodology and evaluation
+    **Created to show how AI can solve real-world problems in an accessible way**
     
-    **Developed for academic research purposes**
+    *Combining machine learning, computer graphics, and web technology*
+    
+    ---
     
-    *Version 1.0*
+    **Ready to try it? Upload a photo and click "Start Reconstruction"!** 🚀
     """)
 
 # ============================================================================