gwhd-yolov8n

YOLOv8n Finetuned on Global Wheat Head Dataset

Fine-tuned YOLOv8n object detector on the Global Wheat Head Dataset benchmark dataset, trained and evaluated as part of DetectionBench -- a framework for reproducibly benchmarking modern object detectors with identical training recipes and evaluation metrics across multiple real-world datasets.

<p align="center"> <img src="gwhd_yolov8n_showcase.jpg" alt="Global Wheat Head Dataset Detection Demo" width="900"> </p> <br> <!-- ROW 1: Identity & Tech Stack --> <div style="display: flex; justify-content: center; align-items: center; gap: 8px; margin-bottom: 8px; flex-wrap: wrap;"> <img src="https://img.shields.io/badge/Task-Object_Detection-blue?style=flat-square" alt="Task"> <img src="https://img.shields.io/badge/Framework-Ultralytics_YOLO-0aa1a7?style=flat-square" alt="Framework"> <img src="https://img.shields.io/badge/Base_Model-YOLOv8n-purple?style=flat-square" alt="Base Model"> </div> <!-- ROW 2: Performance Metrics --> <div style="display: flex; justify-content: center; align-items: center; gap: 8px; margin-bottom: 8px; flex-wrap: wrap;"> <img src="https://img.shields.io/badge/[email protected]%25-success?style=flat-square" alt="mAP@50"> <img src="https://img.shields.io/badge/mAP@50:95-28.21%25-orange?style=flat-square" alt="mAP@50:95"> <img src="https://img.shields.io/badge/Params-3.2M-lightgrey?style=flat-square" alt="Params"> </div> <!-- ROW 3: Metadata --> <div style="display: flex; justify-content: center; align-items: center; gap: 8px; margin-bottom: 24px; flex-wrap: wrap;"> <img src="https://img.shields.io/badge/License-AGPL--3.0-lightgrey?style=flat-square" alt="License"> <a href="https://github.com/dronefreak/DetectionBench"><img src="https://img.shields.io/badge/Source-DetectionBench-black?style=flat-square" alt="Source"></a> </div>

---

Usage

Install Dependencies

pip install ultralytics huggingface_hub

Load Model from Hugging Face

from huggingface_hub import hf_hub_download
from ultralytics import YOLO

weights = hf_hub_download(
    repo_id="dronefreak/gwhd-yolov8n",
    filename="best.pt"
)

model = YOLO(weights)

Run Inference

results = model.predict(
    source="image.jpg",
    conf=0.25
)

results[0].show()

---

Performance

Evaluated on the Global Wheat Head Dataset test split, using DetectionBench's standard evaluation pipeline (detectionbench-evaluate).

---

Global Wheat Head Dataset Model Zoo

Every model DetectionBench has trained and evaluated on Global Wheat Head Dataset so far, for full transparency -- see DetectionBench for the smaller, curated comparison set used on the project README.

---

Per-Class Performance

---

Per-Country Performance

Domain shift can matter more than the aggregate score above for field deployment, so this evaluates the same test split broken down by the contributing country/institution, using per-image domain metadata (domain_metadata.json in this repository) compiled by this project for this stratified evaluation -- not a file shipped with the original GWHD release. Each row below is computed by re-running this exact model's evaluation restricted to that country's images only -- the same mAP definition as the aggregate number above (Ultralytics' model.val() for YOLO, Supervision's MeanAveragePrecision for RF-DETR), just on a filtered subset, not a separate metric implementation. One test image with no resolvable country in the source metadata (a documented upstream duplicate-filename quirk) is excluded from every row below.

---

Dataset

This model was trained on Global Wheat Head Dataset. For the full dataset description, provenance, license, and citation, see the dataset card:

https://huggingface.co/datasets/dronefreak/GWHD

Classes

• wheat_head

---

Training Configuration

---

Repository Contents

best.pt
results.csv
args.yaml
BoxPR_curve.png
BoxF1_curve.png
BoxP_curve.png
BoxR_curve.png
confusion_matrix.png
confusion_matrix_normalized.png
val_batch0_pred.jpg
country_breakdown.json
domain_metadata.json
gwhd_yolov8n_showcase.jpg
README.md

---

Related Resources

• Global Wheat Head Dataset dataset card on Hugging Face
• DetectionBench -- reproducible benchmarks for modern object detectors on real-world datasets
• GWHD 2021 paper preprint (arXiv:2105.07660)

---

Training Framework

This model was trained using DetectionBench, an open-source framework for benchmarking object detectors across multiple real-world datasets with a common pipeline.

Features include:

• A dataset-adapter registry for converting real-world datasets into a canonical format
• Identical training/evaluation recipes across model families (Ultralytics YOLO/RT-DETR, RF-DETR)
• Hardware profiling (latency, FPS, VRAM, parameters, FLOPs)
• One-command reproducibility via versioned Hydra configs

If you find this model useful, please consider starring the repository.

---

Known Limitations

• Single-class, dense-detection dataset: every box is wheat_head, so per-class breakdowns collapse to one row -- the challenge here is localization density, not class discrimination.
• Very dense annotations: ~45 wheat heads per image on average (up to 129 in a single image), with roughly 54% of boxes covering under 0.5% of the image area -- heavy box overlap and occlusion between adjacent heads is common.
• A small fraction of images (~1.4% of the training split) contain zero wheat heads and are still included with empty ground truth, matching the official release's convention.
• Assembled from field images across multiple countries/institutions with varying genotypes, growth stages, and imaging conditions -- performance on wheat varieties or field conditions not represented in this mix is untested.
• Distributed under CC BY 4.0 (attribution required, commercial use permitted) -- see the dataset card for the full license text and provenance.

---

Citation

If you use this model in your research, please consider citing the dataset and the model architecture:

@article{david2021global,
  title = {Global Wheat Head Dataset 2021: more diversity to improve the benchmarking of wheat head localization methods},
  author = {David, Etienne and Serouart, Mario and Smith, Daniel and Madec, Simon and Velumani, Kaaviya and Liu, Shouyang and Wang, Xu and Pinto Espinosa, Francisco and Shafiee, Shahameh and Tahir, Izzat S. A. and Tsujimoto, Hisashi and Nasuda, Shuhei and Zheng, Bangyou and Kichgessner, Norbert and Aasen, Helge and Hund, Andreas and Sadhegi-Tehran, Pouria and Nagasawa, Koichi and Ishikawa, Goro and Dandrifosse, S{\'e}bastien and Carlier, Alexis and Mercatoris, Benoit and Kuroki, Ken and Wang, Haozhou and Ishii, Masanori and Badhon, Minhajul A. and Pozniak, Curtis and LeBauer, David Shaner and Lilimo, Morten and Poland, Jesse and Chapman, Scott and de Solan, Benoit and Baret, Fr{\'e}d{\'e}ric and Stavness, Ian and Guo, Wei},
  journal = {Plant Phenomics},
  year = {2021},
  doi = {10.34133/2021/9846158}
}

@article{david2020global,
  title = {Global Wheat Head Detection (GWHD) Dataset: A Large and Diverse Dataset of High-Resolution RGB-Labelled Images to Develop and Benchmark Wheat Head Detection Methods},
  author = {David, Etienne and Madec, Simon and Sadeghi-Tehran, Pouria and Aasen, Helge and Zheng, Bangyou and Liu, Shouyang and Kirchgessner, Norbert and Ishikawa, Goro and Nagasawa, Koichi and Badhon, Minhajul A. and Pozniak, Curtis and de Solan, Benoit and Hund, Andreas and Chapman, Scott C. and Baret, Fr{\'e}d{\'e}ric and Stavness, Ian and Guo, Wei},
  journal = {Plant Phenomics},
  year = {2020},
  doi = {10.34133/2020/3521852}
}

No official YOLOv8 research paper has been published by Ultralytics; this is their own recommended software citation instead:

@software{jocher2023yolov8,
  author = {Glenn Jocher and Ayush Chaurasia and Jing Qiu},
  title = {Ultralytics YOLOv8},
  version = {8.0.0},
  year = {2023},
  url = {https://github.com/ultralytics/ultralytics},
  license = {AGPL-3.0}
}