^j3dZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl Zdd Zdd ZGd d ZeGd dZGddZy)aModule for managing and transforming label data during augmentation. This module provides utilities for encoding, decoding, and tracking metadata for labels during the augmentation process. It includes classes for managing label transformations, preserving data types, and ensuring consistent handling of categorical, numerical, and mixed label types. The module supports automatic encoding of string labels to numerical values and restoration of original data types after processing. ) annotations) defaultdict)Sequence) dataclass)Real)AnyNcDt|trd|fSdt|fS)a^Sort items by type then value for consistent label ordering. This function is used to sort labels in a consistent order, prioritizing numerical values before string values. All numerical values are given priority 0, while string values are given priority 1, ensuring numerical values are sorted first. Args: item (Any): Item to be sorted, can be either a numeric value or any other type. Returns: tuple[int, Real | str]: A tuple with sort priority (0 for numbers, 1 for others) and the value itself (or string representation for non-numeric values). r) isinstancerstr)items l/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/albumentations/core/label_manager.py custom_sortrs$#4.At9BQD NBcfg}g}|D]%}t|tr|n|j|'||fSN)r rappend)labelsnumeric_labels string_labelslabels r_categorize_labelsr'sA!#N!MU%eT2 MMeTU = ((rc@eZdZdZd dZd dZd dZd dZd dZd dZ y) LabelEncoderaEncodes labels into integer indices. This class handles the conversion between original label values and their numerical representations. It supports both numerical and categorical labels. Args: classes_ (dict[str | Real, int]): Mapping from original labels to encoded indices. inverse_classes_ (dict[int, str | Real]): Mapping from encoded indices to original labels. num_classes (int): Number of unique classes. is_numerical (bool): Whether the original labels are numerical. c<i|_i|_d|_d|_y)NrT)classes_inverse_classes_ num_classes is_numericalselfs r__init__zLabelEncoder.__init__>s!/1 79 !"&rct|tjr|jj }|s d|_|St d|D|_|j r|Stt|t}|D]X}||jvs|j|j|<||j|j<|xjdz c_ Z|S)zFit the encoder to the input labels. Args: y (Sequence[Any] | np.ndarray): Input labels to fit the encoder. Returns: LabelEncoder: The fitted encoder instance. Fc3<K|]}t|tywr)r r.0rs r z#LabelEncoder.fit..VsGE 5$ 7Gskeyr ) r npndarrayflattentolistrallsortedsetrrrr)r!y unique_labelsrs rfitzLabelEncoder.fitDs a $ ""$A %D KGQGG   Ks1v;7 " &EDMM)'+'7'7 e$:?%%d&6&67  A%  &  rct|tjr|jj }|j rtj |Stj |Dcgc]}|j|c}Scc}w)zTransform labels to encoded integer indices. Args: y (Sequence[Any] | np.ndarray): Input labels to transform. Returns: np.ndarray: Encoded integer indices. )r r*r+r,r-rarrayrr!r1rs r transformzLabelEncoder.transformcsc a $ ""$A   88A; xx1=%u-=>>=-B cF|j||j|S)zFit the encoder and transform the input labels in one step. Args: y (Sequence[Any] | np.ndarray): Input labels to fit and transform. Returns: np.ndarray: Encoded integer indices. )r3r7)r!r1s r fit_transformzLabelEncoder.fit_transformus  ~~a  rct|tjr|jj }|j rtj |Stj |Dcgc]}|j|c}Scc}w)zTransform encoded indices back to original labels. Args: y (Sequence[Any] | np.ndarray): Encoded integer indices. Returns: np.ndarray: Original labels. )r r*r+r,r-rr5rr6s rinverse_transformzLabelEncoder.inverse_transformse a $ ""$A   88A; xx1E%..u5EFFEr8cF|jr|St|tjr|j j }n3t|t rt|ts t|}n||S|g}t|jj}t||z }|s|St|\}}t|t|tz}|D]A}|j} | |j|<||j| <|xjdz c_C|S)aUpdate the encoder with new labels encountered after initial fitting. This method identifies labels in the input sequence that are not already known to the encoder and adds them to the internal mapping. It does not change the encoding of previously seen labels. Args: y (Sequence[Any] | np.ndarray): A sequence or array of potentially new labels. Returns: LabelEncoder: The updated encoder instance. r(r )rr r*r+r,r-rr listr0rkeysrr/rr) r!r1 input_labelscurrent_labels_setnew_unique_labelsrrsorted_new_labelsrnew_ids rupdatezLabelEncoder.updates   K a $99;--/L 8 $Z3-?7L YK3L!!3!3!56 -0BB K);;L(M% ">2VMs5SS& "E%%F#)DMM% ,1D ! !& )    !   "  rNreturnNone)r1Sequence[Any] | np.ndarrayrGr)r1rIrG np.ndarray) __name__ __module__ __qualname____doc__r"r3r7r:r<rErrrr0s& ' >?$ !G$0rrcBeZdZUdZded<ded<dZded<dZd ed <y) LabelMetadataz$Stores metadata about a label field.type input_typeboolrNznp.dtype | NonedtypeLabelEncoder | Noneencoder)rKrLrMrN__annotations__rUrWrOrrrQrQs&.!E?!#'G 'rrQcXeZdZdZd dZd dZddZddZddZddZ ddZ dd Z dd Z y ) LabelManageraManages label encoding and decoding across multiple data fields. This class handles the encoding, decoding, and type management for label fields. It maintains metadata about each field to ensure proper conversion between original and encoded representations. Args: metadata (dict[str, dict[str, LabelMetadata]]): Dictionary mapping data types and label fields to their metadata. c,tt|_yr)rdictmetadatar s rr"zLabelManager.__init__s=H=N rc6||jvrW||j|vrF|j||}|jsK|jr?|jj|n#|j |}||j||<|j ||S)aProcess a label field, store metadata, and encode. If the field has been processed before (metadata exists), this will update the existing LabelEncoder with any new labels found in `field_data` before encoding. Otherwise, it analyzes the input, creates metadata, and fits the encoder. Args: data_name (str): The name of the main data type (e.g., 'bboxes', 'keypoints'). label_field (str): The specific label field being processed (e.g., 'class_labels'). field_data (Any): The actual label data for this field. Returns: np.ndarray: The encoded label data as a numpy array. )r]rrWrE_analyze_input _encode_data)r! data_name label_field field_datar]s r process_fieldzLabelManager.process_fields  %+y9Q*Q}}Y/ |j dkDr/tj |jtj}nPt|tr%t|ts|rtd|D}nt|ttfrd}nd}t|||}|st|_|S)z'Analyze input data and create metadata.Nrc3HK|]}t|ttfywr)r intfloatr%s rr'z.LabelManager._analyze_input.. sW5z%#u>Ws "TF)rSrrU)rRr r*r+rUsize issubdtypenumberrr r.rmrnrQrrW)r!rcrSrUrr]s rr_zLabelManager._analyze_inputs*% $.z2::$F   D j"** -*//A2E==)9)9299EL  H -jS6QV`WJWWL  S%L 1L!L !%  +~H rc|jr~t|tjr/|j ddj tj Stj|tj j ddS|j td|jj|j ddS)z!Encode field data for processing.r )rUz.Encoder not initialized for non-numerical data) rr r*r+reshapeastypefloat32r5rW ValueErrorr:)r!rcr]s rr`zLabelManager._encode_datas  *bjj1!))"a077 CC88Jbjj9AA"aH H    #MN N--j9AA"aHHrc4|jr7|j|j|jS|jS|j t d|jj |jt}|jdS)zDecode processed data.z(Encoder not found for non-numerical datars) rrUrur,rWrwr<rmrt)r!rhr]decodeds rrfzLabelManager._decode_data,s  ~~)#**8>>::'') )    #GH H""44\5H5H5MNr""rct|jtr0t|jtt fr|j St|jtrMt|jtjr)|j|j|jS|S|j S)z"Restore data to its original type.) r rSrR issubclassr>rr-r*r+rUru)r!rir]s rrgzLabelManager._restore_type9s h))4 0Z@S@SVZ\dUe5f&&( ( h))4 0Z@S@SUWU_U_5`~~)#**8>>:: ""$$rcgS)zHandle empty data case.rOr s rhandle_empty_datazLabelManager.handle_empty_dataHs rc||jvr?||j|vr.|j||j}t|tr|Sy)zFRetrieves the fitted LabelEncoder for a specific data and label field.N)r]rWr r)r!rarbrWs r get_encoderzLabelManager.get_encoderLsI  %+y9Q*QmmI.{;CCG'<0rNrF)rar rbr rcrrGrJ)rar rbr rhrJrGr)rcrrGrQ)rcrr]rQrGrJ)rhrJr]rQrGrJ)rirJr]rQrGr)rGz list[Any])rar rbr rGrV) rKrLrMrNr"rdrjr_r`rfrgr}rrOrrrZrZs6 O7:: 6 I # %rrZ)r rrGztuple[int, Real | str])rzset[Any]rGztuple[list[Real], list[str]])rN __future__r collectionsrcollections.abcr dataclassesrnumbersrtypingrnumpyr*rrrrQrZrOrrrs^##$!C$)TTn (( (BBr