GIS Map Analysis Expert 🗺️📊

A powerful tool for GIS professionals that provides expert-level analysis of maps with pinpoint accuracy. Available with both Streamlit and Gradio interfaces.

🌟 Features

• Professional GIS Analysis: Analyze various types of maps with proper geospatial terminology and techniques:

  • Water charts & hydrological maps
  • Landfall & terrain maps
  • Weather pattern maps
  • General topographical maps

• High Accuracy Standards:

  • Analyzes ONLY observable information visible in maps
  • Uses precise GIS terminology appropriate for professionals
  • Explicitly states when information cannot be determined rather than making assumptions
  • Focuses on map elements, legends, and annotations

• User-Friendly Interface:

  • Dual interface options (Streamlit & Gradio)
  • Upload maps in various formats (JPG, PNG)
  • Ask specific questions about map features
  • Download analysis results as text files
  • Generate shareable links for collaboration

📋 Requirements

• Python 3.8+
• Groq API key

🚀 Installation & Setup

1. Clone this repository:

git clone https://github.com/Haadesx/gis-map-analysis-expert.git
cd gis-map-analysis-expert

2. Install required packages:

pip install -r requirements.txt

3. Set up your Groq API key:
   • Create a .env file in the project root
   • Add your API key as: GROQ_API_KEY=your_key_here

💻 Usage

Streamlit Interface

streamlit run streamlit_app.py

Gradio Interface

python app.py

🔍 Analysis Capabilities

The application provides specialized analysis for different map types:

Water Charts Analysis

• Hydrological features identification
• Water level assessments
• Flow patterns and drainage networks
• Water-related measurements and annotations

Terrain Maps Analysis

• Topographical feature identification
• Elevation pattern analysis
• Contour line interpretation
• Geological feature assessment

Weather Maps Analysis

• Weather system identification
• Front and pressure zone analysis
• Temperature pattern recognition
• Meteorological feature interpretation

🤔 Q&A Feature

The application includes a powerful Q&A capability that allows GIS professionals to:

• Ask specific technical questions about uploaded maps
• Receive accurate, fact-based answers
• Get insights based on visible map elements only
• Utilize proper geospatial terminology

🔒 Security Note

The application uses environment variables to securely manage API keys. Never hardcode your API keys directly in source files.

🖼️ Screenshots

[Include screenshots of your application here]

🛠️ Technical Details

This application uses:

• Groq's LLaMA 3.2 90B Vision Model for analyzing maps
• Streamlit/Gradio for the web interface
• PIL for image processing
• Regular expressions for formatting and enhancing readability
• UUID generation for unique shareable links

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📧 Contact

For questions or feedback, please contact me via GitHub or LinkedIn.