|h(ddlmZddlmZmZmZddlZddlmZmZddl m Z ddl m Z ddl mZddlmZmZmZdd lmZmZdd lmZmZmZGd d e Zy) )copy)AnyDictOptionalN)ClassificationDatasetbuild_dataloader) BaseTrainer)yolo)ClassificationModel) DEFAULT_CFGLOGGERRANK) plot_images plot_results) is_parallelstrip_optimizertorch_distributed_zero_firstc NeZdZdZeddfdeeeefffd Z dZ dde fdZ fdZ dd ed efd Zdd ed eded efdZdeeej$fdeeej$ffdZdefdZdZddeej$defdZdZdZdeeej$fdefdZxZS) ClassificationTraineraV A trainer class extending BaseTrainer for training image classification models. This trainer handles the training process for image classification tasks, supporting both YOLO classification models and torchvision models with comprehensive dataset handling and validation. Attributes: model (ClassificationModel): The classification model to be trained. data (Dict[str, Any]): Dictionary containing dataset information including class names and number of classes. loss_names (List[str]): Names of the loss functions used during training. validator (ClassificationValidator): Validator instance for model evaluation. Methods: set_model_attributes: Set the model's class names from the loaded dataset. get_model: Return a modified PyTorch model configured for training. setup_model: Load, create or download model for classification. build_dataset: Create a ClassificationDataset instance. get_dataloader: Return PyTorch DataLoader with transforms for image preprocessing. preprocess_batch: Preprocess a batch of images and classes. progress_string: Return a formatted string showing training progress. get_validator: Return an instance of ClassificationValidator. label_loss_items: Return a loss dict with labelled training loss items. plot_metrics: Plot metrics from a CSV file. final_eval: Evaluate trained model and save validation results. plot_training_samples: Plot training samples with their annotations. Examples: Initialize and train a classification model >>> from ultralytics.models.yolo.classify import ClassificationTrainer >>> args = dict(model="yolo11n-cls.pt", data="imagenet10", epochs=3) >>> trainer = ClassificationTrainer(overrides=args) >>> trainer.train() N overridescf|i}d|d<|jdd|d<t| |||y)ay Initialize a ClassificationTrainer object. This constructor sets up a trainer for image classification tasks, configuring the task type and default image size if not specified. Args: cfg (Dict[str, Any], optional): Default configuration dictionary containing training parameters. overrides (Dict[str, Any], optional): Dictionary of parameter overrides for the default configuration. _callbacks (List[Any], optional): List of callback functions to be executed during training. Examples: Create a trainer with custom configuration >>> from ultralytics.models.yolo.classify import ClassificationTrainer >>> args = dict(model="yolo11n-cls.pt", data="imagenet10", epochs=3) >>> trainer = ClassificationTrainer(overrides=args) >>> trainer.train() Nclassifytaskimgsz)getsuper__init__)selfcfgr _callbacks __class__s e/var/www/html/test/engine/venv/lib/python3.12/site-packages/ultralytics/models/yolo/classify/train.pyrzClassificationTrainer.__init__4sD&  I& & == ! )!$Ig  i4c@|jd|j_y)z9Set the YOLO model's class names from the loaded dataset.namesN)datamodelr&rs r#set_model_attributesz*ClassificationTrainer.set_model_attributesNs99W- r$verbosect||jd|jd|xr tdk(}|r|j||j D]}|j j st|dr|jt|tjjsZ|j jsq|j j|_|jD] }d|_ |S)a Return a modified PyTorch model configured for training YOLO classification. Args: cfg (Any, optional): Model configuration. weights (Any, optional): Pre-trained model weights. verbose (bool, optional): Whether to display model information. Returns: (ClassificationModel): Configured PyTorch model for classification. ncchannels)r-chr+reset_parametersT)r r'rloadmodulesargs pretrainedhasattrr1 isinstancetorchnnDropoutdropoutp parameters requires_grad)rr weightsr+r(mr<s r# get_modelzClassificationTrainer.get_modelRs$CDIIdO *@U_f_ukosukuv  JJw  (A99''GA7I,J""$!UXX--.4993D3Dii''  ( !!# #A"AO # r$cpddl}t|j|jjvrJ|jj|j|j j rdnd|_d}nt|!}tj|j|jd|S)z Load, create or download model for classification tasks. Returns: (Any): Model checkpoint if applicable, otherwise None. rN IMAGENET1K_V1)r?r-) torchvisionstrr(models__dict__r4r5r setup_modelr reshape_outputsr')rrDckptr"s r#rHz!ClassificationTrainer.setup_modelks  tzz?k0099 9@++44TZZ@+/99+?+?TDJD7&(D++DJJ $H r$img_pathmodec:t||j|dk(|S)a Create a ClassificationDataset instance given an image path and mode. Args: img_path (str): Path to the dataset images. mode (str, optional): Dataset mode ('train', 'val', or 'test'). batch (Any, optional): Batch information (unused in this implementation). Returns: (ClassificationDataset): Dataset for the specified mode. train)rootr4augmentprefix)rr4)rrKrLbatchs r# build_datasetz#ClassificationTrainer.build_dataset~s%(DT[Odhiir$ dataset_path batch_sizerankct|5|j||}dddt||jj|}|dk7rkt |j r1|jj|j j_ |S|jj|j _ |S#1swYxYw)a Return PyTorch DataLoader with transforms to preprocess images. Args: dataset_path (str): Path to the dataset. batch_size (int, optional): Number of images per batch. rank (int, optional): Process rank for distributed training. mode (str, optional): 'train', 'val', or 'test' mode. Returns: (torch.utils.data.DataLoader): DataLoader for the specified dataset and mode. N)rVrN) rrSrr4workersrr(datasettorch_transformsmodule transforms)rrTrUrVrLrYloaders r#get_dataloaderz$ClassificationTrainer.get_dataloaders*$ / =((tKK-s# 67/3yy~~DNN'',04 DNN''-#'>>>#:DLLL$$Y5&&'9: ;r$nictjt|d|d<t||jd|dz |j y)z Plot training samples with their annotations. Args: batch (Dict[str, torch.Tensor]): Batch containing images and class labels. ni (int): Number of iterations. ra batch_idx train_batchz.jpg)labelsfnamerN)r8arangermrrtr)rrRrs r#plot_training_samplesz+ClassificationTrainer.plot_training_samplessG#\\#eEl*;<k--Kt4"88LL r$)NNT)rNN)rrN)NrN)__name__ __module__ __qualname____doc__r rrrErrr*boolrArHrSintr^r8Tensorrerorvrrrr __classcell__)r"s@r#rrs D'd_c58DcN3K54.2& jc j j3CC[^2d3 +<&=$sELLGXBY    +8ELL+A+RU+$I ;  4U\\0A+B    r$r)rtypingrrrr8ultralytics.datarrultralytics.engine.trainerr ultralytics.modelsr ultralytics.nn.tasksr ultralytics.utilsr r rultralytics.utils.plottingrrultralytics.utils.torch_utilsrrrrr$r#rs<&& D2#477@dd[ K[ r$