Update app.py

app.py

@@ -1,1285 +1,4 @@
-# ========== 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
 """
@@ -1303,230 +22,7 @@ import zipfile
 # LITERATURE REVIEW & THEORETICAL BACKGROUND
 # ============================================================================
 THEORY_TEXT = """
-## 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
-
-### 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.
-"""
+## Theoretical Background: Geospatial Applications
 
 ### 3D Reconstruction for Urban Geography
 
@@ -2163,17 +659,18 @@ 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("""
-    # 🏗️ 3D Reconstruction from Single Images
+    # 🏗️ 3D Urban Reconstruction from Single Images
     
-    **Transform any photograph into an interactive 3D model**
+    **Geospatial Technology for Urban Planning & Analysis**
     
-    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
+    Transform 2D photographs into 3D spatial models for:
+    - Urban morphology analysis
+    - Built environment assessment
+    - Heritage documentation
+    - Spatial planning visualization
+    - Geographic information systems (GIS) integration
     
-    No special equipment needed - works with any regular photograph!
+    Upload a photograph to generate interactive 3D models with exportable spatial data.
     """)
     
     with gr.Tabs():
@@ -2280,286 +777,178 @@ with gr.Blocks(title="Advanced 3D Reconstruction", theme=gr.themes.Soft()) as de
             """)
         
         # ========== USAGE GUIDE TAB ==========
-        with gr.Tab("📖 Step-by-Step Guide"):
+        with gr.Tab("📖 Usage Guide for Urban Planners"):
             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)
+            ## How to Use This Tool for Urban Analysis
+            
+            ### Step 1: Capture Urban Photographs
+            - Use any digital camera or smartphone
+            - Recommended: Street-level views of buildings, public spaces, neighborhoods
+            - Best conditions: Daylight, clear weather, minimal shadows
+            - **Urban Planning Examples:**
+              - Building facades for heritage documentation
+              - Street sections for walkability analysis
+              - Public spaces for design assessment
+              - Informal settlements for upgrading planning
+              - Commercial districts for economic analysis
+            
+            ### Step 2: Choose Processing Model
+            - **GLPN (Recommended for most urban scenes)**
+              - Fast processing (~2-3 seconds)
+              - Optimized for architectural scenes
+              - Best for: Building interiors, street views, single structures
+              - Use when: Time is limited, field documentation
+            
+            - **DPT (High Quality for complex scenes)**
+              - Superior quality (~6-10 seconds)
+              - Better for wide urban landscapes
+              - Best for: Plazas, parks, urban squares, panoramic views
+              - Use when: Quality is priority, detailed analysis needed
             
-            **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:
+            ### Step 3: Select Visualization
+            - **Mesh**: Best for volumetric analysis, surface continuity
+            - **Point Cloud**: Best for integration with GIS, spatial analysis
+            - **Both**: Complete documentation showing both representations
             
-            - ❌ Blank white walls
-            - ❌ Mirrors and reflective surfaces
-            - ❌ Very dark rooms
-            - ❌ Photos through windows
-            - ❌ Extreme close-ups
-            - ❌ Moving subjects (blur)
+            ### Step 4: Generate 3D Model
+            - Click "🚀 Start Reconstruction"
+            - Processing time: 10-30 seconds typically
+            - Watch progress in the report
             
-            ---
+            ### Step 5: Analyze Results
             
-            ### Learning More
+            **Depth Map Analysis:**
+            - Left: Original photograph
+            - Right: Spatial depth information
+              - **Yellow/Red**: Foreground elements (closer objects)
+              - **Blue/Purple**: Background elements (distant features)
+            - **Urban Planning Use**: Identify spatial relationships, understand enclosure
             
-            **If you want to go deeper:**
+            **Interactive 3D Viewer:**
+            - Rotate: Click and drag (view from any angle)
+            - Zoom: Scroll wheel (examine details)
+            - Pan: Right-click drag (navigate the scene)
+            - **Planning Use**: Assess massing, sightlines, spatial quality
+            
+            **Quality Metrics for Planners:**
+            - **Point Cloud Density**: Higher = more spatial detail
+            - **Watertight Status**: Important if calculating volumes
+            - **Triangle Count**: Indicates level of geometric detail
+            
+            ### Step 6: Export for GIS Integration
+            
+            Download the ZIP file containing:
+            - **point_cloud.ply** → Import into QGIS, ArcGIS Pro
+            - **mesh.ply** → Import into SketchUp, Blender
+            - **mesh.obj** → Universal format for most GIS/CAD software
+            - **mesh.stl** → For 3D printing physical models
+            - **metrics.json** → Spatial data attributes
+            
+            ## Integration Workflows
+            
+            ### Workflow 1: QGIS Integration
+            1. Download point cloud (.ply)
+            2. Open QGIS → Add Layer → Add Point Cloud Layer
+            3. Apply styling for elevation/color
+            4. Overlay with city basemap
+            5. Add ground control points for georeferencing
+            6. Export as georeferenced 3D layer
+            
+            ### Workflow 2: ArcGIS Pro Urban Analysis
+            1. Download mesh (.obj)
+            2. ArcGIS Pro → Insert → Import 3D Object
+            3. Position in local scene
+            4. Add attribute data
+            5. Perform viewshed, shadow analysis
+            6. Create presentation layouts
+            
+            ### Workflow 3: SketchUp Urban Design
+            1. Download mesh (.obj)
+            2. SketchUp → File → Import
+            3. Place in urban context model
+            4. Add textures, refine geometry
+            5. Test design alternatives
+            6. Export renderings for stakeholders
+            
+            ### Workflow 4: Community Engagement
+            1. Generate 3D models of neighborhood
+            2. View in interactive viewer
+            3. Show existing conditions
+            4. Discuss proposed changes
+            5. Document community feedback
+            6. Create before/after comparisons
+            
+            ## Urban Planning Use Cases
+            
+            ### Heritage Conservation
+            **Workflow:**
+            - Photograph historic buildings
+            - Generate 3D documentation
+            - Archive for future reference
+            - Monitor deterioration over time
+            - Support renovation planning
+            
+            **Best Practices:**
+            - Multiple views of each facade
+            - Consistent lighting conditions
+            - Include architectural details
+            - Document surroundings
+            
+            ### Informal Settlement Documentation
+            **Workflow:**
+            - Community members photograph homes
+            - Generate spatial database
+            - Map infrastructure needs
+            - Plan upgrading interventions
+            - Track improvements
             
-            - 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
+            **Benefits:**
+            - Participatory data collection
+            - Low cost, accessible technology
+            - Empowers residents
+            - Creates permanent record
             
-            **Remember**: This is a learning tool. Have fun, experiment, and don't worry about making mistakes!
-            """)
-            gr.Markdown("""
+            ### Public Space Analysis
+            **Workflow:**
+            - Document plaza, park, or street
+            - Analyze spatial enclosure
+            - Measure sight lines
+            - Assess accessibility
+            - Evaluate design quality
+            
+            **Metrics to Extract:**
+            - Width-to-height ratios
+            - Visual complexity
+            - Surface areas
+            - Volumetric data
+            
+            ### Urban Design Review
+            **Workflow:**
+            - Photograph proposed site
+            - Generate existing conditions model
+            - Import to design software
+            - Test massing alternatives
+            - Visualize proposals in context
+            
+            **Communication:**
+            - Show community stakeholders
+            - Present to planning commission
+            - Public hearings
+            - Online participation
+            
+            ### Climate & Sustainability
+            **Workflow:**
+            - Document building envelopes
+            - Analyze orientation
+            - Study shadow patterns
+            - Assess green infrastructure
+            - Plan adaptation measures
+            
+            **Analysis Opportunities:**
+            - Solar potential (with georeferencing)
+            - Urban heat island effects
+            - Natural ventilation paths
+            - Green space visibility
             
             ## Tips for Urban Documentation
             
@@ -2581,7 +970,33 @@ with gr.Blocks(title="Advanced 3D Reconstruction", theme=gr.themes.Soft()) as de
             - Nighttime or artificial lighting only
             - Obstruction by trees or street furniture
             
-           
+            ## Limitations for Professional Practice
+            
+            ### ⚠️ Important Disclaimers:
+            
+            **This tool is NOT suitable for:**
+            - Legal property surveys
+            - Structural engineering analysis
+            - Official building permits
+            - Cadastral mapping
+            - Precise measurements (no absolute scale)
+            - Archaeological site recording (use TLS)
+            
+            **This tool IS suitable for:**
+            - Preliminary site assessments
+            - Community documentation
+            - Educational purposes
+            - Participatory planning
+            - Conceptual visualization
+            - Research and analysis
+            - Public engagement
+            - Rapid assessment after disasters
+            
+            ### Scale & Accuracy:
+            - **No absolute scale**: Models are in arbitrary units
+            - **Relative accuracy**: Spatial relationships preserved
+            - **To add scale**: Use known dimensions (door height, etc.)
+            - **For georeferencing**: Add ground control points in GIS
             
             ## Troubleshooting Urban Scenes
             
@@ -2653,7 +1068,59 @@ with gr.Blocks(title="Advanced 3D Reconstruction", theme=gr.themes.Soft()) as de
             - Evaluate flood vulnerability
             - Design cooling corridors
             
-           
+            ## Getting Started: Sample Project
+            
+            **Neighborhood Documentation Project:**
+            
+            1. **Planning** (1 hour):
+               - Define study area boundaries
+               - Create photo waypoints
+               - Identify key features
+               - Prepare equipment
+            
+            2. **Field Work** (2-4 hours):
+               - Walk planned route
+               - Photograph key locations
+               - Take notes on conditions
+               - Document GPS coordinates
+            
+            3. **Processing** (1-2 hours):
+               - Upload photos to tool
+               - Generate 3D models
+               - Download all outputs
+               - Organize files
+            
+            4. **Analysis** (variable):
+               - Import to GIS
+               - Georeference models
+               - Extract metrics
+               - Create visualizations
+            
+            5. **Reporting** (1-2 hours):
+               - Compile findings
+               - Create maps and figures
+               - Document methodology
+               - Share with stakeholders
+            
+            ## Educational Uses
+            
+            **For Geography Students:**
+            - Learn spatial analysis
+            - Understand urban form
+            - Practice GIS integration
+            - Develop field skills
+            
+            **For Planning Studios:**
+            - Document existing conditions
+            - Analyze site context
+            - Test design proposals
+            - Communicate ideas
+            
+            **For Community Workshops:**
+            - Engage residents
+            - Document neighborhood character
+            - Support advocacy
+            - Build capacity
             """)
             gr.Markdown("""
             ## How to Use This Application
@@ -2738,6 +1205,12 @@ 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
             
@@ -2833,109 +1306,11 @@ with gr.Blocks(title="Advanced 3D Reconstruction", theme=gr.themes.Soft()) as de
             """)
         
         # ========== CITATION TAB ==========
-        with gr.Tab("📄 References & Credits"):
+        with gr.Tab("📄 Citation & Credits"):
             gr.Markdown("""
-            ## 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
-            
-            **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
+            ## How to Cite
             
-            
-            
-            
-            ## 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("""
-          
+            If you use this application in your research, please cite the relevant papers:
             
             ### For GLPN Model:
             ```bibtex
@@ -2966,26 +1341,31 @@ 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("""
     ---
     
-    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
-    
-    **Created to show how AI can solve real-world problems in an accessible way**
+    ### 🎓 PhD Application Demo
     
-    *Combining machine learning, computer graphics, and web technology*
+    This application demonstrates comprehensive understanding of:
+    - Computer vision and deep learning
+    - 3D geometry and reconstruction
+    - Software engineering best practices
+    - Research methodology and evaluation
     
-    ---
+    **Developed for academic research purposes**
     
-    **Ready to try it? Upload a photo and click "Start Reconstruction"!** 🚀
+    *Version 1.0*
     """)
 
 # ============================================================================