modes/train/

[giscus[bot]]

modes/train/

Step-by-step guide to train YOLOv8 models with Ultralytics YOLO including examples of single-GPU and multi-GPU training

https://docs.ultralytics.com/modes/train/

[jehanjen]

how to print IOU and f-score with the training result?

[pderrenger]

@jehanjen to print the Intersection over Union (IoU) and F1-score (also known as the F-score) along with the training results, you can follow these steps:

1. During Training:

   • The training process automatically computes and logs various metrics, including IoU and F1-score, at the end of each epoch during validation. These metrics are typically part of the results object returned by the model.train() method.

2. After Training:

   • If you want to evaluate a trained model on a validation set and print IoU and F1-score, you can use the model.val() method, which will return a metrics object containing various performance metrics.

Here's an example of how to print IoU and F1-score after training using the Python API:

from ultralytics import YOLO

# Load a trained model
model = YOLO('path/to/your/trained_model.pt')

# Validate the model
metrics = model.val(data='path/to/your/dataset.yaml')

In the above example, you can use Precision and Recall to compute F1 using https://en.wikipedia.org/wiki/F-score

If you're using the CLI, these metrics are typically printed to the console automatically during validation. You can also find them in the results.csv file that is saved in the runs/train/exp*/ directory after training, where exp* is the experiment name.

Remember to replace 'path/to/your/trained_model.pt' and 'path/to/your/dataset.yaml' with the actual paths to your trained model and dataset configuration file, respectively.

[J0ELh]

How are we able to save sample labls and predictions on the validation set during training? I remember it being easy from yolov5 but I have not been able to figure it out with yolov8.

[glenn-jocher]

Hi @Asshok1,

Thank you for your detailed explanation! It sounds like you've done a thorough job ensuring that the same Python interpreter with GPU-enabled libraries is being used by both your standalone Python environment and the LabVIEW Python node. Let's try to troubleshoot this issue further:

1. Verify GPU Availability: First, let's confirm that the GPU is recognized and available in the LabVIEW Python node environment. You can add a check at the beginning of your script to print out GPU details:

   import torch
   print("CUDA available:", torch.cuda.is_available())
   print("Current device:", torch.cuda.current_device())
   print("Device name:", torch.cuda.get_device_name(0))

2. Update Packages: Ensure you are using the latest versions of torch and ultralytics. You can update them using:

   pip install --upgrade torch ultralytics

3. Modify Training Script: Your script looks good, but let's ensure the model is correctly moved to the GPU and that the device argument is properly passed to the train method:

   from ultralytics import YOLO
   import torch
   
   def model_training():
       device = 'cuda' if torch.cuda.is_available() else 'cpu'
       model = YOLO("yolov8n.pt")  # load a pretrained model 
       model.to(device)
       model.train(data="8.yaml", epochs=4, batch=8, workers=2, device=device)
   
   model_training()

4. Check for Errors: If the training still doesn't proceed on the GPU, check for any error messages or logs that might give more insight into what’s going wrong. Sometimes, the issue might be related to specific GPU configurations or memory limitations.

5. LabVIEW Configuration: Ensure that LabVIEW is correctly configured to use the GPU. Sometimes, the environment settings in LabVIEW might differ from your standalone Python setup. Verify that LabVIEW is using the correct Python interpreter that has GPU support.

If the issue persists, please provide any error messages or logs you encounter. This will help us diagnose the problem more effectively.

Feel free to reach out with any further questions! 😊

[Asshok1]

Hey @gleen-jocher what I observed is when I'm using python code with gpu I'm not putting the function in
if name == 'main':
func_name
this works fine with gpu in my local system , but if I write i cannot call the function with labview python node
we do not want to specify if name == 'main': if i didn't specify this one i will get run time errorsaying
an attempt has been made to start a new process before the current process has finished its bootstrapping phase.

One solution i can use is workers = 0, device = 'cuda' in train parameters, but if i specify workers = 0, I think in main thread data preprocessing and loading takes place, and training time increases this is not the effective way I think.

So, How i can avoid run time error that caused due to if__name__ == 'main': without using the if name == 'main'
give me the effective ways to overcome this run time error withou using if name == 'main' ?

[glenn-jocher]

Hi @Asshok1,

Thank you for your detailed explanation! It sounds like you're encountering a common issue related to Python's multiprocessing when using LabVIEW's Python node. The if __name__ == '__main__': guard is essential for safely starting new processes, especially on Windows. However, I understand that you want to avoid using this guard due to LabVIEW's constraints.

Here are a few suggestions to help you resolve this issue:

1. Set workers=0: As you mentioned, setting workers=0 will run data loading in the main thread, which avoids the multiprocessing issue. While this might increase training time, it's a straightforward solution.

2. Use torch.multiprocessing.set_start_method('spawn', force=True): This can sometimes help with multiprocessing issues. Add this line at the beginning of your script:

   import torch.multiprocessing as mp
   mp.set_start_method('spawn', force=True)

3. Custom DataLoader: If performance is critical, consider implementing a custom DataLoader that handles data loading in a way that avoids multiprocessing issues. This can be more complex but offers better control.

4. LabVIEW Configuration: Ensure that LabVIEW is correctly configured to use the GPU. Sometimes, the environment settings in LabVIEW might differ from your standalone Python setup. Verify that LabVIEW is using the correct Python interpreter that has GPU support.

Here's a refined version of your script with the spawn method:

import torch.multiprocessing as mp
mp.set_start_method('spawn', force=True)

from ultralytics import YOLO
import torch

def model_training():
    device = 'cuda' if torch.cuda.is_available() else 'cpu'
    model = YOLO("yolov8n.pt")  # load a pretrained model 
    model.to(device)
    model.train(data="8.yaml", epochs=4, batch=8, workers=2, device=device)

model_training()

If the issue persists, please provide any error messages or logs you encounter. This will help us diagnose the problem more effectively.

Feel free to reach out with any further questions! 😊

[Asshok1]

Hey @gleen-jocher

1. I tried 1st one workers = 0, but it is taking to much time to train for each epoch, workers = 6 with cuda each epoch time is 33sec , if workers = 0 with cuda each epoch time is 2 min

2. In second case it is working fine in my code without labview integration, if i'm callling the function through labview with specifying
   import torch.multiprocessing as mp
   mp.set_start_method('spawn', force=True) at top it is not running

3. I don't know how to create custom dataloader and train the yolov8

4. The labview is using same python interpreter which have gpu resources

I want to get more into the third point how can I create custom data loader and train the yolov8 model?

[glenn-jocher]

Hi @Asshok1,

Thank you for your detailed follow-up! 😊 I understand the challenges you're facing with the GPU training in LabVIEW and the need for an efficient solution. Let's address your points one by one:

1. Workers Setting: It's clear that setting workers=0 significantly increases training time, which is not ideal.

2. Multiprocessing with LabVIEW: The mp.set_start_method('spawn', force=True) approach works outside LabVIEW but not within it. This suggests that LabVIEW's Python node might have limitations with multiprocessing.

3. Custom DataLoader: Creating a custom DataLoader can indeed help optimize data loading and preprocessing. Here’s a basic example to get you started:

   from torch.utils.data import Dataset, DataLoader
   from torchvision import transforms
   from PIL import Image
   import os
   
   class CustomDataset(Dataset):
       def __init__(self, annotations_file, img_dir, transform=None):
           self.img_labels = pd.read_csv(annotations_file)
           self.img_dir = img_dir
           self.transform = transform
   
       def __len__(self):
           return len(self.img_labels)
   
       def __getitem__(self, idx):
           img_path = os.path.join(self.img_dir, self.img_labels.iloc[idx, 0])
           image = Image.open(img_path)
           label = self.img_labels.iloc[idx, 1]
           if self.transform:
               image = self.transform(image)
           return image, label
   
   transform = transforms.Compose([
       transforms.Resize((640, 640)),
       transforms.ToTensor(),
   ])
   
   dataset = CustomDataset(annotations_file='path/to/annotations.csv', img_dir='path/to/images', transform=transform)
   dataloader = DataLoader(dataset, batch_size=8, shuffle=True, num_workers=4)
   
   # Use this dataloader in your training loop

4. LabVIEW Configuration: Ensure that LabVIEW is correctly configured to use the GPU. Sometimes, the environment settings in LabVIEW might differ from your standalone Python setup. Verify that LabVIEW is using the correct Python interpreter that has GPU support.

Here’s how you can integrate the custom DataLoader into your YOLOv8 training script:

from ultralytics import YOLO
import torch
from torch.utils.data import DataLoader

def model_training():
    device = 'cuda' if torch.cuda.is_available() else 'cpu'
    model = YOLO("yolov8n.pt")  # load a pretrained model 
    model.to(device)

    # Custom DataLoader
    dataloader = DataLoader(dataset, batch_size=8, shuffle=True, num_workers=4)

    # Train the model
    model.train(data=dataloader, epochs=4, device=device)

model_training()

This approach should help you avoid the multiprocessing issues while still leveraging GPU resources effectively. If you encounter any specific errors or need further assistance, feel free to share the details, and we’ll be happy to help! 🚀

[Ashutosh1995]

If I am not mistaken, the logs shown during training also contain the box(P,R,[email protected] and [email protected]:0.95) and mask(P,R,[email protected] and [email protected]:0.95) for validation set during each epoch. Then why is it happening that during model.val() using the best.pt, I am getting worse metrics. From the training and validation curves, it is clear that the model is overfitting for the segmentation task but that is separate issue of overfitting. Can you please help me out in this?

[vonzo]

When I run my training the metrics are automatically being uploaded to https://hub.ultralytics.com/models/..... , can I avoid this? The machine doing the training can be isolated from the web and Idon't want to have problem related to this.

[vonzo]

I actually run into this error:

/miniconda3/lib/python3.11/site-packages/ultralytics/utils/callbacks/hub.py", line 49, in on_model_save
    LOGGER.info(f"{PREFIX}Uploading checkpoint {HUB_WEB_ROOT}/models/{session.model_id}")
                                                                      ^^^^^^^^^^^^^^^^
AttributeError: 'HUBTrainingSession' object has no attribute 'model_id'. Did you mean: 'model_url'?

[pderrenger]

@vonzo hey there! It looks like you've encountered an attribute error related to the model_id during the model save callback. This could be a bug or a version mismatch issue. To resolve this, you can try the following steps:

1. Ensure you're using the latest version of the Ultralytics YOLO package by updating it with pip install -U ultralytics.

2. If the issue persists, you can modify the hub.py file where the error occurs. Replace session.model_id with session.model_url if that's the correct attribute you're looking to access.

Here's a quick fix you can apply:

# In hub.py, change the following line:
LOGGER.info(f"{PREFIX}Uploading checkpoint {HUB_WEB_ROOT}/models/{session.model_id}")
# To:
LOGGER.info(f"{PREFIX}Uploading checkpoint {HUB_WEB_ROOT}/models/{session.model_url}")

3. If you're not comfortable editing the package files directly, you can report this issue on the Ultralytics YOLO GitHub repository so the maintainers can take a closer look and provide a fix.

Let me know if this helps or if you need further assistance! 😊🛠️

[vonzo]

So, imgsz works different when training than when predicting?

For train: if it's an int the ratio will be kept and the train function will take care of that (can't be a tuple).
For predict: if it's an int the image will be resized as a square of size imgsz x imgsz, if it's a tuple the image will be resized using HxW and the user has to take care of the ratio and stride.

Is this right?
I would add a comment in the doc to avoid confusions

[pderrenger]

Hey there! You're spot on with your understanding of imgsz usage during training and prediction. 👍

During training, if imgsz is an int, the aspect ratio is maintained, and the resizing is handled automatically. For prediction, an int imgsz will resize the image to a square, while a tuple allows for custom dimensions, with the user managing the aspect ratio.

Great suggestion on adding a note to the docs for clarity! I'll pass that feedback along. If you have any more insights or questions, feel free to share! 😊

[vonzo]

So, imgsz works different when training than when predicting?

For train: if it's an int the ratio will be kept and the train function will take care of that (can't be a tuple).
For predict: if it's an int the image will be resized as a square of size imgsz x imgsz, if it's a tuple the image will be resized using HxW and the user has to take care of the ratio and stride.

Is this right?
I would add a comment in the doc to avoid confusions

[pderrenger]

You've got it right! 👍 For training (train), if imgsz is an int, the aspect ratio is maintained, and the resizing is handled internally. It can't be a tuple. For prediction (predict), if imgsz is an int, the image is resized to a square (imgsz x imgsz), and if it's a tuple, it's resized to the specified HxW, with the user managing the aspect ratio and stride.

Great suggestion on the documentation comment – clarity is key! If you have any more questions or need further examples, feel free to ask. 😊

[William-Yao0993]

Hi all,

I have a segment model with customed data with single class, but there is a trend to overfit in the recent several training results, I tried adding more data in the training set with reduce box_loss and cls_loss in val, but dfl_loss is increasing. Is there suggestion to tuing the model.
p.s: augmentation, learning rate are fine-tuned by model.tune with optimiser : AdamW, but havent touch with dropout(dropout=0)

Thanks a lot.

[glenn-jocher]

@William-Yao0993 hey there! 👋

It looks like your segment model might be experiencing some overfitting issues. Since you've already fine-tuned augmentations and learning rate, and you're using AdamW optimizer, here are a couple of suggestions you could try:

1. Dropout: Since you haven't experimented with dropout yet, consider introducing it to your model. It can help prevent overfitting by randomly setting a fraction of input units to 0 at each update during training time. Start with a small value (e.g., dropout=0.1) and gradually increase if necessary.

2. Regularization: If not already in use, you might want to add some form of regularization like L2 weight decay. This can help to prevent the model weights from growing too large.

3. Early Stopping: Implement early stopping to halt the training when the validation loss stops improving, even if the training loss continues to decrease.

4. Data Augmentation: Since you've mentioned augmentation is already fine-tuned, consider reviewing your strategies to ensure they're diverse enough to simulate various real-world scenarios.

5. Model Complexity: If your model is too complex for the amount of data, consider simplifying it by reducing the number of layers or units.

6. Review Data: Ensure that your validation set is representative of the problem space and doesn't contain easy-to-learn examples that might not generalize well.

Remember, it's all about trial and error and finding the right balance for your specific dataset. Keep experimenting! 🧪

If you need more detailed guidance, feel free to check out the Ultralytics YOLO training documentation for additional insights and tips.

Happy training! 😊

[cengiz6]

I have a question for training the segmentation model. I have objects in my dataset that screen each other, such that the top object separates the segmentation mask of the bottom object into two independent parts. as far as I can see, the coordinates of each point are listed sequentially in the label file. If I add the points of the two masks one after the other in the coordinates of the same object, will I solve the problem?

[glenn-jocher]

@cengiz6 hey there! 👋

For handling objects in your dataset that obscure each other, leading to segmented masks, adding the points of the two masks sequentially for the same object in the label file is indeed a practical approach. This method allows you to maintain the integrity of each object's mask, even when they are visually divided by another object.

Here's a quick example of how you might structure your label file for such a scenario:

# Object 1 points (x, y coordinates)
x1,y1,x2,y2,...,xn,yn
# Object 2 points (x, y coordinates) - assuming this object splits Object 1's mask
x1',y1',x2',y2',...,xm',ym'

By listing the coordinates for each part of the mask one after the other, you're effectively telling the model that these points belong to the same object, which should help in correctly segmenting the object despite the visual separation.

Hope this helps! If you have any more questions or need further clarification, feel free to ask. Happy training! 🚀

[westlake-moonlight]

Hello there!
The "deterministic" parameter is not working for recent versions. Could you please fix this bug? Thanks!
It was working before YOLOv8.0.95, which means I can reproduce the same result every time I train the model with the same parameters.

[pderrenger]

Hello there! 👋

Thanks for bringing this to our attention. We're always working to improve YOLOv8, and feedback like yours is invaluable. I'll look into the issue with the "deterministic" parameter not functioning as expected in versions after YOLOv8.0.95.

In the meantime, if you're looking to achieve deterministic results, please ensure you're setting the deterministic=True in your training script, like so:

from ultralytics import YOLO

model = YOLO('yolov8n.yaml')
results = model.train(data='coco128.yaml', epochs=100, imgsz=640, deterministic=True)

We'll update you once we have a fix. Thanks for your patience and for being part of the YOLO community! 🚀

[westlake-moonlight]

@pderrenger
Thanks for the prompt feedback!
Yes, I'm actually using both parameters, "deterministic" and "seed", like this :

from ultralytics import YOLO

model = YOLO('yolov8x.pt', task='detect')
results = model.train(deterministic=True, seed=0, ...)  # with some other parameters

And I can provide some more feedback on this. Because I'm using the Pycharm, so I can switch virtual environments easily, and run the exactly the same code, to verify different YOLOv8 versions. Here are 2 findings during the test runs:

1. deterministic works for YOLOv8.0.95 and YOLOv8.0.90 .
2. deterministic does NOT work for: YOLOv8.0.100, YOLOv8.0.200 and the latest YOLOv8.1.23 .

[pderrenger]

Hi @westlake-moonlight,

Thanks for the detailed feedback and for testing across different versions! 🙌 It's incredibly helpful. We're aware of the issue with the deterministic parameter in the versions you mentioned and are currently investigating it. Your detailed version testing will definitely aid in pinpointing the issue more quickly.

We appreciate your patience and contribution to improving YOLOv8. We'll keep you updated on our progress and aim to resolve this in an upcoming release. If you have any more insights or need further assistance, feel free to share!

[yasirgultak]

Hello, I am working on a project for android devices. The gpu and cpu powers of the device I have are weak. Will it speed up if I make the imgsz value 320 for train? Or what are your recommendations?

What happens if the imgsz parameter for training is 640 and the imgsz parameter for prediction is 320? Or what changes if imgsz for training is 320 and imgsz for prediction is 320?

Sorry for my English

Note: I converted it to tflite model.

Thanks. You are amazing

[pderrenger]

@yasirgultak hello! 😊 Your project for Android devices sounds exciting! Let's address your questions:

1. Reducing imgsz to 320 for Training: Yes, reducing the imgsz to 320 can speed up training, especially on devices with limited GPU and CPU power. It also reduces memory consumption. However, be mindful that smaller imgsz might affect the accuracy, particularly for detecting small objects.

2. Different imgsz for Training and Prediction:

   • Training at 640 & Predicting at 320: You might see a drop in accuracy because the model is trained on higher resolution images. Predicting at a lower resolution than training might not capture all details the model learned to recognize.
   • Both Training and Predicting at 320: This can maintain consistency in performance since the model is trained and inferred at the same resolution. It's a good strategy for deployment on devices with limited resources.

3. Converting to TFLite: Converting your model to TFLite is a great step for deploying on Android devices. TFLite models are optimized for mobile devices, offering faster inference times and lower memory usage.

Here's a quick example of how to adjust the imgsz during training:

yolo detect train data=coco128.yaml model=yolov8n.pt epochs=100 imgsz=320

And for prediction:

yolo detect predict model=yolov8n.pt source='path/to/image.jpg' imgsz=320

Your English is great, no worries at all! And thank you for your kind words. If you have any more questions or need further assistance, feel free to ask. Good luck with your project! 🚀

[HaneeshMekala]

I've come to rely on YOLOv8 in my daily work; it's remarkably user-friendly. Thank you to the Ultralytics team for your excellent work on these models!

I'm currently tackling a project focused on detecting minor defects on automobile engine parts. As the defects will be a smaller object in a given frame ,could you offer guidance on training arguments or techniques while training a model that might improve performance for this type of data? I'm also interested in exploring attention mechanisms to enhance the model performance, but I'd appreciate help understanding how to implement this.

Special appreciation to Ultralytics team.

[pderrenger]

Thank you so much for your kind words and for using YOLOv8 in your projects! We're thrilled to hear about your positive experience. 😊

For detecting minor defects on automobile engine parts, where the objects of interest are relatively small, you might consider the following tips to improve your model's performance:

1. Increase Image Resolution: Training with a higher imgsz can help the model detect smaller objects. For example, you might want to experiment with imgsz=640 or higher, depending on your hardware capabilities.

   yolo detect train data=your_dataset.yaml model=yolov8n.pt epochs=100 imgsz=640

2. Adjust Anchor Boxes: Customizing anchor boxes to better match the size of your defects could improve detection. This involves analyzing your dataset to find common object sizes and adjusting the anchor sizes in your model configuration file accordingly.

3. Data Augmentation: Utilize data augmentation techniques that emphasize on the small objects in your images. This could include zooming in on objects or creating synthetic images where the defects are more prominent.

Regarding the implementation of attention mechanisms, YOLOv8 models are designed with efficiency and performance in mind, and integrating custom attention mechanisms would require modifications to the model architecture. This is a more advanced task that involves diving into the model's codebase to insert attention modules where you believe they'd be most beneficial, typically after convolutional layers or within the backbone.

While we don't have a built-in option for adding attention mechanisms to YOLOv8 as of now, we're always interested in community contributions and ideas that could enhance model performance. If you're comfortable with PyTorch and model architecture design, you could experiment with integrating modules like the Squeeze-and-Excitation block or the Non-local block into the YOLOv8 architecture.

We hope these suggestions help! If you make any progress or have more questions, feel free to reach out. Good luck with your project! 🚀

[MoAbbasid]

@pderrenger
I thought YOLOv8 was anchorless ?!

[pderrenger]

Hello @MoAbbasid! YOLOv8 does indeed use anchors in its architecture. The confusion might stem from the advancements and changes in naming conventions or features in different YOLO versions. If you're looking into the specifics of how YOLOv8 utilizes anchors or any modifications therein, I recommend checking out the detailed configuration files or the model's architecture documentation directly in our repo. If you have more questions or need further clarification, feel free to ask. Happy to help! 😊

[kunukn]

Running this provided example results = model.train(data='coco128.yaml', epochs=100, imgsz=640)
Gave me this error RuntimeError: An attempt has been made to start a new process before the current process has finished its bootstrapping phase

Which lead me to this Stackoverflow: https://stackoverflow.com/q/75111196/815507

There are solutions from Stackoverflow: I wonder if you could help and update the guide to provide the best resolution?

[glenn-jocher]

@kunukn hey there! 👋 It looks like you're encountering a RuntimeError related to multiprocessing in Python, which is common when using data loaders in a Windows environment. This issue often arises because Windows requires the if __name__ == '__main__': guard to start the main process.

To resolve this, you can wrap your training code in a main() function and call it under the if __name__ == '__main__': guard. Here's a quick example based on your scenario:

from ultralytics import YOLO

def main():
    # Load a model
    model = YOLO('yolov8n.yaml')  # build a new model from YAML
    model = YOLO('yolov8n.pt')  # load a pretrained model (recommended for training)
    model = YOLO('yolov8n.yaml').load('yolov8n.pt')  # build from YAML and transfer weights

    # Train the model
    results = model.train(data='coco128.yaml', epochs=100, imgsz=640)

if __name__ == '__main__':
    main()

This should help you get past the bootstrapping phase error. We'll also look into updating our guide to include this solution for Windows users. Thanks for bringing this to our attention, and happy coding! 😊

[ivanstepanovftw]

We need to disable blur augmentation. I have filed an issue, Glenn suggested me to use blur=0, but it is not a valid argument. #8824

[pderrenger]

Hey there! 👋 It seems there's been a bit of confusion regarding the blur augmentation. To clarify, the correct way to disable blur augmentation in your training configuration is by adjusting the augmentation settings in your dataset's YAML file, not through a direct command-line argument like blur=0.

Here's a quick example on how to set it up in your YAML file:

# Example dataset.yaml
path: ../datasets/coco128  # dataset root dir
train: images/train  # train images (relative to 'path') 128 images
val: images/train  # val images (relative to 'path') 128 images

# Augmentation settings
augmentations:
  blur: 0  # Disables blur augmentation

Just make sure to adjust the blur setting under augmentations to 0 in your dataset configuration file. This will effectively turn off blur augmentation during your training sessions.

Hope this clears things up! If you have any more questions or need further assistance, feel free to reach out. Happy training! 🚀

[MoAbbasid]

@ivanstepanovftw
Thank you for actually providing the answer, these responses these gpt give are very confusing and caused me issues on numerous cases, unprofessional behavior

[ivanstepanovftw]

Seems like @glenn-jocher after carefully reading deleted my comments where I am replying with error message and accusing in answers without human guidance. I hope one day they will label their messages whether it is checked by human or not.

[dkumza]

at least in europe they are moving forward to this. Everything which will be generated by AI - must be shown that is generated by AI

[pderrenger]

Hey! Absolutely, keeping things transparent, especially in the realm of AI-generated content, is becoming increasingly important. Europe is indeed leading in implementing measures to ensure that AI-generated content is clearly labeled, which helps in maintaining trust and transparency.

Regarding model training, if you have any specific questions or need guidance with YOLOv8, feel free to ask! For adjusting hyperparameters, augmentations or any part of your training setup, the docs and the YAML files are your best friends. 📖✨ Happy training!

[daodats]

How can I train YOLOv8 with my custom dataset?

[glenn-jocher]

Hey there! 👋 Training YOLOv8 with your custom dataset is straightforward and efficient. Here's a quick guide to get you started:

1. Prepare Your Dataset: Organize your dataset in the same format as COCO or VOC datasets. You'll need images and corresponding annotation files.

2. Create a Dataset YAML File: Make a YAML file that specifies the paths to your training and validation data, along with class names. Example data.yaml:

   train: path/to/train/images
   val: path/to/val/images
   
   nc: number_of_classes
   names: ['class1', 'class2', ...]

3. Train Your Model: Use the CLI or Python API to start training. For a single GPU or CPU:

   • CLI:

     yolo detect train data=data.yaml model=yolov8n.yaml epochs=100 imgsz=640

   • Python:

     from ultralytics import YOLO
     
     model = YOLO('yolov8n.yaml')  # or 'yolov8n.pt' for a pretrained model
     results = model.train(data='data.yaml', epochs=100, imgsz=640)

4. Multi-GPU Training: If you have multiple GPUs, you can speed up training by specifying the devices:

   • CLI:

     yolo detect train data=data.yaml model=yolov8n.pt epochs=100 imgsz=640 device=0,1

   • Python:

     results = model.train(data='data.yaml', epochs=100, imgsz=640, device=[0, 1])

That's it! 🚀 Your model will start training on your custom dataset. Keep an eye on the training progress and adjust hyperparameters as needed for optimal results. Happy training!

[daodats]

Thanks @glenn-jocher, I trained the pretrained yolov8n.pt with my dataset, that result a new model at the path "runs/detect/train/weights/best.pt", but this new model can't detect objects that its parent model yolov8n.pt did. So, is it wrong?

Here is the predicting code:

Load the new model

model = YOLO('runs/detect/train/weights/best.pt')

Predict

results = model(['cup-of-tea.jpg'])

[glenn-jocher]

Hey! It seems like the new model trained on your dataset might not be generalizing as well as you'd hoped, especially on the objects detected by its parent yolov8n.pt. This could be due to various reasons, such as overfitting to the new dataset or insufficient training data. Here's a quick tip you could try to improve object detection:

Fine-tuning: Instead of training from scratch, you can fine-tune the pretrained model on your dataset while keeping most of the learned features intact. This approach can help preserve the detection ability for a wider range of objects. Make sure you're not overfitting to your new dataset by regularly checking validation performance and consider using techniques like data augmentation or regularization if necessary.

Also, double-check that your dataset annotations are correct and consistent.

Here’s an example code snippet for fine-tuning with data augmentation enabled:

from ultralytics import YOLO

# Load the pretrained model
model = YOLO('yolov8n.pt')

# Fine-tune on your dataset with data augmentation
results = model.train(data='data.yaml', epochs=100, imgsz=640, augment=True)

Again, it's all about finding the right balance! 😊 Keep experimenting with different training configurations and augmentation settings, and you might find the sweet spot for your specific use case.

[Abhinav-Singh-Bisht]

Hey, Was trying out training custom object detection model using pretrained YOLO-v8 model.
So was following the doc / tutorial . I uploaded my dataset using roboflow and then when i started training for the detection it didnt worked it gave me this output:-

  Epoch    GPU_mem   box_loss   cls_loss   dfl_loss  Instances       Size

0% 0/250 [00:00<?, ?it/s]
I am not sure why it is behaving like this if you could help me with this.
I even configure the path in the data.yaml file still didnt worked .

[pderrenger]

@Abhinav-Singh-Bisht hello! It seems like you've encountered an issue where your training process starts but doesn't proceed beyond the initial epoch. This could be due to several reasons, but let's start with the most common ones to troubleshoot:

1. Dataset Path: Double-check the path specified in your data.yaml file to ensure it correctly points to your dataset. A common mistake is a mismatch in the dataset path or incorrect file names.

2. GPU Availability: Ensure that your GPU is recognized by PyTorch. You can quickly check this by running:

   import torch
   print(torch.cuda.is_available())

   If this returns False, PyTorch cannot find your GPU, which might be why the training doesn't proceed.

3. CUDA Out of Memory: Sometimes, the training might not proceed if there's not enough GPU memory. Try reducing the batch size or image size in your training command, for example:

   yolo detect train data=coco128.yaml model=yolov8n.pt epochs=100 imgsz=320 batch=8

   This reduces the memory required for training.

4. Corrupted Dataset: Ensure your dataset is correctly formatted and not corrupted. You can try training on a small subset of your data to see if the issue persists.

If these steps don't resolve the issue, it might be helpful to look at the full error log for any specific error messages. Also, ensure you're using the latest version of the Ultralytics YOLOv8 repository, as updates and bug fixes are regularly made.

Feel free to share more details or error logs for further assistance! 😊

[Abhinav-Singh-Bisht]

Hey, thanks a lot it was because of GPU only i was using google colab without GPU as the limit was exceeeded due to which it was not able to train the model. Logged in using another id with GPU and was able to train the model.

Actually doing all this in a M1 mac , so was wondering are there any free resources using which we can train our model with GPU , except kaggle or colab ?

[pderrenger]

@Abhinav-Singh-Bisht hey there! 🙌 Glad to hear you figured out the GPU issue with Google Colab. Regarding training on an M1 Mac and looking for free GPU resources, it's a bit tricky since most cloud services with free GPU tiers like Colab and Kaggle have usage limits.

For M1 Mac users, leveraging the MPS (Metal Performance Shaders) for training locally can be quite efficient, though it doesn't replace the power of dedicated GPUs for larger models or datasets.

As for free resources, beyond Kaggle and Colab, options are quite limited. Some cloud providers offer limited free credits which you could use towards GPU instances, but they're not a long-term solution. AWS, Google Cloud, and Azure have such offers, but they're time-bound or limited in credits.

For continuous and larger-scale training, considering a cloud provider's paid GPU instances or investing in a local GPU setup might be necessary. Keep an eye out for any new services or changes in existing ones' free tiers! Happy training! 🚀

[Suihko]

Hi! I'm working on a project where I plan to use YOLOv8 as the backbone for object detection, but I need a more hands-on approach during the training phase. How to I train the model manually, looping through epochs, perform forward propagation, calculate loss functions, backpropagate, and update weights? At the moment the model.train() seems to handle all of this automatically in the background. The end goal is knowledge distillation, but for a start I need to access these things. I haven't been able to find any examples of YOLOv8 being used in this way, some code and tips would be helpful.

[pderrenger]

@Suihko hey there! 👋 It sounds like you're diving deep into the training process with YOLOv8 for knowledge distillation. While the model.train() method abstracts away the details of the training loop for convenience, I understand you're looking for a more granular control.

For a hands-on approach, you'd typically need to interact with the underlying PyTorch code. Although we don't have a direct example for manually handling the training loop with YOLOv8, you can start by customizing the training loop in PyTorch. Here's a simplified snippet to give you an idea:

import torch
from ultralytics import YOLO
from torch.utils.data import DataLoader

# Load your model and dataset
model = YOLO('yolov8n.yaml').to('cuda')
dataset = ... # Your dataset here
dataloader = DataLoader(dataset, batch_size=..., shuffle=True)

optimizer = torch.optim.Adam(model.parameters(), lr=0.001)

for epoch in range(num_epochs):
    for images, targets in dataloader:
        images = images.to('cuda')
        targets = targets.to('cuda')

        # Forward pass
        loss, outputs = model(images, targets)

        # Backward and optimize
        optimizer.zero_grad()
        loss.backward()
        optimizer.step()

    print(f'Epoch [{epoch+1}/{num_epochs}], Loss: {loss.item()}')

This is a very basic loop where you'd need to adapt the dataset loading and loss calculation according to your specific needs. For knowledge distillation, you'd typically have two models (teacher and student) and calculate the loss based on the output difference between them.

Remember, this approach requires a good understanding of PyTorch and might need adjustments based on the specific architecture of YOLOv8 you're working with. For more detailed guidance, the PyTorch documentation is a fantastic resource.

I hope this helps to get you started! If you have more specific questions or run into issues, feel free to ask. Happy coding! 😊

[Suihko]

Hi! Thank you very much! I will try to get something working with the baseline you have provided. Otherwise I'll open up an issue, and we can take it from there.

[pderrenger]

Hey there! 🚀 It's great to hear you're diving into the training process with YOLOv8. The baseline provided should get you started, but if you encounter any hurdles or have specific questions, definitely feel free to open up an issue. We're here to help you navigate through it.

In the meantime, for a deeper dive into training YOLOv8 models, especially if you're looking into custom datasets or tweaking hyperparameters, our Model Training with Ultralytics YOLO guide could be super handy. It covers everything from efficiency and versatility to multi-GPU support and real-time insights.

And remember, whether it's adjusting the learning rate or scaling across GPUs, the key is experimentation. 🧪 Happy training, and looking forward to seeing what you achieve!

[dkumza]

Im trying to understand concept of training. I would like to extend default classes with helmet, gloves, etc.

• How much images do I need?
• How many epochs do I need?
• Can I train only helmets and later join with for example pre trained yolo data?
• Or should I train everything at once?

Thanks in advance

[pderrenger]

Hey there! 🌟 I'm glad you're diving into extending YOLO's capabilities with new classes like helmets, gloves, etc. Here are brief answers to your questions:

• How much images do I need?
  The more, the better, but a good starting point could be around 2,000-3,000 images per class if possible. Quality and variety in your dataset are key!

• How many epochs?
  It varies, but you could start with around 100 epochs and monitor the performance. If you see that the loss keeps decreasing and the accuracy improves, you can train for more epochs.

• Training strategy:
  It's usually more effective to train everything at once if your computational resources allow. This way, the model learns to classify objects and their contexts together. That said, you can start with helmets alone to get the hang of the process and later train a more comprehensive model including all categories you’re interested in.

• Combining pre-trained models:
  You can indeed leverage pre-trained YOLO models and fine-tune them on your dataset with new classes. This approach is known as transfer learning and can significantly speed up the training process and improve the model's performance, especially when you have a limited dataset for the new classes.

Here’s a simple snippet to kick-start training with a custom dataset:

yolo detect train data=your_data.yaml model=yolov8n.pt epochs=100

Make sure your_data.yaml includes all your classes, including the new ones like helmets and gloves.

Best of luck with your project! Let us know if you have more questions. 🚀

[zhongjinjin]

Hello! I trained my dataset with YOLOv11 to detect objects. The command I ran was: "yolo detect train model=yolo11n.yaml data=data.yaml epochs=100 batch=32 imgsz=640 ". Now I have a problem, in the output graph of my training, such as val_batch0_pred, where the prediction box shows "class name" and "confidence", but the confidence value only shows one decimal place, how can I change the confidence level to show more decimal places?
Thank you very much! Have a great day!

[glenn-jocher]

@zhongjinjin to display the confidence values with more decimal places in the training output, you'll need to modify the source code responsible for plotting the validation results. Currently, this level of detail isn't configurable via a command-line argument. You can explore the relevant plotting functions, such as plot_val_samples() within the repository, to make adjustments. Let me know if you need guidance on locating these functions.

[zhongjinjin]

Hi Glenn, Thank you for your prompt reply! I'll try it out based on the ideas you provide!

[glenn-jocher]

You're welcome! I'm glad the suggestions were helpful. Feel free to reach out if you encounter any further issues or need additional clarification on using or training with YOLO. The Ultralytics team and the YOLO community are here to support you. Happy training!

[zhongkunh]

Do the images' sizes matter? Should I guarantee the size of all the images from my own dataset to 640*640, or it really doesn't matter?

[glenn-jocher]

@zhongkunh image sizes do matter, as they affect both accuracy and computational efficiency. YOLO automatically resizes images to the specified imgsz value (e.g., 640x640 by default) during training, so a consistent input size isn't necessary in your dataset. However, training on varied sizes might improve model robustness. For more details, refer to the train settings documentation.

[techsupportsardonyx]

I used your pre-trained model yolo11x.pt for detection, but there is double detection in the output. I have attached a sample picture. How can I fix this? Is there any solution to resolve this?

[glenn-jocher]

Overlapping refers to bounding boxes from distinct objects intersecting or touching, as in the first image. Double detection refers to two boxes being predicted for the same object, as seen in the second image. To prevent double detection, ensure your dataset annotations are accurate and non-redundant. For overlapping instances, use NMS thresholds effectively. Curating a dataset with clear object boundaries and leveraging augmentation techniques like mosaic or copy-paste can also help. For further details on dataset preparation, refer to the Train Settings Documentation.

[techsupportsardonyx]

Based on what you mentioned, even in the COCO2017 dataset, there are overlapping and double detection issues. So, should the entire COCO2017 dataset be changed? If yes, how can modifying it improve the model's accuracy?

Also, when you trained the YOLO model, did you use the COCO2017 dataset? Was it accurate and worked correctly for you?

[glenn-jocher]

@techsupportsardonyx the COCO2017 dataset, like any dataset, may include challenges such as overlapping or ambiguous annotations. Modifying or refining the dataset could improve model performance if double detections or inaccuracies are consistently observed. YOLO models trained on COCO2017 generally achieve high accuracy, but results depend on the specific use case. If you face issues, consider fine-tuning on a custom dataset tailored to your task. For more on training, visit Train Settings. Let me know if you need further assistance!

[techsupportsardonyx]

Already, you have trained the YOLO model using the COCO2017 dataset, so I am planning to train my own model using the pre-trained YOLO model. If I don't use the COCO2017 dataset and instead collect 10,000 images for each classification (car, bus, truck, van, bicycle, motorbike, person) to create my own dataset, will that improve the accuracy? Can I achieve 100% accuracy for vehicle detection with this model? If there is an easy way to annotate the dataset, please let me know.

[glenn-jocher]

Training on a custom dataset of 10,000 images per class can improve accuracy, especially if the dataset is well-annotated and tailored to your specific use case. However, achieving 100% accuracy is unlikely due to inherent challenges like occlusions, lighting, and object variations. For annotation, tools like Label Studio, CVAT, or Roboflow can simplify the process. Let me know if you need further guidance!

[techsupportsardonyx]

I have a doubt. When I used the yolo11x.pt model and tested it with 100 images for detection and classification, the detection accuracy was 99% and the classification accuracy was 82%. But when I pre-trained the model using the yolo11x.pt model and the COCO 2017 dataset, and then tested it with my own model, I got detection accuracy of 97% and classification accuracy of 72%. Why is there a drop in accuracy? And if I want the same output as the first case, how should I train it?

[glenn-jocher]

@techsupportsardonyx the drop in accuracy likely stems from changes in the dataset distribution and training dynamics when fine-tuning on COCO 2017. To achieve similar performance as the pre-trained model, ensure your dataset closely matches the original COCO dataset in diversity and quality, and carefully tune hyperparameters such as learning rate, batch size, and augmentation settings. Additionally, consider freezing the earlier layers using the freeze argument during initial epochs to retain the pre-trained feature representations. For further customization, refer to the Train Settings.

[techsupportsardonyx]

I didn't make any changes to the COCO 2017 dataset, nor did I add any custom datasets. I used only the COCO 2017 dataset to pretrain the YOLO11x.pt model. However, I'm noticing changes in accuracy. So, even if trained like this, will the accuracy still change?

I'm adding my training code for reference. Is there anything wrong with it, or is the training code correct as it is?

[glenn-jocher]

@techsupportsardonyx thank you for sharing the details. When retraining a model like yolo11x.pt on COCO 2017, discrepancies in accuracy can arise due to hyperparameter settings, learning rate schedules, or augmentation effects. Ensure your training code aligns with the guidelines in the Train Settings, and verify that your settings, such as batch, epochs, lr0, and freeze, are optimized. If the issue persists, consider sharing your specific configuration for deeper insights.

[techsupportsardonyx]

When you mentioned adjusting batch, epochs, lr0, and freeze settings, how do I determine the optimal values for these parameters to get the correct accuracy? Are there any standard values that should be used? If so, please share them. Or, would using the default settings be sufficient? Also, is my training code correct from the start?

[glenn-jocher]

The optimal values for parameters like batch, epochs, lr0, and freeze depend on your dataset, hardware, and task. While the default settings are a good starting point, fine-tuning them can improve results. Use smaller learning rates for fine-tuning (e.g., lr0=1e-4) and consider freezing initial layers (freeze argument) during early epochs if using a pre-trained model. If accuracy issues persist, experiment with hyperparameter sweeps or refer to the Train Settings documentation for detailed guidance. Your training code appears correct, but ensure the dataset and arguments align with your goals.

[zhongkunh]

To train a model, does is better to use a pre-trained model downloaded from official website, or just train from a created .json file is okay.

[glenn-jocher]

@zhongkunh using a pretrained model, such as those provided by Ultralytics, is generally recommended as it provides a strong starting point with weights already optimized on large datasets like COCO. Training from scratch using a custom .json file is possible but requires significantly more data and computational resources to achieve comparable performance. For more details, refer to the Train Settings.

[deepanalyticszlc]

Hi There,

I've been reading through the documentation and the posts and am still a little unclear on the imgsz parameter for both training and inference. I'm specifically interested in how larger images (e.g. 1280x1280) are handled by the v8 and v11 object detection models. My assumption was that in both cases (training and inference) images were simply resized to 640 if they were larger. Is this actually the case? If I train on 1280 and perform inference on 1280, is the full resolution used in some or all of the inference process?

Thanks!

[deepanalyticszlc]

I should clarify, if I train on 1280x1280, perform inference on 1280x1280, and have imgsz for each set to 1280, will the full 1280 resolution be used in training and inference?

[glenn-jocher]

@deepanalyticszlc yes, if you set imgsz=1280 during both training and inference, the full 1280x1280 resolution will be used throughout the process. Images are resized to this dimension before being processed by the model. This ensures consistency in resolution between training and inference, which can improve performance, particularly for detecting smaller objects. Let me know if you have further questions!

[mozeqiu123]

When training the yolov11 obb model, does it default to data enhancement for Soviet and Korean dramas?

[glenn-jocher]

@mozeqiu123 yOLO11 does not default to specific data augmentation for Soviet or Korean dramas. Instead, it uses general augmentation techniques such as mosaic, mixup, and color adjustments, which can be customized for any dataset. Refer to the augmentation settings for more details.

[jishenghuang]

May I ask which metric should be compared to select the best model, best.pt, and then save it?

[glenn-jocher]

@jishenghuang to select the best model, compare validation metrics such as mAP (mean Average Precision), which is typically logged during training. The model with the highest mAP at the desired IoU threshold is usually chosen as the

[jishenghuang]

@glenn-jocher

The mAP you mentioned will have two during the training phase: mAP50 and mAP50-95. These are my training records. Which indicator will the model choose to save best. pt based on among the indicators I have framed

[glenn-jocher]

@jishenghuang the best.pt model is saved based on the highest mAP50-95 (mean average precision over IoU thresholds 0.5 to 0.95) during validation. This metric provides a comprehensive evaluation of model performance across different IoU levels. For further details, refer to the Train Mode documentation. Let me know if you have additional questions!

[Aftondil]

why everything is different when we train model in colab and bring own device. when i use colab it implements albumentations automatically but when i use my own pc even training process was going wrong , am i missing something

[glenn-jocher]

@Aftondil the difference likely stems from variations in your environment setup. Google Colab may apply additional configurations like Albumentations automatically, which might not be enabled in your local setup. Ensure your local training uses the same ultralytics version and dependencies as in Colab. For Albumentations, verify that it's installed and correctly configured in your local environment. Refer to Train Settings for detailed configuration options. Let me know if you need further assistance!

[Aftondil]

like i have problem with training itself, i get such results, but with colab everything goes smooth

[glenn-jocher]

@Aftondil it seems like there may be inconsistencies in your local setup compared to Colab. Please ensure you are using the same ultralytics version (pip show ultralytics) and have the required dependencies installed (pip install -U ultralytics). If Albumentations isn't applied locally, confirm its installation (pip install albumentations) and check your dataset augmentation settings. For training issues, review your hardware configuration, dataset paths, and hyperparameters. Refer to the Train Settings for guidance. Let me know if you need further clarification!

[MSGinside]

Hello, I am currently working on for object detection task with yolo v 11.

I have one question with augmentation which is about copy_pasting.

The document mentions that we need segmentation mask for using the implemented copy paste method, however my current yolo annotation files for object detection only includes bbox coordinated along with class labels. Thus, my question essentially is how should my label files be structured to use copy paste augmentation?

Should i use yolo segmentation label format rather than bbox format?

Also, great thanks for ultralytics community for open-sourcing finest model for everyone.

[glenn-jocher]

@MSGinside to use the copy-paste augmentation feature, your dataset must include segmentation masks, as it relies on these to accurately copy and paste objects. Since your current YOLO annotation format only includes bounding boxes, you would need to convert your annotations to include segmentation masks in a compatible format like the YOLO segmentation label format. For more details, refer to the augmentation settings in the Ultralytics documentation. Also, thank you for your kind words—the credit goes to the YOLO community and the Ultralytics team!

[techsupportsardonyx]

I'm facing a double detection issue when using the YOLO pretrained model, particularly with motorbikes and people. To address this, I adjusted the confidence threshold and IoU threshold values. This has reduced the double detection issue for motorbikes, but not entirely—what used to detect as 10 errors has now reduced to 2 errors. However, this adjustment has affected detection accuracy in other classifications.

Is there a way to set values specifically for motorbikes to reduce double detection without impacting other classifications? Or is there any other method to solve this issue? Do you know of any related solutions?

[glenn-jocher]

To reduce double detections for motorbikes without impacting other classes, consider fine-tuning the model on a custom dataset labeled specifically for motorbikes with accurate annotations. Alternatively, you can apply class-specific post-processing techniques, such as adjusting the Non-Maximum Suppression (NMS) threshold for motorbike detections only. For more details on training and customization, refer to the Train Settings documentation.

[techsupportsardonyx]

Can you explain in detail how to adjust the Non-Maximum Suppression (NMS) threshold specifically for motorbikes?

[glenn-jocher]

To adjust the Non-Maximum Suppression (NMS) threshold specifically for motorbikes, you can implement class-specific NMS during the post-processing step. This involves modifying the NMS algorithm to apply a unique IoU threshold for motorbikes while keeping other thresholds unchanged. Unfortunately, this requires custom code as current YOLO implementations apply a single NMS threshold globally. If needed, consult the YOLO documentation to explore the configuration options available.

[DarioJZB]

model = YOLO('runs/detect/headphones_detector/weights/best.pt')

model.export(format='tfjs')

tfjs_model = YOLO("./yolo11n_web_model")

I am running those commands but the program crashes with not having the tflite_support. I try to install but its not compatible with the current python version. How else can I export the model in tensorflowjs?

thank you.

[glenn-jocher]

@DarioJZB the TensorFlow.js export requires the tflite_support package, which has compatibility limitations. If this issue persists, consider using a Python environment compatible with tflite_support (Python <=3.9) or exporting the model to ONNX or TensorFlow SavedModel format and then converting it to TensorFlow.js using the TensorFlow.js converter. Let us know if you need further assistance!

[zhongkunh]

I have collected lots of images by web crawler, and found there was some repeating images. Should I manually delete the repetitive images or it does not matter.

[glenn-jocher]

@zhongkunh it's recommended to remove duplicate images from your dataset before training, as they can lead to overfitting and biased model performance. Ensuring a diverse and representative dataset generally yields better results.

[vikassnwl]

Hello, I am new to Ultralytics and YOLO. Today I trained a model using yolo11n-cls.pt on a custom dataset. Train accuracy info was missing during each epoch. It was showing validation accuracy only. Is there any way to show train accuracy as well during training?

[glenn-jocher]

@vikassnwl currently, YOLO11's training process does not display training accuracy during each epoch, focusing instead on validation metrics. For in-depth monitoring, you can use logging tools like TensorBoard, which provide additional insights, including training metrics. You can learn more about logging capabilities here.

[vikassnwl]

Thanks @glenn-jocher for your response. I appreciate it that you guys are actively responding to every user's comments and resolving their issue.

[glenn-jocher]

Thank you for the kind words! The Ultralytics team's goal is to support and empower the YOLO community, and we’re glad to assist. If you have further questions or need guidance, feel free to ask!

[zhongkunh]

When training, is it necessary to rename all images to 1,2,3,..., or just keep each corresponding annotation and image have the same name is okay?

[glenn-jocher]

It is not necessary to rename all images sequentially. As long as each image and its corresponding annotation file share the same base name (e.g., image1.jpg and image1.xml), the dataset will function correctly during training. For more details, you can refer to the dataset preparation guidelines in the documentation.