Williamsanderson commited on
Commit
345029f
·
verified ·
1 Parent(s): eacfff4

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +11 -11
README.md CHANGED
@@ -54,7 +54,7 @@ This model **outperforms the fine-tuned YOLOv11x reported in the MVBroTrack pape
54
 
55
  ---
56
 
57
- ## 📊 Performance
58
 
59
  ### Final metrics (validation set — 3 706 images, imgsz 640)
60
 
@@ -82,7 +82,7 @@ This model **outperforms the fine-tuned YOLOv11x reported in the MVBroTrack pape
82
 
83
  ---
84
 
85
- ## 🥊 Comparison with the reference paper
86
 
87
  **Reference paper** — Cardoen et al., *"Multi-camera detection and tracking for individual broiler monitoring"*, *Computers and Electronics in Agriculture*, 2025 (MVBroTrack).
88
 
@@ -102,11 +102,11 @@ Why is this model better on the unified benchmark:
102
  3. **AdamW + warmup + cosine-like LR decay** (paper uses SGD).
103
  4. **Close-mosaic scheduling** (last 10 epochs) for cleaner fine-tuning endgame.
104
 
105
- > ⚠️ Direct comparison note: our 79.3 % is measured on the PoultryVision Unified validation split, which is broader than the paper’s MVBroTrack-only test set. The ≥ 70.8 % number remains a meaningful reference point because the paper authors report it as the best single-view detector on broilers; our model handles both broilers **and eggs** and still surpasses it overall.
106
 
107
  ---
108
 
109
- ## 🚀 Quick start
110
 
111
  ```bash
112
  pip install ultralytics huggingface_hub
@@ -156,7 +156,7 @@ model.export(format="tflite", int8=True) # Edge / Coral
156
 
157
  ---
158
 
159
- ## 🧠 Full pipeline (beyond single-view detection)
160
 
161
  This model is the single-view detection stage of a larger pipeline inspired by the MVBroTrack paper:
162
 
@@ -170,7 +170,7 @@ The full reference implementation of modules 2-5 is shipped as [`poultry_vision_
170
 
171
  ---
172
 
173
- ## 📁 Files in this repo
174
 
175
  | File | Description |
176
  |---------------------------------------|-------------------------------------------|
@@ -190,7 +190,7 @@ The full reference implementation of modules 2-5 is shipped as [`poultry_vision_
190
 
191
  ---
192
 
193
- ## 🧪 Training recipe (excerpt)
194
 
195
  ```yaml
196
  model: yolo11m.pt
@@ -225,7 +225,7 @@ See `args.yaml` for the complete set.
225
 
226
  ---
227
 
228
- ## ⚖️ License
229
 
230
  - **Model weights**: **AGPL-3.0** (inherited from Ultralytics YOLOv11).
231
  Commercial deployments without open-sourcing your full stack should acquire an [Ultralytics Enterprise License](https://www.ultralytics.com/license).
@@ -233,14 +233,14 @@ See `args.yaml` for the complete set.
233
 
234
  ---
235
 
236
- ## 📚 Citation
237
 
238
  If you use this model or the PoultryVision dataset, please cite:
239
 
240
  ```bibtex
241
  @misc{williamsanderson_poultryvision_2025,
242
  title = {PoultryVision: A YOLOv11m Model and Unified Dataset for Broiler and Egg Detection},
243
- author = {Williams Anderson},
244
  year = {2025},
245
  howpublished = {\url{https://huggingface.co/Williamsanderson/PoultryVision}},
246
  }
@@ -259,7 +259,7 @@ And the reference paper this work is based on:
259
 
260
  ---
261
 
262
- ## 🙏 Acknowledgements
263
 
264
  - **Ultralytics** for the YOLOv11 architecture and training framework.
265
  - **Cardoen et al.** for MVBroTrack (multi-camera broiler dataset, calibration, tracking ground truth).
 
54
 
55
  ---
56
 
57
+ ## Performance
58
 
59
  ### Final metrics (validation set — 3 706 images, imgsz 640)
60
 
 
82
 
83
  ---
84
 
85
+ ## Comparison with the reference paper
86
 
87
  **Reference paper** — Cardoen et al., *"Multi-camera detection and tracking for individual broiler monitoring"*, *Computers and Electronics in Agriculture*, 2025 (MVBroTrack).
88
 
 
102
  3. **AdamW + warmup + cosine-like LR decay** (paper uses SGD).
103
  4. **Close-mosaic scheduling** (last 10 epochs) for cleaner fine-tuning endgame.
104
 
105
+ > Direct comparison note: our 79.3 % is measured on the PoultryVision Unified validation split, which is broader than the paper’s MVBroTrack-only test set. The ≥ 70.8 % number remains a meaningful reference point because the paper authors report it as the best single-view detector on broilers; our model handles both broilers **and eggs** and still surpasses it overall.
106
 
107
  ---
108
 
109
+ ## Quick start
110
 
111
  ```bash
112
  pip install ultralytics huggingface_hub
 
156
 
157
  ---
158
 
159
+ ## Full pipeline (beyond single-view detection)
160
 
161
  This model is the single-view detection stage of a larger pipeline inspired by the MVBroTrack paper:
162
 
 
170
 
171
  ---
172
 
173
+ ## Files in this repo
174
 
175
  | File | Description |
176
  |---------------------------------------|-------------------------------------------|
 
190
 
191
  ---
192
 
193
+ ## Training recipe (excerpt)
194
 
195
  ```yaml
196
  model: yolo11m.pt
 
225
 
226
  ---
227
 
228
+ ## License
229
 
230
  - **Model weights**: **AGPL-3.0** (inherited from Ultralytics YOLOv11).
231
  Commercial deployments without open-sourcing your full stack should acquire an [Ultralytics Enterprise License](https://www.ultralytics.com/license).
 
233
 
234
  ---
235
 
236
+ ## Citation
237
 
238
  If you use this model or the PoultryVision dataset, please cite:
239
 
240
  ```bibtex
241
  @misc{williamsanderson_poultryvision_2025,
242
  title = {PoultryVision: A YOLOv11m Model and Unified Dataset for Broiler and Egg Detection},
243
+ author = {Stephane Williams Anderson ASSA},
244
  year = {2025},
245
  howpublished = {\url{https://huggingface.co/Williamsanderson/PoultryVision}},
246
  }
 
259
 
260
  ---
261
 
262
+ ## Acknowledgements
263
 
264
  - **Ultralytics** for the YOLOv11 architecture and training framework.
265
  - **Cardoen et al.** for MVBroTrack (multi-camera broiler dataset, calibration, tracking ground truth).