Erste Schritte

Bildklassifizierung mit Ultralytics YOLO

Ultralytics YOLO image classification of leaves as healthy, rust, or powdery mildew

Die Bildklassifizierung ist die einfachste der unterstützten Aufgaben. Dabei wird ein ganzes Bild einer von mehreren vordefinierten Klassen zugeordnet.

Die Ausgabe eines Bildklassifikators besteht aus einer einzelnen Klassenbezeichnung und einem Konfidenzwert. Die Bildklassifizierung ist nützlich, wenn du nur wissen musst, zu welcher Klasse ein Bild gehört, aber nicht, wo sich Objekte dieser Klasse befinden oder welche genaue Form sie haben.



Ansehen: Entdecke die Aufgaben von Ultralytics YOLO: Bildklassifizierung mit der Ultralytics-Plattform
Tipp

YOLO26-Classify-Modelle verwenden das Suffix -cls, z. B. yolo26n-cls.pt, und sind mit ImageNet vortrainiert.

Modelle#

Unten findest du YOLO26-Classify-Modelle, die mit dem Datensatz ImageNet vortrainiert wurden.

Modelle werden bei der ersten Verwendung automatisch aus der neuesten Ultralytics-Version heruntergeladen.

ModellGröße
(Pixel)
acc
top1
acc
top5
Geschwindigkeit
CPU ONNX
(ms)
Geschwindigkeit
T4 TensorRT10
(ms)
Parameter
(M)
FLOPs
(B) bei 224
YOLO26n-cls22471.490.15.0 ± 0.31.1 ± 0.02.80.4
YOLO26s-cls22476.092.97.9 ± 0.21.3 ± 0.06.71.5
YOLO26m-cls22478.194.217.2 ± 0.42.0 ± 0.011.64.8
YOLO26l-cls22479.094.623.2 ± 0.32.8 ± 0.014.16.0
YOLO26x-cls22479.995.041.4 ± 0.93.8 ± 0.029.613.5
  • Die Werte für acc geben die Modellgenauigkeit auf dem Validierungssatz des Datensatzes ImageNet an.
    Reproduziere die Ergebnisse mit yolo classify val data=path/to/ImageNet device=0
  • Geschwindigkeit, gemittelt über die Validierungsbilder von ImageNet mit ONNX auf CPU und TensorRT10 auf einer NVIDIA-T4-GPU.
    Reproduziere die Ergebnisse mit yolo classify val data=path/to/ImageNet batch=1 device=0|cpu
  • Die Werte für Parameter und FLOPs gelten für das fusionierte Modell nach model.fuse(), wodurch Conv- und BatchNorm-Schichten zusammengeführt werden. Vortrainierte Checkpoints behalten die vollständige Trainingsarchitektur bei und können daher höhere Werte aufweisen.

Sieh dir die unveröffentlichte YOLO27-Vorschau mit vorläufigen Angaben zu Klassifizierungsgeschwindigkeit und Modellgrößen an.

Trainieren#

Trainiere ein YOLO26n-cls-Modell 100 Epochen lang mit Bildgröße 64 auf dem MNIST160-Datensatz.

Beispiel
from ultralytics import YOLO

# Ein Modell laden
model = YOLO("yolo26n-cls.yaml")  # ein neues Modell aus YAML erstellen
model = YOLO("yolo26n-cls.pt")  # ein vortrainiertes Modell laden (für das Training empfohlen)
model = YOLO("yolo26n-cls.yaml").load("yolo26n-cls.pt")  # aus YAML erstellen und Gewichte übertragen

# Das Modell trainieren
results = model.train(data="mnist160", epochs=100, imgsz=64)

Ausführliche Informationen zum Modus train findest du auf der Seite Trainieren. Klassifizierungsmodelle lassen sich auch mit dem Cloud-Training der Ultralytics Platform trainieren.

Datensatzformat#

Ausführliche Informationen zum Format von YOLO-Klassifizierungsdatensätzen findest du im Datensatzleitfaden. Klassifizierungsdatensätze lassen sich außerdem mit den Anmerkungswerkzeugen der Ultralytics Platform verwalten und beschriften.

Benutzerdefinierte Transformationen#

Die Ultralytics YOLO-Klassifizierung verwendet torchvision.transforms.RandomResizedCrop zum Training und torchvision.transforms.CenterCrop zur Validierung und Inferenz. Diese zuschnittbasierten Transformationen setzen quadratische Eingaben voraus und können bei Bildern mit extremen Seitenverhältnissen wichtige Bereiche abschneiden. Um das ganze Bild ohne Verzerrung beizubehalten, ersetze die Zuschnitte durch die vorhandene Transformation ClassifyLetterBox, die jedes Bild so skaliert, dass es in imgsz × imgsz passt, und den verbleibenden Bereich unter Beibehaltung des Seitenverhältnisses auffüllt. Verwende sie in der PIL-basierten torchvision-Pipeline mit einem benutzerdefinierten ClassificationDataset, ClassificationTrainer und ClassificationValidator:

import numpy as np
import torch
import torchvision.transforms as T

from ultralytics import YOLO
from ultralytics.data.augment import ClassifyLetterBox
from ultralytics.data.dataset import ClassificationDataset
from ultralytics.models.yolo.classify import ClassificationTrainer, ClassificationValidator

class CustomizedDataset(ClassificationDataset):
    """A customized dataset class for image classification with enhanced data augmentation transforms."""

    def __init__(self, root: str, args, augment: bool = False, prefix: str = "", names=None):
        """Initialize a customized classification dataset with enhanced data augmentation transforms."""
        super().__init__(root, args, augment, prefix, names)
        letterbox = T.Compose([np.asarray, ClassifyLetterBox(args.imgsz), T.ToPILImage()])

        # Füge hier deine benutzerdefinierten Transformationen für das Training hinzu
        train_transforms = T.Compose(
            [
                letterbox,
                T.RandomHorizontalFlip(p=args.fliplr),
                T.RandomVerticalFlip(p=args.flipud),
                T.RandAugment(interpolation=T.InterpolationMode.BILINEAR),
                T.ColorJitter(brightness=args.hsv_v, contrast=args.hsv_v, saturation=args.hsv_s, hue=args.hsv_h),
                T.ToTensor(),
                T.Normalize(mean=torch.tensor(0), std=torch.tensor(1)),
                T.RandomErasing(p=args.erasing, inplace=True),
            ]
        )

        # Füge hier deine benutzerdefinierten Transformationen für die Validierung hinzu
        val_transforms = T.Compose(
            [
                letterbox,
                T.ToTensor(),
                T.Normalize(mean=torch.tensor(0), std=torch.tensor(1)),
            ]
        )
        self.torch_transforms = train_transforms if augment else val_transforms

class CustomizedTrainer(ClassificationTrainer):
    """A customized trainer class for YOLO classification models with enhanced dataset handling."""

    def build_dataset(self, img_path: str, mode: str = "train", batch=None):
        """Build a customized dataset for classification training and the validation during training."""
        return CustomizedDataset(
            root=img_path,
            args=self.args,
            augment=mode == "train",
            prefix="train" if mode == "train" else self.args.split,
            names=self.data["names"],
        )

class CustomizedValidator(ClassificationValidator):
    """A customized validator class for YOLO classification models with enhanced dataset handling."""

    def build_dataset(self, img_path: str):
        """Build a customized dataset for classification standalone validation (no augmentation)."""
        return CustomizedDataset(root=img_path, args=self.args, augment=False, prefix=self.args.split, names=self.names)

model = YOLO("yolo26n-cls.pt")
model.train(data="imagenet", trainer=CustomizedTrainer, epochs=10, imgsz=224, batch=64)
model.val(data="imagenet", validator=CustomizedValidator, imgsz=224, batch=64)

Validieren#

Validiere die Genauigkeit eines trainierten YOLO26n-cls-Modells. Es sind keine Argumente erforderlich, da model die Trainingsdaten data und die Argumente als Modelleigenschaften speichert: path/to/best.pt aus dem Beispiel für Trainieren validiert das Modell anhand von MNIST160. Bei offiziellen Gewichten ist ein Trainingsdatenpfad gespeichert, der auf deinem Rechner nicht existiert. Daher wird mit einer Warnung auf den Aufgabenstandardwert imagenet10 zurückgegriffen. Übergib data, um einen anderen Datensatz für die Validierung zu verwenden.

Beispiel
from ultralytics import YOLO

# Ein Modell laden
model = YOLO("yolo26n-cls.pt")  # Ein offizielles Modell laden
model = YOLO("path/to/best.pt")  # Ein benutzerdefiniertes Modell laden

# Das Modell validieren
metrics = model.val()  # Keine Argumente erforderlich, Datensatz und Einstellungen werden gespeichert
metrics.top1  # top1 accuracy
metrics.top5  # top5 accuracy
Tipp

Bei einem Modell, das mit benutzerdefinierten Transformationen trainiert wurde, musst du das dazu passende ClassificationValidator an val() übergeben. Andernfalls werden bei der Validierung Bereiche zugeschnitten, obwohl sie beim Training skaliert wurden.

Vorhersagen#

Nutze ein trainiertes YOLO26n-cls-Modell, um Vorhersagen für Bilder auszuführen.

Beispiel
from ultralytics import YOLO

# Ein Modell laden
model = YOLO("yolo26n-cls.pt")  # Ein offizielles Modell laden
model = YOLO("path/to/best.pt")  # Ein benutzerdefiniertes Modell laden

# Mit dem Modell Vorhersagen erstellen
results = model("https://ultralytics.com/images/bus.jpg")  # Eine Vorhersage für ein Bild erstellen

# Auf die Ergebnisse zugreifen
for result in results:
    top1 = result.probs.top1  # ID der vorhergesagten Hauptklasse
    top1_conf = result.probs.top1conf  # Konfidenz der obersten Vorhersage
    top1_name = result.names[top1]  # Name der vorhergesagten Hauptklasse

Ausführliche Informationen zum Modus predict findest du auf der Seite Vorhersagen.

Ausgabe der Ergebnisse#

Die Bildklassifizierung gibt für jedes Bild ein Results-Objekt zurück. Das wichtigste Vorhersagefeld ist result.probs. Es enthält den Klassenwahrscheinlichkeitsvektor und Hilfsfunktionen für die besten Vorhersagen.

AttributTypFormBeschreibung
result.probsProbs(C,)Klassenwahrscheinlichkeiten.
result.probs.datatorch.float32(C,)Wahrscheinlichkeit pro Klasse.
result.probs.top1int()ID der obersten Klasse.
result.probs.top1conftorch.float32()Höchster Konfidenzwert.
result.probs.top5list[int](<=5)IDs der fünf Klassen mit den höchsten Werten.

Task-spezifische Results-Felder für alle Aufgaben findest du im Abschnitt Vorhersageergebnisse nach Aufgabe.

Exportieren#

Ein YOLO26n-cls-Modell in ein anderes Format wie ONNX oder CoreML exportieren

Beispiel
from ultralytics import YOLO

# Ein Modell laden
model = YOLO("yolo26n-cls.pt")  # Ein offizielles Modell laden
model = YOLO("path/to/best.pt")  # Ein benutzerdefiniertes Modell laden

# Modell exportieren
model.export(format="onnx")

Die verfügbaren Exportformate für YOLO26-cls sind in der folgenden Tabelle aufgeführt. Du kannst mit dem Argument format in jedes Format exportieren, z. B. mit format='onnx' oder format='engine'. Du kannst Vorhersagen direkt mit exportierten Modellen erstellen oder sie validieren, zum Beispiel mit yolo predict model=yolo26n-cls.onnx. Nach Abschluss des Exports werden Anwendungsbeispiele für dein Modell angezeigt.

FormatArgument formatModellMetadatenArgumente
PyTorch-yolo26n-cls.pt✅-
TorchScripttorchscriptyolo26n-cls.torchscript✅imgsz, quantize, dynamic, nms, batch, device
ONNXonnxyolo26n-cls.onnx✅imgsz, quantize, dynamic, simplify, opset, nms, batch, data, fraction, device
OpenVINOopenvinoyolo26n-cls_openvino_model/✅imgsz, quantize, dynamic, nms, batch, data, fraction, device
TensorRTengineyolo26n-cls.engine✅imgsz, quantize, dynamic, simplify, opset, workspace, nms, batch, data, fraction, device
CoreMLcoremlyolo26n-cls.mlpackage✅imgsz, dynamic, quantize, nms, batch, device
Apple Core AIcoreaiyolo26n-cls.aimodel✅imgsz, batch, quantize
TF SavedModelsaved_modelyolo26n-cls_saved_model/✅imgsz, quantize, opset, nms, batch, data, fraction, device
TF GraphDefpbyolo26n-cls.pb❌imgsz, opset, batch, device
TF Edge TPUedgetpuyolo26n-cls_edgetpu.tflite✅imgsz, quantize, opset, data, fraction, device
LiteRTlitertyolo26n-cls.tflite✅imgsz, quantize, batch, data, fraction, device
PaddlePaddlepaddleyolo26n-cls_paddle_model/✅imgsz, batch, device
MNNmnnyolo26n-cls.mnn✅imgsz, batch, dynamic, quantize, simplify, opset, nms, device
NCNNncnnyolo26n-cls_ncnn_model/✅imgsz, quantize, device
IMX500imxyolo11n_imx_model/✅imgsz, quantize, data, fraction, nms, device
RKNNrknnyolo26n-cls_rknn_model/✅imgsz, batch, name, quantize, simplify, opset, data, fraction, device
ExecuTorchexecutorchyolo26n-cls_executorch_model/✅imgsz, quantize, batch, data, fraction, device
Axeleraaxelerayolo26n-cls_axelera_model/✅imgsz, batch, quantize, data, fraction, device
DEEPXdeepxyolo26n-cls_deepx_model/✅imgsz, quantize, simplify, opset, data, optimize, device
Qualcomm QNNqnnyolo26n-cls_qnn.onnx✅imgsz, batch, name, quantize, simplify, opset, data, fraction, device
Hailohailoyolo26n-cls_hailo_model/✅imgsz, name, quantize, data, fraction, simplify, conf, iou, device
Huawei Ascendascendyolo26n-cls_ascend_model/✅imgsz, batch, name, quantize, opset, simplify, nms, device
AMD Xilinxxilinxyolo26n-cls_xilinx_model/✅imgsz, name, quantize, data, fraction, opset, simplify, device
NXPnxpyolo26n-cls_nxp.tflite✅imgsz, quantize, data, fraction, device
ST Edge AIstedgeaiyolo26n-cls_stedgeai.onnx✅imgsz, quantize, data, fraction, opset, simplify, device

nms=None gibt standardmäßig Rohdaten für externe NMS aus (YOLO26 behält seinen Kopf ohne NMS auf Axelera). Setze nms=False, um einen verfügbaren Kopf ohne NMS auszuwählen; nicht unterstützte Formate greifen auf ihren nativen Ausgabepfad zurück. Die oben aufgeführten Einträge für nms kennzeichnen Formate, die NMS mit nms=True einbetten können.

Ausführliche Informationen zu export findest du auf der Seite Export.

Häufig gestellte Fragen#

  • YOLO26-Modelle wie yolo26n-cls.pt sind für eine effiziente Bildklassifizierung ausgelegt. Sie weisen einem ganzen Bild eine einzelne Klassenbezeichnung und einen Konfidenzwert zu. Das ist nützlich, wenn die Kenntnis der Bildklasse ausreicht und du weder den Ort noch die Form der darin enthaltenen Objekte benötigst.

  • Du kannst ein YOLO26-Modell mit Python oder über CLI-Befehle trainieren. So trainierst du zum Beispiel ein Modell yolo26n-cls mit dem Datensatz MNIST160 100 Epochen lang bei einer Bildgröße von 64:

    Beispiel
    from ultralytics import YOLO
    
    # Ein Modell laden
    model = YOLO("yolo26n-cls.pt")  # ein vortrainiertes Modell laden (für das Training empfohlen)
    
    # Das Modell trainieren
    results = model.train(data="mnist160", epochs=100, imgsz=64)

    Weitere Konfigurationsoptionen findest du auf der Seite Konfiguration.

  • Auf der Ultralytics Platform kannst du vortrainierte YOLO26-Klassifizierungsmodelle durchsuchen, testen und herunterladen. Modelle wie yolo26n-cls.pt, yolo26s-cls.pt und yolo26m-cls.pt sind mit dem Datensatz ImageNet vortrainiert und werden bei der ersten Verwendung automatisch heruntergeladen.

  • Um die Genauigkeit eines trainierten Modells anhand eines Datensatzes wie MNIST160 zu validieren, kannst du die folgenden Python- oder CLI-Befehle verwenden:

    Beispiel
    from ultralytics import YOLO
    
    # Ein Modell laden
    model = YOLO("path/to/best.pt")  # das trainierte Modell laden
    
    # Das Modell validieren
    metrics = model.val()  # keine Argumente erforderlich, verwendet den Datensatz und die Einstellungen aus dem Training
    metrics.top1  # top1 accuracy
    metrics.top5  # top5 accuracy

    Weitere Informationen findest du im Abschnitt Validierung.

  • Du kannst ein trainiertes YOLO26-Modell mit Python- oder CLI-Befehlen in verschiedene Formate exportieren. Zum Beispiel kannst du ein Modell so in das ONNX-Format exportieren:

    Beispiel
    from ultralytics import YOLO
    
    # Ein Modell laden
    model = YOLO("yolo26n-cls.pt")  # das trainierte Modell laden
    
    # Das Modell nach ONNX exportieren
    model.export(format="onnx")

    Ausführliche Informationen zu den Exportoptionen findest du auf der Seite Export.

Kommentare207

Stell eine Frage, teile deine Ergebnisse oder hilf jemand anderem.

  1. hellotenetGitHub

    According to my observation, during the training of YOLO for classification tasks, it randomly selects a portion of data from the test set to evaluate the accuracy of this round. If I want to use all the data in the test set for testing in each epoch and provide top_acc1 and top_acc5, which parameter should I add in the yaml file?

    1
  2. eladoni1GitHub(bearbeitet)

    Hi there! Quick briefing - the images are of size Width = 1216, Height = 292.

    TL;DR - After debug into train.py & predict.py, realized the images are resized + cropped strangely from what I gathered in the docs/forums, even with specified imgsz and rect=True.

    Full explanation -

    Training was : model.train(data=..., imgsz=1216, rect=True)

    Expectations : Was expecting the dataset images to be resized BY THE LARGER side, so 1216 will remain 1216, and so is the smaller side.

    (Even when I tried to do imgsz as a tuple - (h,w) aka (292,1216), a warning showed up, telling me the imgsz will be automatically selected to 1216, as it should have been an integer.. not a tuple.)

    What actually happened : What happened is the smaller side (height, 292) resized to 1216, then the original, bigger side (width, 1216), was resized to 5063 (same scalar the smaller side was multiplied).

    Meaning, what previously was image of size 1216x292, turned into image of size 5063x1216 (This is due to Resize transformation of pytorch)

    And its not over - the data taken was only the INNER 1216x1216 - less than 1/4 of the actual data.. (This is due to CenterCrop transformation of pytorch)

    So, basically, I am asking - Is there a quote from the docs I have missed that said classify must be square sized? Or is there another way (except from padding to 1216x1216 - adding 924 black pixels to the height), to make classify work with rectangular images?

    Thank you so much, and sorry if I wasnt clear.. hopefully it was.

    1
    1. Glenn JocherUltralytics

      Hey there! 🙌 Thanks for the detailed message.

      It seems like you've encountered an interesting scenario with image sizes and the rect=True parameter. In YOLOv8, when using rectangular training (rect=True), the model does expect square input sizes for simplicity and efficiency. The behavior you've noticed, where the smaller dimension gets resized to match the specified imgsz, and then the image is center-cropped, is by design for handling non-square inputs.

      For your specific case with rectangular images (1216x292), instead of resizing or padding the images manually to make them square, a recommended approach is to work with the default behavior but ensure your imgsz is set to the dimension that avoids data loss. If further customization is necessary, it might involve custom modifications to the data preprocessing pipeline.

      Unfortunately, there isn't a built-in switch for direct handling of non-square images without cropping or resizing as you described. This is an area for potential improvement in future updates!

      For now, perhaps consider either adjusting your pipeline to accommodate this behavior or implementing a custom preprocessing step that ensures your images maintain their aspect ratio without significant data loss. Padding might be an unavoidable step for cases like these.

      If there's anything else we can help with or if you have suggestions, feel free to reach out. Thanks for diving deep into this, and we're here to support your projects! 🚀

  3. lixjohnGitHub

    If I can train Yolo-cls mode to identify the level of object moisture content? Such as coal? Thanks.

    1. Glenn JocherUltralytics

      Yes, Ultralytics YOLO26 classification can work for coal moisture levels if you label them as discrete classes like dry, medium, and wet and train with the standard classification dataset format; if you need an exact moisture percentage rather than bins, that’s a regression problem, and if the visual differences are subtle you may need NIR/thermal imaging instead of RGB alone.

    2. lixjohnGitHub

      Thanks, I think classification is enough because we just need high level of coal moisture not exact percentage.

    3. Glenn JocherUltralytics

      Yes, that should be a good fit for classify; use a few clear bins like low, medium, and high, keep lighting/camera distance as consistent as possible, and start from a pretrained yolo26n-cls.pt model—if you’d like, share a sample class layout or training command here and we can sanity-check it.

    4. lixjohnGitHub

      Thank you very much, that makes sense. I just start project and not go to training phase yet, but I am happy to share sample and training command once I have to get more help on this.

    5. Glenn JocherUltralytics

      Sounds good—when you reach training, share your dataset folder structure and exact yolo classify train ... command here, and we’ll help sanity-check it against the classification guide.

    6. lixjohnGitHub

      Thank you! I got another question related to segment, hopefully I can get your suggestion as well, it is a little bit tricky :-). The coal is very small ( around 10mm one piece), but we have identify them in a truck (10m*3m) in order to ensure the truck carry right size of coal, one picture for one truck, it means there are huge member of small coal in one picture, I don't have image resolution yet, but I suppose it is clear enough to show details for each coal, my questions are

      1. how to label data before training, I can use SAM to label each coal but I have to say it is impossible to label all coal in picture because the coal member is huge, if I can just label some of them in pictures? I think we can use around 300 pictures to start training, but not all coal labeled in one picture. Does it will impact accuracy of model?
      2. Is it possible for Yolo26-segment to identify each coal in this situation from algorithm and performance point of view? In one picture, the truck is big but carry large member of similar small objects (10mm vs. 10m). Any solution we can take for this situation?

      Apricate for any suggestions...

    7. Glenn JocherUltralytics

      Yes, but you should not leave visible coals unlabeled in training images because the model will treat them as background and recall will drop; for this kind of dense small-object problem, the practical approach is to split each truck image into smaller overlapping tiles, fully annotate every visible coal inside the selected tiles, and train on those crops rather than the full frame. If each coal is still only a few pixels after tiling, segment will struggle and detect or even patch-level classify may be a better fit, and our data collection and annotation guide is a good reference—feel free to post one sample image here when you have it and we can suggest the best labeling strategy.

  4. jiangshouyeGitHub

    如何指定分类标签的次序呢?训练完成后,如何获得模型里的标签顺序呢?

    1. Glenn JocherUltralytics

      分类任务里类别索引顺序是从你的数据集目录结构推断出来的(通常按 train/ 下各类别子文件夹名称排序生成),如果你想“指定顺序”,最稳妥的方法是把类别文件夹命名成可排序的形式(例如 00_cat/、01_dog/);训练完成后直接读取模型里的 model.names 就能看到标签到索引的对应关系,参考 图像分类文档。

      from ultralytics import YOLO
      
      model = YOLO("runs/classify/train/weights/best.pt")
      print(model.names)  # {0: '00_cat', 1: '01_dog', ...}
  5. serenamansurGitHub

    hello, hope all is well. @glenn-jocher i would like to ask you few questions

    1- in classification task , when finetuning YOLOv11m-cls, is it enough to set "autoaugment" for data augmentation or i can use it with other augmentation args such as scale, hsv_v, hsv_s ??


    2- i will give you an example on this one, lets say i am training with epoch = 50 with patience = 8 and close_mosaic i set to = 5 and early stopping occured at epoch 20/50.

    Is close_mosaic applied here or is it set from the start that it should be disabled at epoch 45? and if it was disabled before epoch 20, how does this affect the result and validation?

    Thank you in advance!!

    1. Glenn JocherUltralytics

      For classify, auto_augment can be used together with other augmentation args like scale and hsv_h/hsv_s/hsv_v (they target different parts of the classification transform pipeline), but since policies like randaugment are already quite strong you’ll usually want to keep extra color jitter mild and tune one knob at a time; see the Image Classification docs and the classification transforms/augmentations reference.

      Also note close_mosaic is a mosaic-specific setting for detection-style tasks and isn’t used for *-cls training, so it won’t affect YOLO classification; if you meant detection, close_mosaic=5 disables mosaic only for the last 5 scheduled epochs (i.e., starting at epochs - close_mosaic), so if early stopping ends at epoch 20/50 that “close mosaic” switch never occurs.

    2. serenamansurGitHub

      Hello @glenn-jocher, Thank you for your previous reply, it was very helpful. I have another question related to class imbalance in computer vision tasks. In many ML setups, when classes are imbalanced, we apply per-class loss weights so that rare classes contribute more to the overall training loss and are not ignored during optimization.

      For example, if I have 3 detection classes with instance counts like:

      class0 = 30 instances class1 = 500 instances class2 = 700 instances

      By default, all classes contribute equally (weight = 1), but ideally I’d like to assign a higher weight to the rare class (class0).


      My question: Is there a supported way in Ultralytics YOLO to apply per-class weights for the detection classification loss or bounding boxes loss (cls loss component)? If yes, where can I access and modify those weights?? Thank you in advance!

    3. Glenn JocherUltralytics

      At the moment Ultralytics YOLO doesn’t have a supported “per-class loss weight” hook for detection via data.yaml/CLI (for cls_loss or box losses); the only built-in knobs are the overall loss term weights like cls, box, and dfl in the configuration settings. If you need true per-class weighting you’ll have to implement it in a custom trainer/loss (the core detection loss lives in the loss implementation and can be swapped via the advanced customization guide); otherwise the practical workaround is to rebalance the dataset by oversampling/adding/augmenting the rare-class examples.

    4. maxexplorerGitHub

      Hi Ultralytics team, YOLO-classify always outputs class probabilities (probs) that sum to 1, even for completely unknown or out-of-distribution (OOD) inputs. As a result, unknown objects can be classified with high confidence (e.g., 0.8), and using a threshold does not always filter them. Are there any recommended strategies, best practices, or built-in options to reduce false high-confidence predictions on unknown data?
      Would combining classify with detect help in such cases? Thanks!

    5. Glenn JocherUltralytics

      You’re right: *-cls uses a softmax-style head, so the returned probs are normalized to sum to 1 by design, which means “unknown/OOD” will still get forced into a known class with some confidence; there isn’t a built-in OOD/reject option in Ultralytics YOLO classification today (beyond simple thresholding). A practical approach is to (a) add an explicit unknown (or “background”) class with diverse negative examples and train for rejection, and/or (b) run a detection model first and only classify detected crops—if nothing is detected you can safely treat the frame as unknown; see the Ultralytics YOLO image classification docs for the standard classify pipeline.

      If you want a lightweight post-process, you can gate predictions using max-softmax and an uncertainty score like entropy (often works better than max-prob alone):

      from ultralytics import YOLO
      import torch
      
      model = YOLO("yolo26n-cls.pt")
      results = model("path/to/img.jpg")
      
      r = results[0]
      p = r.probs.data  # class probabilities (tensor)
      max_p = float(p.max())
      entropy = float(-(p * (p + 1e-12).log()).sum())
      
      is_unknown = (max_p < 0.6) or (entropy > 2.5)  # tune on a held-out OOD set
  6. sagargwalGitHub

    is thier a way to use grad cam or any interpretability? method on yolov11-cls model

  7. theoderickdayGitHub

    Hi I have a simple bit of code based on your example above and using a model I created myself. It works fine at identifying birds and I get output of the form:-

    0: 640x640 nut_hatch 0.30, house_sparrow 0.18, bluetit 0.17, cat 0.13, robin 0.12, 273.5ms Speed: 29.8ms preprocess, 273.5ms inference, 0.1ms postprocess per image at shape (1, 3, 640, 640) 2025-10-27.jpg

    I use the following lines to pass data from the Raspberry PI camera to the model:-

    frame = picam2.capture_array() results = model(frame)

    what I want to do is extract the probabilities from the results structure so I can save specific images when the prediction is over say 80%

    Any ideas?

  8. wdcs-fenilpatelGitHub

    @glenn-jocher

    I'm encountering a strange and seemingly unpredictable issue during inference with a YOLO classification model (using ultralytics package). The confidence score for every prediction is always exactly 0.5, regardless of the input image.

    All inference results return confidence = 0.5.

    The predicted class index might vary, but the confidence is always 0.5.

    This issue starts unpredictably—everything works fine for a while, then suddenly this behavior appears.

    Sometimes, simply rebooting the system resolves the issue temporarily, but it may reappear.

  9. Ranjith3436GitHub

    I am trying to train classification model. why you prefer you architecture. why don't you move transformer architecture? is it capable than ViT.

  10. wowosoGitHub

    What if we can't obtain metrics such as F1 score, mAP, recall, and precision in image classification tasks?