Skip to content

ShubhamS2005/AIDriven-Archaeological-Site-Mapping

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

12 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›๏ธ AI-Driven Archaeological Site Mapping

Python Deep Learning Framework Notebook License Repo Size Stars


๐Ÿ“– Overview

AI-Driven Archaeological Site Mapping is a research-oriented computer vision project that explores how deep learning and environmental analysis can assist in identifying potential archaeological sites.

The system analyzes vegetation patterns and soil characteristics from images using AI models to detect anomalies that may indicate buried structures, ancient settlements, or historical land disturbances.

The project integrates:

  • ๐ŸŒฑ Vegetation Segmentation
  • ๐Ÿชจ Soil Pattern Detection
  • ๐Ÿ“Š Visual Model Analysis
  • ๐Ÿง  Explainable AI using Grad-CAM

๐ŸŽฏ Motivation

Archaeologists often rely on environmental signals such as:

  • Abnormal vegetation growth
  • Soil discoloration
  • Surface texture changes
  • Disturbed land patterns

These indicators can reveal hidden structures underground.

This project investigates how AI models can automatically detect these signals, helping archaeologists narrow down potential excavation locations.


๐Ÿง  Model Architecture

The deep learning system is built around a YOLO-based object detection and segmentation pipeline.

Input Image
     โ”‚
     โ–ผ
Image Preprocessing
(resizing, normalization)
     โ”‚
     โ–ผ
Deep Learning Model
(YOLO Segmentation / Detection)
     โ”‚
     โ–ผ
Feature Extraction
     โ”‚
     โ–ผ
Prediction Layer
     โ”‚
     โ–ผ
Output
 โ”œโ”€โ”€ Vegetation Segmentation
 โ”œโ”€โ”€ Soil Classification
 โ””โ”€โ”€ Bounding Box Detection

โš™๏ธ Project Pipeline

The complete workflow of the system:

Satellite / Ground Images
            โ”‚
            โ–ผ
     Data Collection
            โ”‚
            โ–ผ
     Data Annotation
            โ”‚
            โ–ผ
      Model Training
 (Vegetation + Soil Models)
            โ”‚
            โ–ผ
      Model Evaluation
   (F1 Curves & Metrics)
            โ”‚
            โ–ผ
     Prediction & Testing
            โ”‚
            โ–ผ
 Visualization & Explainability
   โ”œโ”€ Bounding Box Detection
   โ”œโ”€ Grad-CAM Heatmaps
   โ””โ”€ Performance Curves
            โ”‚
            โ–ผ
 Archaeological Pattern Analysis

๐Ÿ“‚ Repository Structure

AIDriven-Archaeological-Site-Mapping
โ”‚
โ”œโ”€โ”€ ArchilogicalMapping/
โ”‚
โ”œโ”€โ”€ SoilDetection/
โ”‚   โ”œโ”€โ”€ SoilDetection.ipynb
โ”‚   โ”œโ”€โ”€ SOIL.md
โ”‚   โ”œโ”€โ”€ bbox_visualization.png
โ”‚   โ”œโ”€โ”€ distribution.png
โ”‚   โ”œโ”€โ”€ gad_cam.png
โ”‚   โ”œโ”€โ”€ class_labels.json
โ”‚   โ””โ”€โ”€ test_soil.jpg
โ”‚
โ”œโ”€โ”€ UI-Demo/
โ”‚
โ”œโ”€โ”€ VegetationSegmentation.ipynb
โ”œโ”€โ”€ VEGETATION.md
โ”œโ”€โ”€ best.pt
โ”œโ”€โ”€ data.yaml
โ”œโ”€โ”€ results.csv
โ”œโ”€โ”€ veg_test.jpg
โ”‚
โ”œโ”€โ”€ BoxF1_curve.png
โ”œโ”€โ”€ MaskF1_curve.png
โ”‚
โ”œโ”€โ”€ AgroSensi-AI-2.pptx
โ””โ”€โ”€ README.md

๐ŸŒฑ Vegetation Segmentation

Vegetation anomalies can indicate underground structures.

This module trains a deep learning segmentation model to identify vegetation patterns.

Files

VegetationSegmentation.ipynb
VEGETATION.md
best.pt
data.yaml

Outputs

  • Vegetation masks
  • Bounding box F1 score curve
  • Mask segmentation accuracy

Example evaluation plots:

BoxF1_curve.png
MaskF1_curve.png

๐Ÿชจ Soil Detection

Soil composition differences often reveal hidden archaeological features.

The soil detection module performs:

  • Soil classification
  • Bounding box detection
  • Model explainability

Files

SoilDetection.ipynb
SOIL.md
class_labels.json

Visual Outputs

  • Dataset distribution plot
  • Bounding box visualization
  • Grad-CAM interpretability heatmap
distribution.png
bbox_visualization.png
gad_cam.png

Grad-CAM highlights which image regions influenced model predictions.


๐Ÿ’ป UI Demonstration

The UI-Demo directory shows how the AI models could be integrated into a visual interface for archaeologists or researchers.

This allows easier interaction with prediction outputs and visualizations.


๐Ÿ“Š Results

The trained models produce:

  • Vegetation segmentation maps
  • Soil classification predictions
  • Bounding box detections
  • Performance metrics
  • Grad-CAM explanation maps

Results are saved in:

results.csv

๐Ÿš€ How to Run the Project

Clone Repository

git clone https://github.com/ShubhamS2005/AIDriven-Archaeological-Site-Mapping.git

Move Into Directory

cd AIDriven-Archaeological-Site-Mapping

Run Notebooks

Open and run:

VegetationSegmentation.ipynb
SoilDetection/SoilDetection.ipynb

Execute cells sequentially for training and predictions.


๐Ÿ”ฌ Applications

This system can support:

  • Archaeological site prediction
  • Environmental anomaly detection
  • Remote sensing analysis
  • Cultural heritage preservation
  • AI-assisted archaeological surveys

๐Ÿ”ฎ Future Improvements

Potential future extensions:

  • Satellite imagery integration
  • Multi-spectral remote sensing analysis
  • GIS mapping integration
  • Web dashboard for visualization
  • Real-time site prediction system

Demo Link

https://archilogicalmappingui-ghgvrpkd29qhwrgmcerkyo.streamlit.app/

Demo use

Admin, pass 1234

๐Ÿ“œ License

This project is open-source and available under the MIT License.


๐Ÿ‘จโ€๐Ÿ’ป Author

Made with โค๏ธ by Shubham Srivastava (shubhamsrivastava12568@gmail.com)

โญ If you find this project useful, consider giving it a star on GitHub!


About

It an Archaeological site mapping project, this consist of two models one is for classifying vegetation land or not another model to classify type of soil. These models are going to be used in building the Archaeological Site Mapping project. for demo use Admin, pass 1234

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Jupyter Notebook 100.0%