
"""simple docstring"""




from sklearn.metrics import recall_score

import datasets


A__      :	Optional[int]          =    """
Recall is the fraction of the positive examples that were correctly labeled by the model as positive. It can be computed with the equation:
Recall = TP / (TP + FN)
Where TP is the true positives and FN is the false negatives.
"""


A__      :	Any          =    """
Args:
- **predictions** (`list` of `int`): The predicted labels.
- **references** (`list` of `int`): The ground truth labels.
- **labels** (`list` of `int`): The set of labels to include when `average` is not set to `binary`, and their order when average is `None`. Labels present in the data can be excluded in this input, for example to calculate a multiclass average ignoring a majority negative class, while labels not present in the data will result in 0 components in a macro average. For multilabel targets, labels are column indices. By default, all labels in y_true and y_pred are used in sorted order. Defaults to None.
- **pos_label** (`int`): The class label to use as the 'positive class' when calculating the recall. Defaults to `1`.
- **average** (`string`): This parameter is required for multiclass/multilabel targets. If None, the scores for each class are returned. Otherwise, this determines the type of averaging performed on the data. Defaults to `'binary'`.
    - `'binary'`: Only report results for the class specified by `pos_label`. This is applicable only if the target labels and predictions are binary.
    - `'micro'`: Calculate metrics globally by counting the total true positives, false negatives, and false positives.
    - `'macro'`: Calculate metrics for each label, and find their unweighted mean. This does not take label imbalance into account.
    - `'weighted'`: Calculate metrics for each label, and find their average weighted by support (the number of true instances for each label). This alters `'macro'` to account for label imbalance. Note that it can result in an F-score that is not between precision and recall.
    - `'samples'`: Calculate metrics for each instance, and find their average (only meaningful for multilabel classification).
- **sample_weight** (`list` of `float`): Sample weights Defaults to `None`.
- **zero_division** (): Sets the value to return when there is a zero division. Defaults to .
    - `'warn'`: If there is a zero division, the return value is `0`, but warnings are also raised.
    - `0`: If there is a zero division, the return value is `0`.
    - `1`: If there is a zero division, the return value is `1`.

Returns:
- **recall** (`float`, or `array` of `float`): Either the general recall score, or the recall scores for individual classes, depending on the values input to `labels` and `average`. Minimum possible value is 0. Maximum possible value is 1. A higher recall means that more of the positive examples have been labeled correctly. Therefore, a higher recall is generally considered better.

Examples:

    Example 1-A simple example with some errors
        >>> recall_metric = datasets.load_metric('recall')
        >>> results = recall_metric.compute(references=[0, 0, 1, 1, 1], predictions=[0, 1, 0, 1, 1])
        >>> print(results)
        {'recall': 0.6666666666666666}

    Example 2-The same example as Example 1, but with `pos_label=0` instead of the default `pos_label=1`.
        >>> recall_metric = datasets.load_metric('recall')
        >>> results = recall_metric.compute(references=[0, 0, 1, 1, 1], predictions=[0, 1, 0, 1, 1], pos_label=0)
        >>> print(results)
        {'recall': 0.5}

    Example 3-The same example as Example 1, but with `sample_weight` included.
        >>> recall_metric = datasets.load_metric('recall')
        >>> sample_weight = [0.9, 0.2, 0.9, 0.3, 0.8]
        >>> results = recall_metric.compute(references=[0, 0, 1, 1, 1], predictions=[0, 1, 0, 1, 1], sample_weight=sample_weight)
        >>> print(results)
        {'recall': 0.55}

    Example 4-A multiclass example, using different averages.
        >>> recall_metric = datasets.load_metric('recall')
        >>> predictions = [0, 2, 1, 0, 0, 1]
        >>> references = [0, 1, 2, 0, 1, 2]
        >>> results = recall_metric.compute(predictions=predictions, references=references, average='macro')
        >>> print(results)
        {'recall': 0.3333333333333333}
        >>> results = recall_metric.compute(predictions=predictions, references=references, average='micro')
        >>> print(results)
        {'recall': 0.3333333333333333}
        >>> results = recall_metric.compute(predictions=predictions, references=references, average='weighted')
        >>> print(results)
        {'recall': 0.3333333333333333}
        >>> results = recall_metric.compute(predictions=predictions, references=references, average=None)
        >>> print(results)
        {'recall': array([1., 0., 0.])}
"""


A__      :	str          =    """
@article{scikit-learn, title={Scikit-learn: Machine Learning in {P}ython}, author={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.}, journal={Journal of Machine Learning Research}, volume={12}, pages={2825--2830}, year={2011}
"""







@datasets.utils.file_utils.add_start_docstrings(_DESCRIPTION	,   _KWARGS_DESCRIPTION				)
class   _lowercase						(       datasets.Metric				):


     '''simple docstring'''





     def  lowerCAmelCase__       (      self  )->					List[str]:
          return datasets.MetricInfo(
              description=_DESCRIPTION ,			citation=_CITATION ,			inputs_description=_KWARGS_DESCRIPTION ,			features=datasets.Features(
                  {
                      "predictions": datasets.Sequence(datasets.Value("int32"  )  ),
                      "references": datasets.Sequence(datasets.Value("int32"  )  ),
                  }
                  if self.config_name == "multilabel"
                  else {
                      "predictions": datasets.Value("int32"  ),
                      "references": datasets.Value("int32"  ),
                  }  ) ,			reference_urls=["https://scikit-learn.org/stable/modules/generated/sklearn.metrics.recall_score.html"] ,			)



     def  lowerCAmelCase__       (      self ,			__UpperCamelCase ,			__UpperCamelCase ,			__UpperCamelCase=None ,			__UpperCamelCase=1 ,			__UpperCamelCase="binary" ,			__UpperCamelCase=None ,			__UpperCamelCase="warn" ,			)->					Union[str, Any]:
          UpperCAmelCase__							: Tuple 							=						recall_score(
              __UpperCamelCase ,			__UpperCamelCase ,			labels=__UpperCamelCase ,			pos_label=__UpperCamelCase ,			average=__UpperCamelCase ,			sample_weight=__UpperCamelCase ,			zero_division=__UpperCamelCase ,			)
          return {"recall": float(__UpperCamelCase  ) if score.size == 1 else score}





"""simple docstring"""




from typing import Dict, List, Optional, Union

import numpy as np

from transformers.utils import is_vision_available
from transformers.utils.generic import TensorType

from ...image_processing_utils import BaseImageProcessor, BatchFeature, get_size_dict
from ...image_transforms import (
    center_crop,
    get_resize_output_image_size,
    normalize,
    rescale,
    resize,
    to_channel_dimension_format,
)
from ...image_utils import (
    IMAGENET_STANDARD_MEAN,
    IMAGENET_STANDARD_STD,
    ChannelDimension,
    ImageInput,
    PILImageResampling,
    is_valid_image,
    to_numpy_array,
    valid_images,
)
from ...utils import logging


if is_vision_available():
    import PIL

A__      :	Dict          =    logging.get_logger(__name__)



def 							a__ (				lowerCAmelCase	:       Optional[Any]		):






     '''simple docstring'''
     if isinstance(lowerCAmelCase       ,    (list, tuple)		) and isinstance(videos[0]       ,    (list, tuple)		) and is_valid_image(videos[0][0]		):
          return videos

     elif isinstance(lowerCAmelCase       ,    (list, tuple)		) and is_valid_image(videos[0]		):
          return [videos]

     elif is_valid_image(lowerCAmelCase		):
          return [[videos]]

     raise ValueError(F"Could not make batched video from {videos}"		)







class   _lowercase						(       lowerCAmelCase_				):


     '''simple docstring'''





     _A								=							['pixel_values']



     def __init__(      self ,			__UpperCamelCase = True ,			__UpperCamelCase = None ,			__UpperCamelCase = PILImageResampling.BILINEAR ,			__UpperCamelCase = True ,			__UpperCamelCase = None ,			__UpperCamelCase = True ,			__UpperCamelCase = 1 / 2_55 ,			__UpperCamelCase = True ,			__UpperCamelCase = True ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			**__UpperCamelCase ,			)->					None:
          super().__init__(**__UpperCamelCase  )
          UpperCAmelCase__							: Optional[Any] 							=						size if size is not None else {"shortest_edge": 2_56}
          UpperCAmelCase__							: List[Any] 							=						get_size_dict(__UpperCamelCase ,			default_to_square=__UpperCamelCase  )
          UpperCAmelCase__							: List[str] 							=						crop_size if crop_size is not None else {"height": 2_24, "width": 2_24}
          UpperCAmelCase__							: int 							=						get_size_dict(__UpperCamelCase ,			param_name="crop_size"  )

          UpperCAmelCase__							: Dict 							=						do_resize
          UpperCAmelCase__							: Optional[int] 							=						size
          UpperCAmelCase__							: List[Any] 							=						do_center_crop
          UpperCAmelCase__							: str 							=						crop_size
          UpperCAmelCase__							: Optional[int] 							=						resample
          UpperCAmelCase__							: int 							=						do_rescale
          UpperCAmelCase__							: Union[str, Any] 							=						rescale_factor
          UpperCAmelCase__							: Union[str, Any] 							=						offset
          UpperCAmelCase__							: Dict 							=						do_normalize
          UpperCAmelCase__							: int 							=						image_mean if image_mean is not None else IMAGENET_STANDARD_MEAN
          UpperCAmelCase__							: Union[str, Any] 							=						image_std if image_std is not None else IMAGENET_STANDARD_STD



     def  lowerCAmelCase__       (      self ,			__UpperCamelCase ,			__UpperCamelCase ,			__UpperCamelCase = PILImageResampling.BILINEAR ,			__UpperCamelCase = None ,			**__UpperCamelCase ,			)->					np.ndarray:
          UpperCAmelCase__							: Optional[int] 							=						get_size_dict(__UpperCamelCase ,			default_to_square=__UpperCamelCase  )
          if "shortest_edge" in size:
               UpperCAmelCase__							: Union[str, Any] 							=						get_resize_output_image_size(__UpperCamelCase ,			size["shortest_edge"] ,			default_to_square=__UpperCamelCase  )
          elif "height" in size and "width" in size:
               UpperCAmelCase__							: Any 							=						(size["height"], size["width"])
          else:
               raise ValueError(F"Size must have 'height' and 'width' or 'shortest_edge' as keys. Got {size.keys()}"  )
          return resize(__UpperCamelCase ,			size=__UpperCamelCase ,			resample=__UpperCamelCase ,			data_format=__UpperCamelCase ,			**__UpperCamelCase  )



     def  lowerCAmelCase__       (      self ,			__UpperCamelCase ,			__UpperCamelCase ,			__UpperCamelCase = None ,			**__UpperCamelCase ,			)->					np.ndarray:
          UpperCAmelCase__							: Optional[Any] 							=						get_size_dict(__UpperCamelCase  )
          if "height" not in size or "width" not in size:
               raise ValueError(F"Size must have 'height' and 'width' as keys. Got {size.keys()}"  )
          return center_crop(__UpperCamelCase ,			size=(size["height"], size["width"]) ,			data_format=__UpperCamelCase ,			**__UpperCamelCase  )



     def  lowerCAmelCase__       (      self ,			__UpperCamelCase ,			__UpperCamelCase ,			__UpperCamelCase = True ,			__UpperCamelCase = None ,			**__UpperCamelCase ,			)->					Tuple:
          UpperCAmelCase__							: str 							=						image.astype(np.floataa  )
          if offset:
               UpperCAmelCase__							: Tuple 							=						image - (scale / 2)
          return rescale(__UpperCamelCase ,			scale=__UpperCamelCase ,			data_format=__UpperCamelCase ,			**__UpperCamelCase  )



     def  lowerCAmelCase__       (      self ,			__UpperCamelCase ,			__UpperCamelCase ,			__UpperCamelCase ,			__UpperCamelCase = None ,			**__UpperCamelCase ,			)->					np.ndarray:
          return normalize(__UpperCamelCase ,			mean=__UpperCamelCase ,			std=__UpperCamelCase ,			data_format=__UpperCamelCase ,			**__UpperCamelCase  )



     def  lowerCAmelCase__       (      self ,			__UpperCamelCase ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = ChannelDimension.FIRST ,			)->					np.ndarray:
          if do_resize and size is None or resample is None:
               raise ValueError("Size and resample must be specified if do_resize is True."  )

          if do_center_crop and crop_size is None:
               raise ValueError("Crop size must be specified if do_center_crop is True."  )

          if do_rescale and rescale_factor is None:
               raise ValueError("Rescale factor must be specified if do_rescale is True."  )

          if do_normalize and (image_mean is None or image_std is None):
               raise ValueError("Image mean and std must be specified if do_normalize is True."  )

          if offset and not do_rescale:
               raise ValueError("For offset, do_rescale must also be set to True."  )

          # All transformations expect numpy arrays.
          UpperCAmelCase__							: Optional[Any] 							=						to_numpy_array(__UpperCamelCase  )

          if do_resize:
               UpperCAmelCase__							: Union[str, Any] 							=						self.resize(image=__UpperCamelCase ,			size=__UpperCamelCase ,			resample=__UpperCamelCase  )

          if do_center_crop:
               UpperCAmelCase__							: int 							=						self.center_crop(__UpperCamelCase ,			size=__UpperCamelCase  )

          if do_rescale:
               UpperCAmelCase__							: List[str] 							=						self.rescale(image=__UpperCamelCase ,			scale=__UpperCamelCase ,			offset=__UpperCamelCase  )

          if do_normalize:
               UpperCAmelCase__							: List[Any] 							=						self.normalize(image=__UpperCamelCase ,			mean=__UpperCamelCase ,			std=__UpperCamelCase  )

          UpperCAmelCase__							: Dict 							=						to_channel_dimension_format(__UpperCamelCase ,			__UpperCamelCase  )
          return image



     def  lowerCAmelCase__       (      self ,			__UpperCamelCase ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = None ,			__UpperCamelCase = ChannelDimension.FIRST ,			**__UpperCamelCase ,			)->					PIL.Image.Image:
          UpperCAmelCase__							: Optional[int] 							=						do_resize if do_resize is not None else self.do_resize
          UpperCAmelCase__							: int 							=						resample if resample is not None else self.resample
          UpperCAmelCase__							: Tuple 							=						do_center_crop if do_center_crop is not None else self.do_center_crop
          UpperCAmelCase__							: int 							=						do_rescale if do_rescale is not None else self.do_rescale
          UpperCAmelCase__							: Any 							=						rescale_factor if rescale_factor is not None else self.rescale_factor
          UpperCAmelCase__							: Optional[int] 							=						offset if offset is not None else self.offset
          UpperCAmelCase__							: Dict 							=						do_normalize if do_normalize is not None else self.do_normalize
          UpperCAmelCase__							: Dict 							=						image_mean if image_mean is not None else self.image_mean
          UpperCAmelCase__							: Optional[int] 							=						image_std if image_std is not None else self.image_std

          UpperCAmelCase__							: List[str] 							=						size if size is not None else self.size
          UpperCAmelCase__							: Optional[int] 							=						get_size_dict(__UpperCamelCase ,			default_to_square=__UpperCamelCase  )
          UpperCAmelCase__							: Dict 							=						crop_size if crop_size is not None else self.crop_size
          UpperCAmelCase__							: Tuple 							=						get_size_dict(__UpperCamelCase ,			param_name="crop_size"  )

          if not valid_images(__UpperCamelCase  ):
               raise ValueError(
                   "Invalid image type. Must be of type PIL.Image.Image, numpy.ndarray, "
                   "torch.Tensor, tf.Tensor or jax.ndarray."  )

          UpperCAmelCase__							: List[str] 							=						make_batched(__UpperCamelCase  )

          UpperCAmelCase__							: Optional[Any] 							=						[
              [
                  self._preprocess_image(
                      image=__UpperCamelCase ,			do_resize=__UpperCamelCase ,			size=__UpperCamelCase ,			resample=__UpperCamelCase ,			do_center_crop=__UpperCamelCase ,			crop_size=__UpperCamelCase ,			do_rescale=__UpperCamelCase ,			rescale_factor=__UpperCamelCase ,			offset=__UpperCamelCase ,			do_normalize=__UpperCamelCase ,			image_mean=__UpperCamelCase ,			image_std=__UpperCamelCase ,			data_format=__UpperCamelCase ,			)
                  for img in video
              ]
              for video in videos
          ]

          UpperCAmelCase__							: Dict 							=						{"pixel_values": videos}
          return BatchFeature(data=__UpperCamelCase ,			tensor_type=__UpperCamelCase  )



