README.md

 
---
tags:
- ultralyticsplus
- yolov8
- ultralytics
- yolo
- vision
- object-detection
- pytorch
- awesome-yolov8-models
library_name: ultralytics
library_version: 8.0.23
inference: false

datasets:
- keremberke/nfl-object-detection

model-index:
- name: keremberke/yolov8n-nlf-head-detection
  results:
  - task:
      type: object-detection

    dataset:
      type: keremberke/nfl-object-detection
      name: nfl-object-detection
      split: validation

    metrics:
      - type: precision  # since mAP@0.5 is not available on hf.co/metrics
        value: 0.20933  # min: 0.0 - max: 1.0
        name: mAP@0.5(box)
---

<div align="center">
  <img width="640" alt="keremberke/yolov8n-nlf-head-detection" src="https://huggingface.co/keremberke/yolov8n-nlf-head-detection/resolve/main/thumbnail.jpg">
</div>

### Supported Labels

```
['Helmet', 'Helmet-Blurred', 'Helmet-Difficult', 'Helmet-Partial', 'Helmet-Sideline']
```

### How to use

- Install [ultralyticsplus](https://github.com/fcakyon/ultralyticsplus):

```bash
pip install ultralyticsplus==0.0.24 ultralytics==8.0.23
```

- Load model and perform prediction:

```python
from ultralyticsplus import YOLO, render_result

# load model
model = YOLO('keremberke/yolov8n-nlf-head-detection')

# set model parameters
model.overrides['conf'] = 0.25  # NMS confidence threshold
model.overrides['iou'] = 0.45  # NMS IoU threshold
model.overrides['agnostic_nms'] = False  # NMS class-agnostic
model.overrides['max_det'] = 1000  # maximum number of detections per image

# set image
image = 'https://github.com/ultralytics/yolov5/raw/master/data/images/zidane.jpg'

# perform inference
results = model.predict(image)

# observe results
print(results[0].boxes)
render = render_result(model=model, image=image, result=results[0])
render.show()
```

**More models available at: [awesome-yolov8-models](https://yolov8.xyz)**