File size: 3,274 Bytes
b6ad7e1
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
98b9eb6
 
 
 
fd62b26
 
b6ad7e1
21d24a1
98b9eb6
 
 
b6ad7e1
 
 
 
 
 
 
 
 
 
98b9eb6
3d2e431
 
 
 
 
 
 
 
98b9eb6
3d2e431
 
 
 
 
 
98b9eb6
b6ad7e1
 
98b9eb6
 
 
21d24a1
98b9eb6
 
 
 
 
 
 
9d2f3bc
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
---
tags:
- coffee
- cherry count
- yield estimate
- ultralyticsplus
- yolov8
- ultralytics
- yolo
- vision
- object-detection
- pytorch
library_name: ultralytics
library_version: 8.0.75
inference: false
datasets:
- rgautron/croppie_coffee
model-index:
- name: rgautron/croppie_coffee
  results:
  - task:
      type: object-detection
    dataset:
      type: rgautron/croppie_coffee
      name: croppie_coffee
      split: val
    metrics:
    - type: precision
      value: 0.691
      name: [email protected](box)
license: gpl-3.0
license_link: https://www.gnu.org/licenses/quick-guide-gplv3.html
base_model: Ultralytics/YOLOv8
---
[Croppie](https://croppie.org/) cherry detection model Β© 2024 by [Alliance Bioversity & CIAT](https://alliancebioversityciat.org/), [Producers Direct](https://producersdirect.org/) and [M-Omulimisa](https://m-omulimisa.com/) is licensed under [GNU-GPLv3](https://www.gnu.org/licenses/quick-guide-gplv3.html)

## General description
Ultralytics' Yolo V8 medium model fined tuned for coffee cherry detection using the [Croppie coffee dataset](https://huggingface.co/datasets/rgautroncgiar/croppie_coffee_ug).

![](images/annotated_1688033955437_.jpg)

**Note: the low visibility/unsure class was not used for model fine tuning**

The predicted numerical classes correspond to the following cherry types:
```
{0: "dark_brown_cherry", 1: "green_cherry", 2: "red_cherry", 3: "yellow_cherry"}
```

## Repository structure

```
.
β”œβ”€β”€ images
β”‚Β Β  β”œβ”€β”€ 1688033955437.jpg  # image for test
β”‚Β Β  └── annotated_1688033955437_.jpg
β”œβ”€β”€ model_v3_202402021.pt  # fine tuning of Yolo v8
β”œβ”€β”€ README.md
β”œβ”€β”€ LICENSE.txt # detailed term of the software license
└── scripts
    β”œβ”€β”€ render_results.py  # helper function to annotate predictions
    β”œβ”€β”€ requirements.txt  # pip requirements
    └── test_script.py  # test script
```

## Demonstration
Assuming you are in the ```scripts``` folder, you can run ```python3 test_script.py```. This script saves the annotated image in ```../images/annotated_1688033955437.jpg```.

Make sure that the Python packages found in ```requirements.txt``` are installed. In case they are not, simply run ```pip3 install -r requirements.txt```.

## License
[Croppie](https://croppie.org/) cherry detection model Β© 2024 by [Alliance Bioversity & CIAT](https://alliancebioversityciat.org/), [Producers Direct](https://producersdirect.org/) and [M-Omulimisa](https://m-omulimisa.com/) is licensed under [GNU-GPLv3](https://www.gnu.org/licenses/quick-guide-gplv3.html)

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

The detailed terms of the license are available in the ```LICENSE``` file in the repository.