YOLO11 Tasks, Modes, Usage, Macros and Solutions Updates (#16593)
Signed-off-by: UltralyticsAssistant <web@ultralytics.com>
This commit is contained in:
parent
3093fc9ec2
commit
51e93d6111
31 changed files with 541 additions and 541 deletions
|
|
@ -17,7 +17,7 @@ The output of an oriented object detector is a set of rotated bounding boxes tha
|
|||
|
||||
!!! tip
|
||||
|
||||
YOLOv8 OBB models use the `-obb` suffix, i.e. `yolov8n-obb.pt` and are pretrained on [DOTAv1](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/DOTAv1.yaml).
|
||||
YOLO11 OBB models use the `-obb` suffix, i.e. `yolo11n-obb.pt` and are pretrained on [DOTAv1](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/DOTAv1.yaml).
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
|
|
@ -36,14 +36,14 @@ The output of an oriented object detector is a set of rotated bounding boxes tha
|
|||
| :------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------: |
|
||||
|  |  |
|
||||
|
||||
## [Models](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/models/v8)
|
||||
## [Models](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/models/11)
|
||||
|
||||
YOLOv8 pretrained OBB models are shown here, which are pretrained on the [DOTAv1](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/DOTAv1.yaml) dataset.
|
||||
YOLO11 pretrained OBB models are shown here, which are pretrained on the [DOTAv1](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/DOTAv1.yaml) dataset.
|
||||
|
||||
[Models](https://github.com/ultralytics/ultralytics/tree/main/ultralytics/cfg/models) download automatically from the latest Ultralytics [release](https://github.com/ultralytics/assets/releases) on first use.
|
||||
|
||||
| Model | size<br><sup>(pixels) | mAP<sup>test<br>50 | Speed<br><sup>CPU ONNX<br>(ms) | Speed<br><sup>T4 TensorRT10<br>(ms) | params<br><sup>(M) | FLOPs<br><sup>(B) |
|
||||
|----------------------------------------------------------------------------------------------|-----------------------|--------------------|--------------------------------|-------------------------------------|--------------------|-------------------|
|
||||
| -------------------------------------------------------------------------------------------- | --------------------- | ------------------ | ------------------------------ | ----------------------------------- | ------------------ | ----------------- |
|
||||
| [YOLO11n-obb](https://github.com/ultralytics/assets/releases/download/v8.3.0/yolo11n-obb.pt) | 1024 | 78.4 | 117.6 ± 0.8 | 4.4 ± 0.0 | 2.7 | 17.2 |
|
||||
| [YOLO11s-obb](https://github.com/ultralytics/assets/releases/download/v8.3.0/yolo11s-obb.pt) | 1024 | 79.5 | 219.4 ± 4.0 | 5.1 ± 0.0 | 9.7 | 57.5 |
|
||||
| [YOLO11m-obb](https://github.com/ultralytics/assets/releases/download/v8.3.0/yolo11m-obb.pt) | 1024 | 80.9 | 562.8 ± 2.9 | 10.1 ± 0.4 | 20.9 | 183.5 |
|
||||
|
|
@ -55,7 +55,7 @@ YOLOv8 pretrained OBB models are shown here, which are pretrained on the [DOTAv1
|
|||
|
||||
## Train
|
||||
|
||||
Train YOLOv8n-obb on the `dota8.yaml` dataset for 100 [epochs](https://www.ultralytics.com/glossary/epoch) at image size 640. For a full list of available arguments see the [Configuration](../usage/cfg.md) page.
|
||||
Train YOLO11n-obb on the `dota8.yaml` dataset for 100 [epochs](https://www.ultralytics.com/glossary/epoch) at image size 640. For a full list of available arguments see the [Configuration](../usage/cfg.md) page.
|
||||
|
||||
!!! example
|
||||
|
||||
|
|
@ -65,9 +65,9 @@ Train YOLOv8n-obb on the `dota8.yaml` dataset for 100 [epochs](https://www.ultra
|
|||
from ultralytics import YOLO
|
||||
|
||||
# Load a model
|
||||
model = YOLO("yolov8n-obb.yaml") # build a new model from YAML
|
||||
model = YOLO("yolov8n-obb.pt") # load a pretrained model (recommended for training)
|
||||
model = YOLO("yolov8n-obb.yaml").load("yolov8n.pt") # build from YAML and transfer weights
|
||||
model = YOLO("yolo11n-obb.yaml") # build a new model from YAML
|
||||
model = YOLO("yolo11n-obb.pt") # load a pretrained model (recommended for training)
|
||||
model = YOLO("yolo11n-obb.yaml").load("yolo11n.pt") # build from YAML and transfer weights
|
||||
|
||||
# Train the model
|
||||
results = model.train(data="dota8.yaml", epochs=100, imgsz=640)
|
||||
|
|
@ -77,13 +77,13 @@ Train YOLOv8n-obb on the `dota8.yaml` dataset for 100 [epochs](https://www.ultra
|
|||
|
||||
```bash
|
||||
# Build a new model from YAML and start training from scratch
|
||||
yolo obb train data=dota8.yaml model=yolov8n-obb.yaml epochs=100 imgsz=640
|
||||
yolo obb train data=dota8.yaml model=yolo11n-obb.yaml epochs=100 imgsz=640
|
||||
|
||||
# Start training from a pretrained *.pt model
|
||||
yolo obb train data=dota8.yaml model=yolov8n-obb.pt epochs=100 imgsz=640
|
||||
yolo obb train data=dota8.yaml model=yolo11n-obb.pt epochs=100 imgsz=640
|
||||
|
||||
# Build a new model from YAML, transfer pretrained weights to it and start training
|
||||
yolo obb train data=dota8.yaml model=yolov8n-obb.yaml pretrained=yolov8n-obb.pt epochs=100 imgsz=640
|
||||
yolo obb train data=dota8.yaml model=yolo11n-obb.yaml pretrained=yolo11n-obb.pt epochs=100 imgsz=640
|
||||
```
|
||||
|
||||
<p align="center">
|
||||
|
|
@ -103,7 +103,7 @@ OBB dataset format can be found in detail in the [Dataset Guide](../datasets/obb
|
|||
|
||||
## Val
|
||||
|
||||
Validate trained YOLOv8n-obb model [accuracy](https://www.ultralytics.com/glossary/accuracy) on the DOTA8 dataset. No arguments are needed as the `model` retains its training `data` and arguments as model attributes.
|
||||
Validate trained YOLO11n-obb model [accuracy](https://www.ultralytics.com/glossary/accuracy) on the DOTA8 dataset. No arguments are needed as the `model` retains its training `data` and arguments as model attributes.
|
||||
|
||||
!!! example
|
||||
|
||||
|
|
@ -113,7 +113,7 @@ Validate trained YOLOv8n-obb model [accuracy](https://www.ultralytics.com/glossa
|
|||
from ultralytics import YOLO
|
||||
|
||||
# Load a model
|
||||
model = YOLO("yolov8n-obb.pt") # load an official model
|
||||
model = YOLO("yolo11n-obb.pt") # load an official model
|
||||
model = YOLO("path/to/best.pt") # load a custom model
|
||||
|
||||
# Validate the model
|
||||
|
|
@ -127,13 +127,13 @@ Validate trained YOLOv8n-obb model [accuracy](https://www.ultralytics.com/glossa
|
|||
=== "CLI"
|
||||
|
||||
```bash
|
||||
yolo obb val model=yolov8n-obb.pt data=dota8.yaml # val official model
|
||||
yolo obb val model=yolo11n-obb.pt data=dota8.yaml # val official model
|
||||
yolo obb val model=path/to/best.pt data=path/to/data.yaml # val custom model
|
||||
```
|
||||
|
||||
## Predict
|
||||
|
||||
Use a trained YOLOv8n-obb model to run predictions on images.
|
||||
Use a trained YOLO11n-obb model to run predictions on images.
|
||||
|
||||
!!! example
|
||||
|
||||
|
|
@ -143,7 +143,7 @@ Use a trained YOLOv8n-obb model to run predictions on images.
|
|||
from ultralytics import YOLO
|
||||
|
||||
# Load a model
|
||||
model = YOLO("yolov8n-obb.pt") # load an official model
|
||||
model = YOLO("yolo11n-obb.pt") # load an official model
|
||||
model = YOLO("path/to/best.pt") # load a custom model
|
||||
|
||||
# Predict with the model
|
||||
|
|
@ -153,7 +153,7 @@ Use a trained YOLOv8n-obb model to run predictions on images.
|
|||
=== "CLI"
|
||||
|
||||
```bash
|
||||
yolo obb predict model=yolov8n-obb.pt source='https://ultralytics.com/images/bus.jpg' # predict with official model
|
||||
yolo obb predict model=yolo11n-obb.pt source='https://ultralytics.com/images/bus.jpg' # predict with official model
|
||||
yolo obb predict model=path/to/best.pt source='https://ultralytics.com/images/bus.jpg' # predict with custom model
|
||||
```
|
||||
|
||||
|
|
@ -172,7 +172,7 @@ See full `predict` mode details in the [Predict](../modes/predict.md) page.
|
|||
|
||||
## Export
|
||||
|
||||
Export a YOLOv8n-obb model to a different format like ONNX, CoreML, etc.
|
||||
Export a YOLO11n-obb model to a different format like ONNX, CoreML, etc.
|
||||
|
||||
!!! example
|
||||
|
||||
|
|
@ -182,7 +182,7 @@ Export a YOLOv8n-obb model to a different format like ONNX, CoreML, etc.
|
|||
from ultralytics import YOLO
|
||||
|
||||
# Load a model
|
||||
model = YOLO("yolov8n-obb.pt") # load an official model
|
||||
model = YOLO("yolo11n-obb.pt") # load an official model
|
||||
model = YOLO("path/to/best.pt") # load a custom trained model
|
||||
|
||||
# Export the model
|
||||
|
|
@ -192,11 +192,11 @@ Export a YOLOv8n-obb model to a different format like ONNX, CoreML, etc.
|
|||
=== "CLI"
|
||||
|
||||
```bash
|
||||
yolo export model=yolov8n-obb.pt format=onnx # export official model
|
||||
yolo export model=yolo11n-obb.pt format=onnx # export official model
|
||||
yolo export model=path/to/best.pt format=onnx # export custom trained model
|
||||
```
|
||||
|
||||
Available YOLOv8-obb export formats are in the table below. You can export to any format using the `format` argument, i.e. `format='onnx'` or `format='engine'`. You can predict or validate directly on exported models, i.e. `yolo predict model=yolov8n-obb.onnx`. Usage examples are shown for your model after export completes.
|
||||
Available YOLO11-obb export formats are in the table below. You can export to any format using the `format` argument, i.e. `format='onnx'` or `format='engine'`. You can predict or validate directly on exported models, i.e. `yolo predict model=yolo11n-obb.onnx`. Usage examples are shown for your model after export completes.
|
||||
|
||||
{% include "macros/export-table.md" %}
|
||||
|
||||
|
|
@ -208,9 +208,9 @@ See full `export` details in the [Export](../modes/export.md) page.
|
|||
|
||||
Oriented Bounding Boxes (OBB) include an additional angle to enhance object localization accuracy in images. Unlike regular bounding boxes, which are axis-aligned rectangles, OBBs can rotate to fit the orientation of the object better. This is particularly useful for applications requiring precise object placement, such as aerial or satellite imagery ([Dataset Guide](../datasets/obb/index.md)).
|
||||
|
||||
### How do I train a YOLOv8n-obb model using a custom dataset?
|
||||
### How do I train a YOLO11n-obb model using a custom dataset?
|
||||
|
||||
To train a YOLOv8n-obb model with a custom dataset, follow the example below using Python or CLI:
|
||||
To train a YOLO11n-obb model with a custom dataset, follow the example below using Python or CLI:
|
||||
|
||||
!!! example
|
||||
|
||||
|
|
@ -220,7 +220,7 @@ To train a YOLOv8n-obb model with a custom dataset, follow the example below usi
|
|||
from ultralytics import YOLO
|
||||
|
||||
# Load a pretrained model
|
||||
model = YOLO("yolov8n-obb.pt")
|
||||
model = YOLO("yolo11n-obb.pt")
|
||||
|
||||
# Train the model
|
||||
results = model.train(data="path/to/custom_dataset.yaml", epochs=100, imgsz=640)
|
||||
|
|
@ -229,18 +229,18 @@ To train a YOLOv8n-obb model with a custom dataset, follow the example below usi
|
|||
=== "CLI"
|
||||
|
||||
```bash
|
||||
yolo obb train data=path/to/custom_dataset.yaml model=yolov8n-obb.pt epochs=100 imgsz=640
|
||||
yolo obb train data=path/to/custom_dataset.yaml model=yolo11n-obb.pt epochs=100 imgsz=640
|
||||
```
|
||||
|
||||
For more training arguments, check the [Configuration](../usage/cfg.md) section.
|
||||
|
||||
### What datasets can I use for training YOLOv8-OBB models?
|
||||
### What datasets can I use for training YOLO11-OBB models?
|
||||
|
||||
YOLOv8-OBB models are pretrained on datasets like [DOTAv1](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/DOTAv1.yaml) but you can use any dataset formatted for OBB. Detailed information on OBB dataset formats can be found in the [Dataset Guide](../datasets/obb/index.md).
|
||||
YOLO11-OBB models are pretrained on datasets like [DOTAv1](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/DOTAv1.yaml) but you can use any dataset formatted for OBB. Detailed information on OBB dataset formats can be found in the [Dataset Guide](../datasets/obb/index.md).
|
||||
|
||||
### How can I export a YOLOv8-OBB model to ONNX format?
|
||||
### How can I export a YOLO11-OBB model to ONNX format?
|
||||
|
||||
Exporting a YOLOv8-OBB model to ONNX format is straightforward using either Python or CLI:
|
||||
Exporting a YOLO11-OBB model to ONNX format is straightforward using either Python or CLI:
|
||||
|
||||
!!! example
|
||||
|
||||
|
|
@ -250,7 +250,7 @@ Exporting a YOLOv8-OBB model to ONNX format is straightforward using either Pyth
|
|||
from ultralytics import YOLO
|
||||
|
||||
# Load a model
|
||||
model = YOLO("yolov8n-obb.pt")
|
||||
model = YOLO("yolo11n-obb.pt")
|
||||
|
||||
# Export the model
|
||||
model.export(format="onnx")
|
||||
|
|
@ -259,14 +259,14 @@ Exporting a YOLOv8-OBB model to ONNX format is straightforward using either Pyth
|
|||
=== "CLI"
|
||||
|
||||
```bash
|
||||
yolo export model=yolov8n-obb.pt format=onnx
|
||||
yolo export model=yolo11n-obb.pt format=onnx
|
||||
```
|
||||
|
||||
For more export formats and details, refer to the [Export](../modes/export.md) page.
|
||||
|
||||
### How do I validate the accuracy of a YOLOv8n-obb model?
|
||||
### How do I validate the accuracy of a YOLO11n-obb model?
|
||||
|
||||
To validate a YOLOv8n-obb model, you can use Python or CLI commands as shown below:
|
||||
To validate a YOLO11n-obb model, you can use Python or CLI commands as shown below:
|
||||
|
||||
!!! example
|
||||
|
||||
|
|
@ -276,7 +276,7 @@ To validate a YOLOv8n-obb model, you can use Python or CLI commands as shown bel
|
|||
from ultralytics import YOLO
|
||||
|
||||
# Load a model
|
||||
model = YOLO("yolov8n-obb.pt")
|
||||
model = YOLO("yolo11n-obb.pt")
|
||||
|
||||
# Validate the model
|
||||
metrics = model.val(data="dota8.yaml")
|
||||
|
|
@ -285,7 +285,7 @@ To validate a YOLOv8n-obb model, you can use Python or CLI commands as shown bel
|
|||
=== "CLI"
|
||||
|
||||
```bash
|
||||
yolo obb val model=yolov8n-obb.pt data=dota8.yaml
|
||||
yolo obb val model=yolo11n-obb.pt data=dota8.yaml
|
||||
```
|
||||
|
||||
See full validation details in the [Val](../modes/val.md) section.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue