GitHub Hot Board

GitHub Hot Board · Repository archive

microsoft/PEACE

PEACE: Empowering Geologic Map Holistic Understanding with MLLMs [Official, CVPR 2025] (This description comes from the repository itself.)

Data at October 25microsoft

Best

#154

Underappreciated Gems

100

Total stars

19

Total forks

1

Days on boards (30d)

Project statusLicense: MITLast push: October 23Open issues: 1

Collected since 2026-10-25; unknown = not yet harvested

Put your badge on the README · microsoft/PEACE[![Put your badge on the README](https://git.vaiox.xyz/api/badge/microsoft/PEACE.svg)](https://git.vaiox.xyz/en/repo/microsoft/PEACE)
<a href="https://git.vaiox.xyz/en/repo/microsoft/PEACE"><img src="https://git.vaiox.xyz/api/badge/microsoft/PEACE.svg" alt="Put your badge on the README" height="20"></a>

README

Empowering Geologic Map Holistic Understanding with MLLMs

Task Data Code

[📜 Paper] • [🤗 HF Dataset] • [🐱 GitHub Code] [🎞️ YouTube Video]

📢 News and Updates

  • 2025/01/10: 🔥GitHub Code repo (GeoMap-Agent) released.
  • 2025/01/10: 🔥HuggingFace Dataset repo (GeoMap-Bench) released.
  • 2025/01/13: 🔥Arxiv paper (PEACE) released.
  • 2025/02/27: 🔥Accepted by CVPR'25.
  • 2025/03/25: 🔥Add metrics measurement script.
  • 2025/04/22: 🔥Add interactive demo video.

📖 Table of Contents

🌟 Introduction

Geologic map, as a fundamental diagram in geology science, provides critical insights into the structure and composition of Earth's subsurface and surface. These maps are indispensable in various fields, including disaster detection, resource exploration, and civil engineering.

📖 GeoMap-Bench

We present GeoMap-Bench, a new benchmark consisting of 124 geologic maps and 3,864 multimodal multiple-choice questions with diverse annotations. The distribution of questions in the GeoMap-Bench. It consists of 25 task types that measure critical geological map interpretation abilities across five aspects: grounding, extracting, referring, reasoning, and analyzing.

🌍 GeoMap-Agent

We introduce GeoMap-Agent, the inaugural agent designed for geologic map understanding, which features three modules: Hierarchical Information Extraction(HIE), Domain Knowledge Injection (DKI), and Prompt-enhanced Question Answering (PEQA). Inspired by the interdisciplinary collaboration among human scientists, an AI expert group acts as consultants, utilizing a diverse tool pool to comprehensively analyze questions.

🧮 Leaderboard

Through comprehensive experiments, GeoMap-Agent achieves an overall score of 0.811 on GeoMap-Bench, significantly outperforming 0.369 of GPT-4o.

Method Extracting Grounding Referring Reasoning Analyzing Overall
Random 0 0 0.250 0.250 0 0.100
GPT-4o 0.219 0.128 0.378 0.507 0.612 0.369
GeoMap-Agent 0.832 0.920 0.886 0.588 0.831 0.811

🔍 Data Display

We visualize the components of a typical geologic map, highlighting the complex nature of cartographic generalization. Additionally, we showcase sample questions from GeoMap-Bench and demonstrate how our GeoMap-Agent integrates various sources of contextual information to address them.

⏩ Quick Start

Installation
  • Step1: Clone GeoMap-Agent code repository
git clone https://github.com/microsoft/PEACE.git
cd PEACE
  • Step2: Clone GeoMap-Bench dataset repository
git lfs install
git lfs clone https://huggingface.co/datasets/microsoft/PEACE data
  • Step3: Download layout detection models
pip install gdown
gdown https://drive.google.com/uc?id=1f7dUdfA_W8He9czG6SoYQBmUsSPrA6MZ
unzip models.zip -d dependencies
  • Step4: Install dependencies
Use a Python 3.11 environment. Install the pinned PyTorch and torchvision versions together; older torchvision releases can install an older PyTorch without the torch.compiler API required by Transformers.
python -m pip install --upgrade -r requirements.txt
python -m pip check
python -c "import torch, torchvision; from transformers.integrations import integration_utils; from sentence_transformers import util; print(torch.__version__, torchvision.__version__)"

The layout detectors load full-model PyTorch checkpoints. Only use model files from trusted sources, such as the Step3 download; loading an untrusted checkpoint can execute arbitrary code.

  • Step5: Configure LLMs API endpoint and key in utils/api.py
Evaluation
python eval.py --copilot_mode HIE,DKI,PEQA --dataset_source usgs
python calc_metrics.py --copilot_mode HIE,DKI,PEQA --dataset_source usgs

⚡ Disclaimer

Due to the inherent limitations of large language models, issues such as hallucinations may occur.

🔗 Citation

@article{huang2025peace,
  title={PEACE: Empowering Geologic Map Holistic Understanding with MLLMs},
  author={Huang, Yangyu and Gao, Tianyi and Xu, Haoran and Zhao, Qihao and Song, Yang and Gui, Zhipeng and Lv, Tengchao and Chen, Hao and Cui, Lei and Li, Scarlett and others},
  journal={arXiv preprint arXiv:2501.06184},
  year={2025}
}

👀 License

This repository is licensed under the MIT License. The use of Ultralytics library is subject to the AGPL-3.0 License.

Current rankings

  • 154

    Underappreciated Gems

    100 stars · 19 fork · Total stars (ascending)

    Underrated →

Momentum, past 30 days

Cumulative stars

Rank movement

Racing nearby on the same board · Underrated

Similar projects · shared topics

← Back to boards