>:j'6SSKJr SSKrSSKJr SSKJr SSKrSSKJr SSK J r J r J r J r Jr SSKJr SSKJr SS KJr SS KJr SS KJr SS KJrJr SS KJr SSKJr SSK J!r! \"5(a SSK"J#r#J$r$J%r% \RL"\'5r("SS\5r)g)) annotationsN)Callable)Any)nn)EvalPredictionFeatureExtractionMixinPreTrainedTokenizerBaseProcessorMixinTrainerCallback)BaseImageProcessor) BaseEvaluator) BaseTrainer)SentenceTransformerDataCollator)SentenceTransformer)$SentenceTransformerModelCardCallback SentenceTransformerModelCardData)$SentenceTransformerTrainingArguments)is_datasets_available)deprecated_kwargs)Dataset DatasetDictIterableDatasetc^\rSrSrSr\r\r\ r \ r \ r\"SS9SS U4Sjjj5rS SjrSrU=r$) SentenceTransformerTrainer$u SentenceTransformerTrainer is a simple but feature-complete training and eval loop for PyTorch based on the 🤗 Transformers :class:`~transformers.Trainer`. This trainer integrates support for various :class:`transformers.TrainerCallback` subclasses, such as: - :class:`~transformers.integrations.WandbCallback` to automatically log training metrics to W&B if `wandb` is installed - :class:`~transformers.integrations.TensorBoardCallback` to log training metrics to TensorBoard if `tensorboard` is accessible. - :class:`~transformers.integrations.CodeCarbonCallback` to track the carbon emissions of your model during training if `codecarbon` is installed. - Note: These carbon emissions will be included in your automatically generated model card. See the Transformers `Callbacks `_ documentation for more information on the integrated callbacks and how to write your own callbacks. Args: model (:class:`~sentence_transformers.sentence_transformer.model.SentenceTransformer`, *optional*): The model to train, evaluate or use for predictions. If not provided, a `model_init` must be passed. args (:class:`~sentence_transformers.sentence_transformer.training_args.SentenceTransformerTrainingArguments`, *optional*): The arguments to tweak for training. Will default to a basic instance of :class:`~sentence_transformers.sentence_transformer.training_args.SentenceTransformerTrainingArguments` with the `output_dir` set to a directory named *tmp_trainer* in the current directory if not provided. train_dataset (Union[:class:`datasets.Dataset`, :class:`datasets.DatasetDict`, :class:`datasets.IterableDataset`, Dict[str, :class:`datasets.Dataset`]], *optional*): The dataset to use for training. Must have a format accepted by your loss function, see `Training Overview > Dataset Format <../../../docs/sentence_transformer/training_overview.html#dataset-format>`_. eval_dataset (Union[:class:`datasets.Dataset`, :class:`datasets.DatasetDict`, :class:`datasets.IterableDataset`, Dict[str, :class:`datasets.Dataset`]], *optional*): The dataset to use for evaluation. Must have a format accepted by your loss function, see `Training Overview > Dataset Format <../../../docs/sentence_transformer/training_overview.html#dataset-format>`_. loss (Optional[Union[:class:`torch.nn.Module`, Dict[str, :class:`torch.nn.Module`], Callable[[:class:`~sentence_transformers.sentence_transformer.model.SentenceTransformer`], :class:`torch.nn.Module`], Dict[str, Callable[[:class:`~sentence_transformers.sentence_transformer.model.SentenceTransformer`]]]], *optional*): The loss function to use for training. Can either be a loss class instance, a dictionary mapping dataset names to loss class instances, a function that returns a loss class instance given a model, or a dictionary mapping dataset names to functions that return a loss class instance given a model. In practice, the latter two are primarily used for hyper-parameter optimization. Will default to :class:`~sentence_transformers.sentence_transformer.losses.CoSENTLoss` if no ``loss`` is provided. evaluator (Union[:class:`~sentence_transformers.base.evaluation.BaseEvaluator`, List[:class:`~sentence_transformers.base.evaluation.BaseEvaluator`]], *optional*): The evaluator instance for useful evaluation metrics during training. You can use an ``evaluator`` with or without an ``eval_dataset``, and vice versa. Generally, the metrics that an ``evaluator`` returns are more useful than the loss value returned from the ``eval_dataset``. A list of evaluators will be wrapped in a :class:`~sentence_transformers.base.evaluation.SequentialEvaluator` to run them sequentially. callbacks (List of [:class:`transformers.TrainerCallback`], *optional*): A list of callbacks to customize the training loop. Will add those to the list of default callbacks detailed in [here](callback). If you want to remove one of the default callbacks used, use the [`Trainer.remove_callback`] method. optimizers (`Tuple[:class:`torch.optim.Optimizer`, :class:`torch.optim.lr_scheduler.LambdaLR`]`, *optional*, defaults to `(None, None)`): A tuple containing the optimizer and the scheduler to use. Will default to an instance of :class:`torch.optim.AdamW` on your model and a scheduler given by :func:`transformers.get_linear_schedule_with_warmup` controlled by `args`. Important attributes: - **model** -- Always points to the core model. If using a transformers model, it will be a [`PreTrainedModel`] subclass. - **model_wrapped** -- Always points to the most external model in case one or more other modules wrap the original model. This is the model that should be used for the forward pass. For example, under `DeepSpeed`, the inner model is wrapped in `DeepSpeed` and then again in `torch.nn.DistributedDataParallel`. If the inner model hasn't been wrapped, then `self.model_wrapped` is the same as `self.model`. - **is_model_parallel** -- Whether or not a model has been switched to a model parallel mode (different from data parallelism, this means some of the model layers are split on different GPUs). - **place_model_on_device** -- Whether or not to automatically place the model on the device - it will be set to `False` if model parallel or deepspeed is used, or if the default `TrainingArguments.place_model_on_device` is overridden to return `False` . - **is_in_train** -- Whether or not a model is currently running `train` (e.g. when `evaluate` is called while in `train`) processing_class) tokenizercF>[TU]UUUUUUUUU U U U U US9 U U U g)N)modelargs train_dataset eval_datasetloss evaluator data_collatorr model_initcompute_metrics callbacks optimizersoptimizer_cls_and_kwargspreprocess_logits_for_metrics)super__init__)selfrr r!r"r#r$r%rr&r'r(r)r*r+ __class__s o/home/mande/repo/quber/.venv/lib/python3.13/site-packages/sentence_transformers/sentence_transformer/trainer.pyr-#SentenceTransformerTrainer.__init__psL4 '%'-!+!%=*G    c|SSKJn U"U5n[RSURR S35 U$)Nr) CoSENTLosszNo `loss` passed, using `z` as a default option.)1sentence_transformers.sentence_transformer.lossesr4loggerinfor/__name__)r.rr4r#s r0get_default_loss+SentenceTransformerTrainer.get_default_losss6P%  /0G0G/HH^_` r2)NNNNNNNNNNN)NNNN)rzSentenceTransformer | Noner z+SentenceTransformerTrainingArguments | Noner!CDataset | DatasetDict | IterableDataset | dict[str, Dataset] | Noner"r<r#znn.Module | dict[str, nn.Module] | Callable[[SentenceTransformer], torch.nn.Module] | dict[str, Callable[[SentenceTransformer], torch.nn.Module]] | Noner$z*BaseEvaluator | list[BaseEvaluator] | Noner%z&SentenceTransformerDataCollator | Nonerz]PreTrainedTokenizerBase | BaseImageProcessor | FeatureExtractionMixin | ProcessorMixin | Noner&z(Callable[[], SentenceTransformer] | Noner'z'Callable[[EvalPrediction], dict] | Noner(zlist[TrainerCallback] | Noner)z?tuple[torch.optim.Optimizer, torch.optim.lr_scheduler.LambdaLR]r*z9tuple[type[torch.optim.Optimizer], dict[str, Any]] | Noner+z;Callable[[torch.Tensor, torch.Tensor], torch.Tensor] | NonereturnNone)rrr=ztorch.nn.Module)r8 __module__ __qualname____firstlineno____doc__r model_classrmodel_card_data_classrmodel_card_callback_classrdata_collator_classrtraining_args_classrr-r9__static_attributes__ __classcell__)r/s@r0rr$sCJ&K< D9>!34-1<@]a\` @D@D ?CCG26Vb^bei/+<)+<:+<[ +< Z +<  +<>+<>+<+<$=%+<&A'+<(0)+<*T++<,#\-+<.(c/+<0 1+<5+r[sq"$ C?:dPj<C>>   8 $r2