Erweiterte Anpassung#
Sowohl die Ultralytics YOLO-Befehlszeilen- als auch die Python-Schnittstellen sind High-Level-Abstraktionen, die auf Basis-Engine-Executors aufbauen. Dieser Leitfaden konzentriert sich auf die Trainer-Engine und erklärt, wie du sie an deine spezifischen Anforderungen anpassen kannst.
Watch: Mastering Ultralytics YOLO: Advanced Customization
Praktische Beispiele für gängige Trainer-Anpassungen – wie benutzerdefinierte Metriken, klassengewichtete Verluste, Modellabspeicherung, Backbone-Einfrieren und schichtspezifische Lernraten – findest du im Leitfaden Customizing Trainer.
BaseTrainer#
Die Klasse BaseTrainer stellt eine generische Trainingsroutine bereit, die für verschiedene Aufgaben angepasst werden kann. Passe sie an, indem du bestimmte Funktionen oder Operationen überschreibst und dabei die erforderlichen Formate einhältst. Integriere beispielsweise dein eigenes benutzerdefiniertes Modell und deinen eigenen Dataloader, indem du diese Funktionen überschreibst:
get_model(cfg, weights): Erstellt das zu trainierende Modell.get_dataloader(): Erstellt den Dataloader.
Weitere Details und den Quellcode findest du in der BaseTrainer Reference.
DetectionTrainer#
So verwendest und passt du das Ultralytics YOLO DetectionTrainer an:
from ultralytics.models.yolo.detect import DetectionTrainer
trainer = DetectionTrainer(overrides={...})
trainer.train()
trained_model = trainer.best # Get the best modelAnpassen des DetectionTrainer#
Um ein benutzerdefiniertes Erkennungsmodell zu trainieren, das nicht direkt unterstützt wird, überschreibe die bestehende get_model-Funktionalität:
from ultralytics.models.yolo.detect import DetectionTrainer
class CustomTrainer(DetectionTrainer):
def get_model(self, cfg=None, weights=None, verbose=True):
"""Loads a custom detection model given configuration and weight files."""
trainer = CustomTrainer(overrides={...})
trainer.train()Passe den Trainer weiter an, indem du die loss function änderst oder einen callback hinzufügst, um das Modell alle 10 epochs auf Google Drive hochzuladen. Hier ist ein Beispiel:
from ultralytics.models.yolo.detect import DetectionTrainer
from ultralytics.nn.tasks import DetectionModel
class MyCustomModel(DetectionModel):
def init_criterion(self):
"""Initializes the loss function and adds a callback for uploading the model to Google Drive every 10 epochs."""
class CustomTrainer(DetectionTrainer):
def get_model(self, cfg=None, weights=None, verbose=True):
"""Returns a customized detection model instance configured with specified config and weights."""
return MyCustomModel(...)
# Callback to upload model weights
def log_model(trainer):
"""Logs the path of the last model weight used by the trainer."""
last_weight_path = trainer.last
print(last_weight_path)
trainer = CustomTrainer(overrides={...})
trainer.add_callback("on_train_epoch_end", log_model) # Adds to existing callbacks
trainer.train()Weitere Informationen zu Callback-Auslösern und Einstiegspunkten findest du im Callbacks Guide.
Weitere Engine-Komponenten#
Passe andere Komponenten wie Validators und Predictors auf ähnliche Weise an. Weitere Informationen findest du in der Dokumentation für Validators und Predictors.
Verwendung von YOLO mit benutzerdefinierten Trainern#
Die Modellklasse YOLO bietet einen High-Level-Wrapper für Trainer-Klassen. Du kannst diese Architektur für eine größere Flexibilität in deinen Machine-Learning-Workflows nutzen:
from ultralytics import YOLO
from ultralytics.models.yolo.detect import DetectionTrainer
# Create a custom trainer
class MyCustomTrainer(DetectionTrainer):
def get_model(self, cfg=None, weights=None, verbose=True):
"""Custom code implementation."""
# Initialize YOLO model
model = YOLO("yolo26n.pt")
# Train with custom trainer
results = model.train(trainer=MyCustomTrainer, data="coco8.yaml", epochs=3)Dieser Ansatz ermöglicht es dir, die Einfachheit der YOLO-Schnittstelle beizubehalten und gleichzeitig den zugrunde liegenden Trainingsprozess an deine spezifischen Anforderungen anzupassen.
FAQ#
Passe
DetectionTrainerfür spezifische Aufgaben an, indem du seine Methoden überschreibst, um sie an dein benutzerdefiniertes Modell und deinen Dataloader anzupassen. Beginne damit, vonDetectionTrainerzu erben, und definiere Methoden wieget_modelneu, um benutzerdefinierte Funktionalitäten zu implementieren. Hier ist ein Beispiel:from ultralytics.models.yolo.detect import DetectionTrainer class CustomTrainer(DetectionTrainer): def get_model(self, cfg=None, weights=None, verbose=True): """Loads a custom detection model given configuration and weight files.""" trainer = CustomTrainer(overrides={...}) trainer.train() trained_model = trainer.best # Get the best modelFür weitere Anpassungen, wie das Ändern der loss function oder das Hinzufügen eines callback, beziehe dich auf den Callbacks Guide.
Der
BaseTrainerdient als Grundlage für Trainingsroutinen und kann durch Überschreiben seiner generischen Methoden für verschiedene Aufgaben angepasst werden. Zu den Hauptkomponenten gehören:get_model(cfg, weights): Erstellt das zu trainierende Modell.get_dataloader(): Erstellt den Dataloader.preprocess_batch(): Verarbeitet die Batch-Vorverarbeitung vor dem Vorwärtsdurchlauf des Modells.set_model_attributes(): Legt Modellattribute basierend auf Dataset-Informationen fest.get_validator(): Gibt einen Validator zur Modellevaluierung zurück.
Weitere Details zur Anpassung und zum Quellcode findest du in der
BaseTrainerReference.Füge Callbacks hinzu, um den Trainingsprozess in
DetectionTrainerzu überwachen und zu modifizieren. Hier erfährst du, wie du einen Callback hinzufügst, um die Modellgewichte nach jeder Trainings-epoch zu protokollieren:from ultralytics.models.yolo.detect import DetectionTrainer # Callback to upload model weights def log_model(trainer): """Logs the path of the last model weight used by the trainer.""" last_weight_path = trainer.last print(last_weight_path) trainer = DetectionTrainer(overrides={...}) trainer.add_callback("on_train_epoch_end", log_model) # Adds to existing callbacks trainer.train()Weitere Details zu Callback-Ereignissen und Einstiegspunkten findest du im Callbacks Guide.
Ultralytics YOLO bietet eine High-Level-Abstraktion über leistungsstarke Engine-Executors, wodurch es sich ideal für die schnelle Entwicklung und Anpassung eignet. Zu den Hauptvorteilen gehören:
- Benutzerfreundlichkeit: Sowohl die Befehlszeilen- als auch die Python-Schnittstelle vereinfachen komplexe Aufgaben.
- Performance: Optimiert für object detection in Echtzeit und verschiedene Vision-AI-Anwendungen.
- Customization: Einfach erweiterbar für benutzerdefinierte Modelle, loss functions und Dataloader.
- Modularität: Komponenten können unabhängig voneinander geändert werden, ohne die gesamte Pipeline zu beeinträchtigen.
- Integration: Arbeitet nahtlos mit beliebten Frameworks und Tools im ML-Ökosystem zusammen.
Erfahre mehr über die Funktionen von YOLO, indem du die Hauptseite von Ultralytics YOLO erkundest.
Ja, der
DetectionTrainerist äußerst flexibel und für nicht-standardmäßige Modelle anpassbar. Erbe vonDetectionTrainerund überlade Methoden, um die Anforderungen deines spezifischen Modells zu unterstützen. Hier ist ein einfaches Beispiel:from ultralytics.models.yolo.detect import DetectionTrainer class CustomDetectionTrainer(DetectionTrainer): def get_model(self, cfg=None, weights=None, verbose=True): """Loads a custom detection model.""" trainer = CustomDetectionTrainer(overrides={...}) trainer.train()Umfassende Anweisungen und Beispiele findest du in der
DetectionTrainerReference.