code: 
  '''simple docstring'''
  
  
  
  from sklearn.metrics import roc_auc_score
  
  import datasets
  
  
  __A          =    "\nThis metric computes the area under the curve (AUC) for the Receiver Operating Characteristic Curve (ROC). The return values represent how well the model used is predicting the correct classes, based on the input data. A score of `0.5` means that the model is predicting exactly at chance, i.e. the model's predictions are correct at the same rate as if the predictions were being decided by the flip of a fair coin or the roll of a fair die. A score above `0.5` indicates that the model is doing better than chance, while a score below `0.5` indicates that the model is doing worse than chance.\n\nThis metric has three separate use cases:\n    - binary: The case in which there are only two different label classes, and each example gets only one label. This is the default implementation.\n    - multiclass: The case in which there can be more than two different label classes, but each example still gets only one label.\n    - multilabel: The case in which there can be more than two different label classes, and each example can have more than one label.\n"
  
  __A          =    "\nArgs:\n- references (array-like of shape (n_samples,) or (n_samples, n_classes)): Ground truth labels. Expects different input based on use case:\n    - binary: expects an array-like of shape (n_samples,)\n    - multiclass: expects an array-like of shape (n_samples,)\n    - multilabel: expects an array-like of shape (n_samples, n_classes)\n- prediction_scores (array-like of shape (n_samples,) or (n_samples, n_classes)): Model predictions. Expects different inputs based on use case:\n    - binary: expects an array-like of shape (n_samples,)\n    - multiclass: expects an array-like of shape (n_samples, n_classes)\n    - multilabel: expects an array-like of shape (n_samples, n_classes)\n- average (`str`): Type of average, and is ignored in the binary use case. Defaults to 'macro'. Options are:\n    - `'micro'`: Calculates metrics globally by considering each element of the label indicator matrix as a label. Only works with the multilabel use case.\n    - `'macro'`: Calculate metrics for each label, and find their unweighted mean.  This does not take label imbalance into account.\n    - `'weighted'`: Calculate metrics for each label, and find their average, weighted by support (i.e. the number of true instances for each label).\n    - `'samples'`: Calculate metrics for each instance, and find their average. Only works with the multilabel use case.\n    - `None`:  No average is calculated, and scores for each class are returned. Only works with the multilabels use case.\n- sample_weight (array-like of shape (n_samples,)): Sample weights. Defaults to None.\n- max_fpr (`float`): If not None, the standardized partial AUC over the range [0, `max_fpr`] is returned. Must be greater than `0` and less than or equal to `1`. Defaults to `None`. Note: For the multiclass use case, `max_fpr` should be either `None` or `1.0` as ROC AUC partial computation is not currently supported for `multiclass`.\n- multi_class (`str`): Only used for multiclass targets, where it is required. Determines the type of configuration to use. Options are:\n    - `'ovr'`: Stands for One-vs-rest. Computes the AUC of each class against the rest. This treats the multiclass case in the same way as the multilabel case. Sensitive to class imbalance even when `average == 'macro'`, because class imbalance affects the composition of each of the 'rest' groupings.\n    - `'ovo'`: Stands for One-vs-one. Computes the average AUC of all possible pairwise combinations of classes. Insensitive to class imbalance when `average == 'macro'`.\n- labels (array-like of shape (n_classes,)): Only used for multiclass targets. List of labels that index the classes in\n    `prediction_scores`. If `None`, the numerical or lexicographical order of the labels in\n    `prediction_scores` is used. Defaults to `None`.\nReturns:\n    roc_auc (`float` or array-like of shape (n_classes,)): Returns array if in multilabel use case and `average='None'`. Otherwise, returns `float`.\nExamples:\n    Example 1:\n        >>> roc_auc_score = datasets.load_metric(\"roc_auc\")\n        >>> refs = [1, 0, 1, 1, 0, 0]\n        >>> pred_scores = [0.5, 0.2, 0.99, 0.3, 0.1, 0.7]\n        >>> results = roc_auc_score.compute(references=refs, prediction_scores=pred_scores)\n        >>> print(round(results['roc_auc'], 2))\n        0.78\n\n    Example 2:\n        >>> roc_auc_score = datasets.load_metric(\"roc_auc\", \"multiclass\")\n        >>> refs = [1, 0, 1, 2, 2, 0]\n        >>> pred_scores = [[0.3, 0.5, 0.2],\n        ...                 [0.7, 0.2, 0.1],\n        ...                 [0.005, 0.99, 0.005],\n        ...                 [0.2, 0.3, 0.5],\n        ...                 [0.1, 0.1, 0.8],\n        ...                 [0.1, 0.7, 0.2]]\n        >>> results = roc_auc_score.compute(references=refs, prediction_scores=pred_scores, multi_class='ovr')\n        >>> print(round(results['roc_auc'], 2))\n        0.85\n\n    Example 3:\n        >>> roc_auc_score = datasets.load_metric(\"roc_auc\", \"multilabel\")\n        >>> refs = [[1, 1, 0],\n        ...         [1, 1, 0],\n        ...         [0, 1, 0],\n        ...         [0, 0, 1],\n        ...         [0, 1, 1],\n        ...         [1, 0, 1]]\n        >>> pred_scores = [[0.3, 0.5, 0.2],\n        ...                 [0.7, 0.2, 0.1],\n        ...                 [0.005, 0.99, 0.005],\n        ...                 [0.2, 0.3, 0.5],\n        ...                 [0.1, 0.1, 0.8],\n        ...                 [0.1, 0.7, 0.2]]\n        >>> results = roc_auc_score.compute(references=refs, prediction_scores=pred_scores, average=None)\n        >>> print([round(res, 2) for res in results['roc_auc']])\n        [0.83, 0.38, 0.94]\n"
  
  __A          =    "\\n@article{doi:10.1177/0272989X8900900307,\nauthor = {Donna Katzman McClish},\ntitle ={Analyzing a Portion of the ROC Curve},\njournal = {Medical Decision Making},\nvolume = {9},\nnumber = {3},\npages = {190-195},\nyear = {1989},\ndoi = {10.1177/0272989X8900900307},\n    note ={PMID: 2668680},\nURL = {https://doi.org/10.1177/0272989X8900900307},\neprint = {https://doi.org/10.1177/0272989X8900900307}\n}\n\n\n@article{10.1023/A:1010920819831,\nauthor = {Hand, David J. and Till, Robert J.},\ntitle = {A Simple Generalisation of the Area Under the ROC Curve for Multiple Class Classification Problems},\nyear = {2001},\nissue_date = {November 2001},\npublisher = {Kluwer Academic Publishers},\naddress = {USA},\nvolume = {45},\nnumber = {2},\nissn = {0885-6125},\nurl = {https://doi.org/10.1023/A:1010920819831},\ndoi = {10.1023/A:1010920819831},\njournal = {Mach. Learn.},\nmonth = {oct},\npages = {171–186},\nnumpages = {16},\nkeywords = {Gini index, AUC, error rate, ROC curve, receiver operating characteristic}\n}\n\n\n@article{scikit-learn,\ntitle={Scikit-learn: Machine Learning in {P}ython},\nauthor={Pedregosa, F. and Varoquaux, G. and Gramfort, A. and Michel, V. and Thirion, B. and Grisel, O. and Blondel, M. and Prettenhofer, P. and Weiss, R. and Dubourg, V. and Vanderplas, J. and Passos, A. and Cournapeau, D. and Brucher, M. and Perrot, M. and Duchesnay, E.},\njournal={Journal of Machine Learning Research},\nvolume={12},\npages={2825--2830},\nyear={2011}\n}\n"
  
  
  
  
  
  @datasets.utils.file_utils.add_start_docstrings(_DESCRIPTION		,						_KWARGS_DESCRIPTION				)
  class 			A							(       datasets.Metric				):
  
  
  
  			def A__ (					self       )			->		Any:
  
  
  
  
  									'''simple docstring'''
  
  
  
  									return datasets.MetricInfo(
  									    description=_DESCRIPTION       ,     citation=_CITATION       ,     inputs_description=_KWARGS_DESCRIPTION       ,     features=datasets.Features(
  									        {
  									            """prediction_scores""": datasets.Sequence(datasets.Value("""float"""       )       ),
  									            """references""": datasets.Value("""int32"""       ),
  									        }
  									        if self.config_name == """multiclass"""
  									        else {
  									            """references""": datasets.Sequence(datasets.Value("""int32"""       )       ),
  									            """prediction_scores""": datasets.Sequence(datasets.Value("""float"""       )       ),
  									        }
  									        if self.config_name == """multilabel"""
  									        else {
  									            """references""": datasets.Value("""int32"""       ),
  									            """prediction_scores""": datasets.Value("""float"""       ),
  									        }       )       ,     reference_urls=["""https://scikit-learn.org/stable/modules/generated/sklearn.metrics.roc_auc_score.html"""]       ,     )
  
  
  
  			def A__ (					self       ,     lowerCamelCase__       ,     lowerCamelCase__       ,     lowerCamelCase__="macro"       ,     lowerCamelCase__=None       ,     lowerCamelCase__=None       ,     lowerCamelCase__="raise"       ,     lowerCamelCase__=None       ,     )			->		Union[str, Any]:
  
  
  
  
  									'''simple docstring'''
  
  
  
  									return {
  									    "roc_auc": roc_auc_score(
  									        lowerCamelCase__       ,     lowerCamelCase__       ,     average=lowerCamelCase__       ,     sample_weight=lowerCamelCase__       ,     max_fpr=lowerCamelCase__       ,     multi_class=lowerCamelCase__       ,     labels=lowerCamelCase__       ,     )
  									}
  
  
  
  
  
  
  
style_context: 
  '''simple docstring'''
  
  
  
  import timeit
  from typing import Callable, Optional
  
  from ..configuration_utils import PretrainedConfig
  from ..models.auto.modeling_auto import MODEL_MAPPING, MODEL_WITH_LM_HEAD_MAPPING
  from ..utils import is_pyanvml_available, is_torch_available, logging
  from .benchmark_utils import (
      Benchmark,
      Memory,
      MemorySummary,
      measure_peak_memory_cpu,
      start_memory_tracing,
      stop_memory_tracing,
  )
  
  
  if is_torch_available():
  				import torch
  
  				from .benchmark_args import PyTorchBenchmarkArguments
  
  
  if is_pyanvml_available():
  				import pyanvml.pyanvml as nvml
  
  
  __A          =    logging.get_logger(__name__)
  
  
  
  
  
  class 			A							(       __UpperCAmelCase				):
  			lowerCamelCase							:							PyTorchBenchmarkArguments
  			lowerCamelCase							:							PretrainedConfig
  			lowerCamelCase							:							str       		=  "PyTorch"
  
  
  
  			@property
  			def A__ (					self       )			->		Union[str, Any]:
  
  
  
  
  									'''simple docstring'''
  
  
  
  									return torch.__version__
  
  
  
  			def A__ (					self       ,     lowerCamelCase__       ,     lowerCamelCase__       ,     lowerCamelCase__       )			->		float:
  
  
  
  
  									'''simple docstring'''
  
  
  
  									lowercase__							 =       self._prepare_inference_func(lowerCamelCase__       ,     lowerCamelCase__       ,     lowerCamelCase__       )
  									return self._measure_speed(_inference       )
  
  
  
  			def A__ (					self       ,     lowerCamelCase__       ,     lowerCamelCase__       ,     lowerCamelCase__       )			->		[Memory, Optional[MemorySummary]]:
  
  
  
  
  									'''simple docstring'''
  
  
  
  									lowercase__							 =       self._prepare_inference_func(lowerCamelCase__       ,     lowerCamelCase__       ,     lowerCamelCase__       )
  									return self._measure_memory(_inference       )
  
  
  
  			def A__ (					self       ,     lowerCamelCase__       ,     lowerCamelCase__       ,     lowerCamelCase__       )			->		float:
  
  
  
  
  									'''simple docstring'''
  
  
  
  									lowercase__							 =       self._prepare_train_func(lowerCamelCase__       ,     lowerCamelCase__       ,     lowerCamelCase__       )
  									return self._measure_speed(_train       )
  
  
  
  			def A__ (					self       ,     lowerCamelCase__       ,     lowerCamelCase__       ,     lowerCamelCase__       )			->		[Memory, Optional[MemorySummary]]:
  
  
  
  
  									'''simple docstring'''
  
  
  
  									lowercase__							 =       self._prepare_train_func(lowerCamelCase__       ,     lowerCamelCase__       ,     lowerCamelCase__       )
  									return self._measure_memory(_train       )
  
  
  
  			def A__ (					self       ,     lowerCamelCase__       ,     lowerCamelCase__       ,     lowerCamelCase__       )			->		Callable[[], None]:
  
  
  
  
  									'''simple docstring'''
  
  
  
  									lowercase__							 =       self.config_dict[model_name]
  
  									if self.args.torchscript:
  															lowercase__							 =       True
  
  									lowercase__							 =       (
  									    hasattr(lowerCamelCase__       ,     """architectures"""       )
  									    and isinstance(config.architectures       ,     lowerCamelCase__       )
  									    and len(config.architectures       ) > 0
  									)
  									if not self.args.only_pretrain_model and has_model_class_in_config:
  															try:
  																					lowercase__							 =       config.architectures[0]
  																					lowercase__							 =       __import__("""transformers"""       ,     fromlist=[model_class]       )
  																					lowercase__							 =       getattr(lowerCamelCase__       ,     lowerCamelCase__       )
  																					lowercase__							 =       model_cls(lowerCamelCase__       )
  															except ImportError:
  																					raise ImportError(
  																					    F'''{model_class} does not exist. If you just want to test the pretrained model, you might want to'''
  																					    """ set `--only_pretrain_model` or `args.only_pretrain_model=True`."""       )
  									else:
  															lowercase__							 =       MODEL_MAPPING[config.__class__](lowerCamelCase__       )
  
  									model.eval()
  									model.to(self.args.device       )
  
  									# encoder-decoder has vocab size saved differently
  									lowercase__							 =       config.vocab_size if hasattr(lowerCamelCase__       ,     """vocab_size"""       ) else config.encoder.vocab_size
  									lowercase__							 =       torch.randint(lowerCamelCase__       ,     (batch_size, sequence_length)       ,     dtype=torch.long       ,     device=self.args.device       )
  
  									if self.args.fpaa:
  															logger.info("""Running training in Mixed Precision..."""       )
  															if not self.args.is_gpu:
  																					raise ValueError("""Mixed precision is possible only for GPU."""       )
  															# amp seems to have memory leaks so that memory usage
  															# is measured using .half() for now https://github.com/NVIDIA/apex/issues/439
  															model.half()
  
  									if self.args.torchscript:
  															with torch.no_grad():
  																					lowercase__							 =       torch.jit.trace(lowerCamelCase__       ,     lowerCamelCase__       )
  									else:
  															lowercase__							 =       model
  
  									def encoder_decoder_forward():
  															with torch.no_grad():
  																					lowercase__							 =       inference_model(lowerCamelCase__       ,     decoder_input_ids=lowerCamelCase__       )
  															return outputs
  
  									def encoder_forward():
  															with torch.no_grad():
  																					lowercase__							 =       inference_model(lowerCamelCase__       )
  															return outputs
  
  									lowercase__							 =       encoder_decoder_forward if config.is_encoder_decoder else encoder_forward
  									return _forward
  
  
  
  			def A__ (					self       ,     lowerCamelCase__       ,     lowerCamelCase__       ,     lowerCamelCase__       )			->		Callable[[], None]:
  
  
  
  
  									'''simple docstring'''
  
  
  
  									lowercase__							 =       self.config_dict[model_name]
  
  									lowercase__							 =       (
  									    hasattr(lowerCamelCase__       ,     """architectures"""       )
  									    and isinstance(config.architectures       ,     lowerCamelCase__       )
  									    and len(config.architectures       ) > 0
  									)
  									if not self.args.only_pretrain_model and has_model_class_in_config:
  															try:
  																					lowercase__							 =       config.architectures[0]
  																					lowercase__							 =       __import__("""transformers"""       ,     fromlist=[model_class]       )
  																					lowercase__							 =       getattr(lowerCamelCase__       ,     lowerCamelCase__       )
  																					lowercase__							 =       model_cls(lowerCamelCase__       )
  															except ImportError:
  																					raise ImportError(
  																					    F'''{model_class} does not exist. If you just want to test the pretrained model, you might want to'''
  																					    """ set `--only_pretrain_model` or `args.only_pretrain_model=True`."""       )
  									else:
  															lowercase__							 =       MODEL_WITH_LM_HEAD_MAPPING[config.__class__](lowerCamelCase__       )
  
  									if self.args.torchscript:
  															raise NotImplementedError("""Training for torchscript is currently not implemented"""       )
  									else:
  															lowercase__							 =       model
  
  									model.train()
  									model.to(self.args.device       )
  
  									# encoder-decoder has vocab size saved differently
  									lowercase__							 =       config.vocab_size if hasattr(lowerCamelCase__       ,     """vocab_size"""       ) else config.encoder.vocab_size
  									lowercase__							 =       torch.randint(lowerCamelCase__       ,     (batch_size, sequence_length)       ,     dtype=torch.long       ,     device=self.args.device       )
  
  									if self.args.fpaa:
  															logger.info("""Running training in Mixed Precision..."""       )
  															if not self.args.is_gpu:
  																					raise ValueError("""Mixed precision is possible only for GPU."""       )
  
  															# amp seems to have memory leaks so that memory usage
  															# is measured using .half() for now https://github.com/NVIDIA/apex/issues/439
  															model.half()
  
  									def compute_loss_and_backprob_encoder():
  															lowercase__							 =       train_model(lowerCamelCase__       ,     labels=lowerCamelCase__       )[0]
  															loss.backward()
  															return loss
  
  									def compute_loss_and_backprob_encoder_decoder():
  															lowercase__							 =       train_model(lowerCamelCase__       ,     decoder_input_ids=lowerCamelCase__       ,     labels=lowerCamelCase__       )[0]
  															loss.backward()
  															return loss
  
  									lowercase__							 =       (
  									    compute_loss_and_backprob_encoder_decoder
  									    if config.is_encoder_decoder
  									    else compute_loss_and_backprob_encoder
  									)
  									return _train
  
  
  
  			def A__ (					self       ,     lowerCamelCase__       )			->		float:
  
  
  
  
  									'''simple docstring'''
  
  
  
  									try:
  															if self.args.is_tpu or self.args.torchscript:
  																					# run additional 10 times to stabilize compilation for tpu and torchscript
  																					logger.info("""Do inference on TPU or torchscript. Running model 5 times to stabilize compilation"""       )
  																					timeit.repeat(
  																					    lowerCamelCase__       ,     repeat=1       ,     number=5       ,     )
  
  															# as written in https://docs.python.org/2/library/timeit.html#timeit.Timer.repeat, min should be taken rather than the average
  															lowercase__							 =       timeit.repeat(
  															    lowerCamelCase__       ,     repeat=self.args.repeat       ,     number=10       ,     )
  
  															if self.args.is_tpu and self.args.torch_xla_tpu_print_metrics:
  																					import torch_xla.debug.metrics as met
  
  																					self.print_fn(met.metrics_report()       )
  
  															return min(lowerCamelCase__       ) / 10.0
  									except RuntimeError as e:
  															self.print_fn(F'''Doesn\'t fit on GPU. {e}'''       )
  															return "N/A"
  
  
  
  			def A__ (					self       ,     lowerCamelCase__       )			->		[Memory, MemorySummary]:
  
  
  
  
  									'''simple docstring'''
  
  
  
  									try:
  															if self.args.trace_memory_line_by_line:
  																					lowercase__							 =       start_memory_tracing("""transformers"""       )
  
  															if self.args.is_tpu:
  																					# tpu
  																					raise NotImplementedError(
  																					    """Memory Benchmarking is currently not implemented for TPU. Please disable memory benchmarking with"""
  																					    """ `--no-memory` or `args.memory=False`"""       )
  															elif self.args.is_gpu:
  																					if not is_pyanvml_available():
  																											logger.warning(
  																											    """py3nvml not installed, we won't log GPU memory usage. """
  																											    """Install py3nvml (pip install py3nvml) to log information about GPU."""       )
  																											lowercase__							 =       """N/A"""
  																					else:
  																											logger.info(
  																											    """Measuring total GPU usage on GPU device. Make sure to not have additional processes running"""
  																											    """ on the same GPU."""       )
  																											# init nvml
  																											nvml.nvmlInit()
  																											func()
  																											lowercase__							 =       nvml.nvmlDeviceGetHandleByIndex(self.args.device_idx       )
  																											lowercase__							 =       nvml.nvmlDeviceGetMemoryInfo(lowerCamelCase__       )
  																											lowercase__							 =       meminfo.used
  																											lowercase__							 =       Memory(lowerCamelCase__       )
  																											# shutdown nvml
  																											nvml.nvmlShutdown()
  															else:
  																					# cpu
  																					lowercase__							 =       measure_peak_memory_cpu(lowerCamelCase__       )
  																					lowercase__							 =       Memory(lowerCamelCase__       ) if isinstance(lowerCamelCase__       ,     lowerCamelCase__       ) else memory_bytes
  
  															if self.args.trace_memory_line_by_line:
  																					lowercase__							 =       stop_memory_tracing(lowerCamelCase__       )
  															else:
  																					lowercase__							 =       None
  
  															return memory, summary
  									except RuntimeError as e:
  															self.print_fn(F'''Doesn\'t fit on GPU. {e}'''       )
  															return "N/A", None
  
  
  
  
  
  
  