§
    ­¸jCL  ã                  ó”  — d Z ddlmZ ddlZddlZddlmZmZ ddlm	Z	 ddl
mZ ddlmZ  e¦   «         Zg d¢Z ed	d	¬
¦  «         G d„ d¦  «        ¦   «         Z ed	d	¬
¦  «         G d„ d¦  «        ¦   «         Zeez  ZdAd„ZdBd„ZdCd„ZdDd„ZdEd „ZdFd"„ZdGd%„ZdHd(„ZdId+„ZdJd.„ZdKd0„ZdLd3„ZdMd5„ZdNd7„Z d8d9œdOd=„Z!d8d9œdPd>„Z"dQd@„Z#dS )Rz4Private helpers for COCO keypoint schema extraction.é    )ÚannotationsN)Ú	dataclassÚfield)ÚPath)ÚAny)Ú
get_logger)ÚCocoKeypointSchemaÚKeypointSchemaÚYoloKeypointSchemaÚactive_keypoint_countsÚinfer_coco_keypoint_schemaÚinfer_yolo_keypoint_schemaT)ÚfrozenÚslotsc                  óT   — e Zd ZU dZded<   ded<   ded<    ee¬¦  «        Zded	<   d
S )r	   ax  Keypoint schema inferred from COCO category metadata.

    Args:
        class_names: Category names sorted by category id.
        num_keypoints_per_class: Number of keypoints for each sorted category.
        keypoint_oks_sigmas: Default OKS sigmas matching the largest keypoint class.
        keypoint_flip_pairs: Flat horizontal-flip swap pairs inferred from keypoint names.

    Returns:
        Immutable schema value used to configure keypoint training.

    Raises:
        This value object does not raise.

    Example:
        >>> CocoKeypointSchema(["person"], [17], [0.1] * 17).num_keypoints_per_class
        [17]
    ú	list[str]Úclass_namesú	list[int]Únum_keypoints_per_classúlist[float]Úkeypoint_oks_sigmas©Údefault_factoryÚkeypoint_flip_pairsN©Ú__name__Ú
__module__Ú__qualname__Ú__doc__Ú__annotations__r   Úlistr   © ó    úp/root/private/project/pallet_detection_v2/.venv/lib/python3.11/site-packages/rfdetr/datasets/_keypoint_schema.pyr	   r	      sa   € € € € € € ðð ð& ÐÐÑØ&Ð&Ð&Ñ&Ø$Ð$Ð$Ñ$Ø%* U¸4Ð%@Ñ%@Ô%@ÐÐ@Ð@Ð@Ñ@Ð@Ð@r#   r	   c                  ór   — e Zd ZU dZded<   ded<   ded<   ded<   ded	<   d
ed<    ee¬¦  «        Zded<   dS )r   a  Keypoint schema inferred from an Ultralytics YOLO pose YAML file.

    Args:
        class_names: Class names ordered by YOLO class id.
        num_keypoints_per_class: Number of keypoints for each YOLO class slot.
        keypoint_oks_sigmas: Default OKS sigmas matching the global keypoint count.
        keypoint_names: Keypoint names ordered by keypoint index.
        flip_idx: Optional Ultralytics horizontal-flip index mapping.
        keypoint_dim: Number of keypoint dimensions in label files, either 2 or 3.

    Returns:
        Immutable schema value used to configure YOLO pose training.

    Raises:
        This value object does not raise.

    Example:
        >>> YoloKeypointSchema(["person"], [1], [0.1], ["nose"], [], 3).keypoint_dim
        3
    r   r   r   r   r   r   Úkeypoint_namesÚflip_idxÚintÚkeypoint_dimr   r   Nr   r"   r#   r$   r   r   9   s…   € € € € € € ðð ð* ÐÐÑØ&Ð&Ð&Ñ&Ø$Ð$Ð$Ñ$ØÐÐÑØÐÐÑØÐÐÑØ%* U¸4Ð%@Ñ%@Ô%@ÐÐ@Ð@Ð@Ñ@Ð@Ð@r#   r   Ú	yaml_pathr   Úreturnúdict[str, Any]c                ó(  — ddl }|                      d¬¦  «        5 }|                     |¦  «        }ddd¦  «         n# 1 swxY w Y   t          |t          ¦  «        s5t          dt          | ¦  «        ›dt          |¦  «        j        › d�¦  «        ‚|S )a  Load a YAML file and require a mapping root.

    Args:
        yaml_path: Path to a YAML data file.

    Returns:
        Parsed YAML mapping.

    Raises:
        ValueError: If the YAML root is not a mapping.
        OSError: If the file cannot be read.

    Example:
        >>> import tempfile
        >>> path = Path(tempfile.mkdtemp()) / "data.yaml"
        >>> _ = path.write_text("names: [person]\nkpt_shape: [1, 3]\n", encoding="utf-8")
        >>> sorted(_load_yaml_mapping(path))
        ['kpt_shape', 'names']
    r   Núutf-8©ÚencodingzExpected mapping in data file ú, got ú.)	ÚyamlÚopenÚ	safe_loadÚ
isinstanceÚdictÚ
ValueErrorÚstrÚtyper   )r*   r3   ÚfileÚdatas       r$   Ú_load_yaml_mappingr=   ]   sÑ   € ð( €K€K€Kà	�Š ˆÑ	)Ô	)ð $¨TØ�~Š~˜dÑ#Ô#ˆð$ð $ð $ñ $ô $ð $ð $ð $ð $ð $ð $øøøð $ð $ð $ð $å�d�DÑ!Ô!ð jÝÐh½#¸i¹.¼.ÐhÐhÕRVÐW[ÑR\ÔR\ÔReÐhÐhÐhÑiÔiÐiØ€Ks   ›=½AÁAr<   Ú	data_filer   c                óæ  ‡— |                       d¦  «        Št          ‰t          ¦  «        rñg }g }‰                     ¦   «         D ]]}t	          |¦  «        }|                     ¦   «         r#|                     t          |¦  «        ¦  «         ŒH|                     |¦  «         Œ^t          t          |¦  «        ¦  «        }|r/|t          t          t          |¦  «        ¦  «        ¦  «        k    s|r t          dt	          |¦  «        ›d�¦  «        ‚ˆfd„|D ¦   «         S t          ‰t          ¦  «        rd„ ‰D ¦   «         S t          dt	          |¦  «        ›dt          ‰¦  «        j        › d�¦  «        ‚)	z:Extract contiguous YOLO class names from parsed YAML data.Únamesz)Unsupported 'names' mapping in data file z,: expected integer keys 0..N-1 with no gaps.c                ó:   •— g | ]}t          ‰|         ¦  «        ‘ŒS r"   ©r9   )Ú.0Úidxr@   s     €r$   ú
<listcomp>z7_extract_yolo_class_names_from_data.<locals>.<listcomp>�   s#   ø€ Ð>Ð>Ð> C•�E˜#”J‘”Ð>Ð>Ð>r#   c                ó,   — g | ]}t          |¦  «        ‘ŒS r"   rB   ©rC   Únames     r$   rE   z7_extract_yolo_class_names_from_data.<locals>.<listcomp>�   s   € Ð,Ð,Ð,˜d•�D‘	”	Ð,Ð,Ð,r#   z)Expected 'names' to be a list or dict in r1   r2   )Úgetr6   r7   Úkeysr9   ÚisdigitÚappendr(   ÚsortedÚsetr!   ÚrangeÚlenr8   r:   r   )r<   r>   Únumeric_keysÚnon_numeric_keysÚkeyÚkey_strÚunique_sorted_keysr@   s          @r$   Ú#_extract_yolo_class_names_from_datarV   z   sŒ  ø€ à�HŠH�WÑÔ€EÝ�%�ÑÔð ?Ø"$ˆØ&(ÐØ—:’:‘<”<ð 	-ð 	-ˆCÝ˜#‘h”hˆGØ�ŠÑ Ô ð -Ø×#Ò#¥C¨¡L¤LÑ1Ô1Ð1Ð1à ×'Ò'¨Ñ,Ô,Ð,Ð,å#¥C¨Ñ$5Ô$5Ñ6Ô6ÐØ!ð 	Ð%7½4ÅÅcÐJ\ÑF]ÔF]Ñ@^Ô@^Ñ;_Ô;_Ò%_Ð%_ÐcsÐ%_ÝðRÝ�y‘>”>ðRð Rð Rñô ð ð ?Ð>Ð>Ð>Ð+=Ð>Ñ>Ô>Ð>Ý�%�ÑÔð -Ø,Ð, eÐ,Ñ,Ô,Ð,Ý
ÐpÅÀYÁÄÐpÐpÕY]Ð^cÑYdÔYdÔYmÐpÐpÐpÑ
qÔ
qÐqr#   Úraw_kpt_shaper   útuple[int, int]c                óÔ  — t          | t          t          f¦  «        rt          | ¦  «        dk    r t	          dt          |¦  «        ›d�¦  «        ‚	 t          | d         ¦  «        }t          | d         ¦  «        }n=# t          t          f$ r)}t	          dt          |¦  «        ›d| ›d�¦  «        |‚d}~ww xY w|dk    s|d	vr#t	          dt          |¦  «        ›d| ›d
�¦  «        ‚||fS )z7Validate and normalize a YOLO pose ``kpt_shape`` entry.é   úYOLO pose data file z2 must define kpt_shape as [num_keypoints, 2_or_3].r   é   z has invalid kpt_shape=z; expected integer values.N)rZ   é   z,; expected [positive_num_keypoints, 2_or_3].)r6   r!   ÚtuplerP   r8   r9   r(   Ú	TypeError)rW   r>   Únum_keypointsr)   Úexcs        r$   Ú_validate_yolo_kpt_shaperb   “   s)  € å�m¥d­E ]Ñ3Ô3ð vµs¸=Ñ7IÔ7IÈQÒ7NÐ7NÝÐtµ°I±´ÐtÐtÐtÑuÔuÐuðÝ˜M¨!Ô,Ñ-Ô-ˆÝ˜=¨Ô+Ñ,Ô,ˆˆøÝ•zÐ"ð ð ð ÝØw¥3 y¡>¤>ÐwÐwÈMÐwÐwÐwñ
ô 
àð	øøøøðøøøð ˜ÒÐ˜\°Ð7Ð7Ýð9¥3 y¡>¤>ð 9ð 9ÈMð 9ð 9ð 9ñ
ô 
ð 	
ð ˜,Ð&Ð&s   Á*A< Á<B6Â$B1Â1B6r`   r(   c                óª  — |                       d¦  «        }d}t          |t          ¦  «        r,|r*|                      d|                      d¦  «        ¦  «        }nt          |t          ¦  «        r|}|€d„ t	          |¦  «        D ¦   «         S t          |t          ¦  «        rt          |¦  «        |k    rt          d|› d|›d�¦  «        ‚d	„ |D ¦   «         S )
z>Extract YOLO keypoint names or synthesize stable placeholders.Ú	kpt_namesNr   Ú0c                ó   — g | ]}d |› �‘ŒS )Ú	keypoint_r"   ©rC   rD   s     r$   rE   z0_extract_yolo_keypoint_names.<locals>.<listcomp>°   s!   € ÐBÐBÐB cÐ!˜CÐ!Ð!ÐBÐBÐBr#   z?YOLO pose kpt_names length must match kpt_shape keypoint count r1   r2   c                ó,   — g | ]}t          |¦  «        ‘ŒS r"   rB   rG   s     r$   rE   z0_extract_yolo_keypoint_names.<locals>.<listcomp>µ   s   € Ð1Ð1Ð1˜$�C�‰IŒIÐ1Ð1Ð1r#   )rI   r6   r7   r!   rO   rP   r8   )r<   r`   Úraw_kpt_namesr&   s       r$   Ú_extract_yolo_keypoint_namesrk   ¦   sò   € à—H’H˜[Ñ)Ô)€MØ€NÝ�-¥Ñ&Ô&ð '¨=ð 'Ø&×*Ò*¨1¨m×.?Ò.?ÀÑ.DÔ.DÑEÔEˆˆÝ	�M¥4Ñ	(Ô	(ð 'Ø&ˆàÐØBÐB­U°=Ñ-AÔ-AÐBÑBÔBÐBÝ�n¥dÑ+Ô+ð 
­s°>Ñ/BÔ/BÀmÒ/SÐ/SÝØvÈmÐvÐvÐcqÐvÐvÐvñ
ô 
ð 	
ð 2Ð1 .Ð1Ñ1Ô1Ð1r#   r   c                ó¢  — |                       d¦  «        }|€g S t          |t          ¦  «        rt          |¦  «        |k    rt	          d|› d�¦  «        ‚	 d„ |D ¦   «         }n)# t
          t          f$ r}t	          d¦  «        |‚d}~ww xY wt          |¦  «        t          t          |¦  «        ¦  «        k    rt	          d|dz
  › d	�¦  «        ‚|S )
z9Extract and validate optional YOLO ``flip_idx`` metadata.r'   Nz YOLO pose flip_idx must contain z integer indexes.c                ó,   — g | ]}t          |¦  «        ‘ŒS r"   ©r(   rh   s     r$   rE   z*_extract_yolo_flip_idx.<locals>.<listcomp>À   s   € Ð5Ð5Ð5 •C˜‘H”HÐ5Ð5Ð5r#   z0YOLO pose flip_idx must contain integer indexes.z/YOLO pose flip_idx must be a permutation of 0..r\   r2   )rI   r6   r!   rP   r8   r_   rM   rO   )r<   r`   Úraw_flip_idxr'   ra   s        r$   Ú_extract_yolo_flip_idxrp   ¸   sú   € à—8’8˜JÑ'Ô'€LØÐØˆ	Ý�l¥DÑ)Ô)ð ^­S°Ñ->Ô->À-Ò-OÐ-OÝÐ\¸MÐ\Ð\Ð\Ñ]Ô]Ð]ðVØ5Ð5¨Ð5Ñ5Ô5ˆˆøÝ•zÐ"ð Vð Vð VÝÐKÑLÔLÐRUÐUøøøøðVøøøåˆhÑÔ�4¥ mÑ 4Ô 4Ñ5Ô5Ò5Ð5ÝÐ_È=Ð[\ÑK\Ð_Ð_Ð_Ñ`Ô`Ð`Ø€Os   ÁA# Á#B	Á4BÂB	r'   c                óF  — g }t          ¦   «         }t          | ¦  «        D ]€\  }}||v s
||v s||k    r|                     |¦  «         Œ)d|cxk    rt          | ¦  «        k     r=n ŒF| |         |k    r.|                     ||g¦  «         |                     ||h¦  «         Œ�|S )aK  Convert a YOLO flip_idx permutation to flat swap pairs.

    Args:
        flip_idx: Full permutation where ``flip_idx[i]`` is the horizontal mirror of joint ``i``.

    Returns:
        Flat list ``[a0, b0, a1, b1, ...]`` of left/right joint index pairs.

    Example:
        >>> _flip_idx_to_pairs([0, 2, 1])
        [1, 2]
    r   )rN   Ú	enumerateÚaddrP   ÚextendÚupdate)r'   ÚpairsÚseenrD   Ú
mirror_idxs        r$   Ú_flip_idx_to_pairsry   È   sÇ   € ð €EÝ‘U”U€DÝ$ XÑ.Ô.ð +ð +‰ˆˆZØ�$ˆ;ˆ;˜*¨Ð,Ð,°°zÒ0AÐ0AØ�HŠH�S‰MŒMˆMØØ�
Ð*Ð*Ò*Ð*�S ™]œ]Ò*Ð*Ð*Ð*Ð*¨x¸
Ô/CÀsÒ/JÐ/JØ�LŠL˜#˜zÐ*Ñ+Ô+Ð+Ø�KŠK˜˜jÐ)Ñ*Ô*Ð*øØ€Lr#   rH   r9   c                ó¶   — t          j        ddt          | ¦  «                             ¦   «                              ¦   «         ¦  «                             d¦  «        S )z0Normalize a keypoint name for symmetry matching.z
[^a-z0-9]+Ú_)ÚreÚsubr9   ÚstripÚlower)rH   s    r$   Ú_normalize_keypoint_namer€   á   s@   € åŒ6�- ¥c¨$¡i¤i§o¢oÑ&7Ô&7×&=Ò&=Ñ&?Ô&?Ñ@Ô@×FÒFÀsÑKÔKÐKr#   Únormalized_nameú
str | Nonec                óØ   — |                       d¦  «        }|                     d¦  «        }|                     d¦  «        }||z   dk    rdS d„ |D ¦   «         }d                     |¦  «        S )zAReturn the left/right counterpart for a normalized keypoint name.r{   ÚleftÚrightr\   Nc                ó2   — g | ]}|d k    rdn	|dk    rd n|‘ŒS )r„   r…   r"   )rC   Útokens     r$   rE   z)_mirror_keypoint_name.<locals>.<listcomp>î   s4   € ÐoÐoÐoÐ_d ¨¢ �W�W¸uÈÒ?OÐ?O°V°VÐUZÐoÐoÐor#   )ÚsplitÚcountÚjoin)r�   ÚtokensÚ
left_countÚright_countÚmirror_tokenss        r$   Ú_mirror_keypoint_namer�   æ   sr   € à×"Ò" 3Ñ'Ô'€FØ—’˜fÑ%Ô%€JØ—,’,˜wÑ'Ô'€KØ�KÑ 1Ò$Ð$ØˆtàoÐoÐhnÐoÑoÔo€MØ�8Š8�MÑ"Ô"Ð"r#   r&   ú	list[Any]c                ód  — d„ | D ¦   «         }t          t          |¦  «        ¦  «        t          |¦  «        k    rg S d„ t          |¦  «        D ¦   «         }g }t          ¦   «         }t          |¦  «        D ]†\  }}||v rŒ
t          |¦  «        }|€Œ|                     |¦  «        }|�
||k    s||v rŒ>t          ||         ¦  «        |k    rŒX|                     ||g¦  «         |                     ||h¦  «         Œ‡|s3| r1t                               dt          | ¦  «        | dd…         ¦  «         |S )z@Infer horizontal-flip swap pairs from left/right keypoint names.c                ó,   — g | ]}t          |¦  «        ‘ŒS r"   )r€   rG   s     r$   rE   z9_infer_keypoint_flip_pairs_from_names.<locals>.<listcomp>ô   s!   € ÐRÐRÐR¸4Õ0°Ñ6Ô6ÐRÐRÐRr#   c                ó   — i | ]\  }}||“Œ	S r"   r"   )rC   rD   rH   s      r$   ú
<dictcomp>z9_infer_keypoint_flip_pairs_from_names.<locals>.<dictcomp>ø   s   € ÐLÐLÐL¡9 3¨�T˜3ÐLÐLÐLr#   NzÊInferred 0 flip pairs from %d keypoint names %s. Automatic horizontal-flip slot swapping is disabled for this category. Provide keypoint_flip_pairs explicitly if your keypoints have left/right symmetry.é   )	rP   rN   rr   r�   rI   rt   ru   ÚloggerÚinfo)	r&   Únormalized_namesÚindex_by_namerv   rw   rD   r�   Úmirror_namerx   s	            r$   Ú%_infer_keypoint_flip_pairs_from_namesr›   ò   sq  € àRÐRÀ>ÐRÑRÔRÐÝ
�3ÐÑ Ô Ñ!Ô!¥SÐ)9Ñ%:Ô%:Ò:Ð:Øˆ	àLÐLµ	Ð:JÑ0KÔ0KÐLÑLÔL€MØ€EÝ‘U”U€DÝ )Ð*:Ñ ;Ô ;ð 'ð 'Ñˆˆ_Ø�$ˆ;ˆ;ØÝ+¨OÑ<Ô<ˆØÐØØ"×&Ò& {Ñ3Ô3ˆ
ØÐ ¨sÒ!2Ð!2°jÀDÐ6HÐ6HØÝ Ð!1°*Ô!=Ñ>Ô>À/ÒQÐQØØ�Š�c˜:Ð&Ñ'Ô'Ð'Ø�Š�S˜*Ð%Ñ&Ô&Ð&Ð&Øð 
�^ð 
Ý�Šðaõ �ÑÔØ˜2˜A˜2Ôñ	
ô 	
ð 	
ð €Lr#   Úcategory_pairsúlist[list[int]]c                óÔ   ‡— | sg S t          | ¦  «        dk    rt          | d         ¦  «        S | d         Št          ˆfd„| dd…         D ¦   «         ¦  «        rt          ‰¦  «        S g S )zDReturn one global flip-pair list when all keypoint categories agree.r\   r   c              3  ó$   •K  — | ]
}|‰k    V — Œd S )Nr"   )rC   rv   Úfirsts     €r$   ú	<genexpr>z6_merge_category_keypoint_flip_pairs.<locals>.<genexpr>  s'   øè è € Ð
:Ð
:˜eˆ5�EŠ>Ð
:Ð
:Ð
:Ð
:Ð
:Ð
:r#   N)rP   r!   Úall)rœ   r    s    @r$   Ú#_merge_category_keypoint_flip_pairsr£     s   ø€ àð Øˆ	Ý
ˆ>ÑÔ˜aÒÐÝ�N 1Ô%Ñ&Ô&Ð&à˜1Ô€EÝ
Ð
:Ð
:Ð
:Ð
: ~°a°b°bÔ'9Ð
:Ñ
:Ô
:Ñ:Ô:ð Ý�E‰{Œ{ÐØ€Ir#   Úannotation_pathc                óþ   — |                       d¬¦  «        5 }t          j        |¦  «        }ddd¦  «         n# 1 swxY w Y   t          |t          ¦  «        s%t          dt          |¦  «        j        › d�¦  «        ‚|S )aJ  Load a COCO annotation JSON file.

    Args:
        annotation_path: Path to a COCO annotation JSON file.

    Returns:
        Parsed COCO annotation mapping.

    Raises:
        ValueError: If the JSON root is not an object.
        OSError: If the file cannot be read.

    Example:
        >>> import tempfile
        >>> path = Path(tempfile.mkdtemp()) / "annotations.json"
        >>> _ = path.write_text('{"images": [], "annotations": [], "categories": []}', encoding="utf-8")
        >>> sorted(_load_coco_annotation(path))
        ['annotations', 'categories', 'images']
    r.   r/   Nz3Expected COCO annotation root to be an object, got r2   )r4   ÚjsonÚloadr6   r7   r8   r:   r   )r¤   r;   r<   s      r$   Ú_load_coco_annotationr¨      s¶   € ð( 
×	Ò	 wÐ	Ñ	/Ô	/ð °4ÝŒy˜‰Œˆðð ð ñ ô ð ð ð ð ð ð øøøð ð ð ð å�d�DÑ!Ô!ð gÝÐeÍtÐTXÉzÌzÔObÐeÐeÐeÑfÔfÐfØ€Ks   —8¸<¿<Ú
categoriesúlist[dict[str, Any]]c                ó~  — t          | t          ¦  «        r| st          d¦  «        ‚g }| D ]�}t          |t          ¦  «        s%t          dt	          |¦  «        j        › d�¦  «        ‚d|vrt          d¦  «        ‚d|vrt          d|d         ›d�¦  «        ‚|                     |¦  «         Œ‚t          |d	„ ¬
¦  «        S )a¬  Validate and sort COCO categories by category id.

    Args:
        categories: Raw ``categories`` value from a COCO annotation file.

    Returns:
        Category dictionaries sorted by ``id``.

    Raises:
        ValueError: If categories are missing or malformed.

    Example:
        >>> _validate_categories([{"id": 2, "name": "b"}, {"id": 1, "name": "a"}])
        [{'id': 1, 'name': 'a'}, {'id': 2, 'name': 'b'}]
    zCExpected COCO annotations to contain a non-empty 'categories' list.z1Expected each COCO category to be an object, got r2   Úidz5Expected each COCO category to contain an 'id' field.rH   zExpected COCO category_id z to contain a 'name' field.c                ó,   — t          | d         ¦  «        S )Nr¬   rn   )Úitems    r$   ú<lambda>z&_validate_categories.<locals>.<lambda>W  s   € ­c°$°t´*©o¬o€ r#   )rS   )r6   r!   r8   r7   r:   r   rL   rM   )r©   Ú	validatedÚcategorys      r$   Ú_validate_categoriesr²   ;  sí   € õ  �j¥$Ñ'Ô'ð `¨zð `ÝÐ^Ñ_Ô_Ð_à&(€IØð #ð #ˆÝ˜(¥DÑ)Ô)ð 	mÝÐkÕQUÐV^ÑQ_ÔQ_ÔQhÐkÐkÐkÑlÔlÐlØ�xÐÐÝÐTÑUÔUÐUØ˜Ð!Ð!ÝÐg¸(À4¼.ÐgÐgÐgÑhÔhÐhØ×Ò˜Ñ"Ô"Ð"Ð"Ý�)Ð!=Ð!=Ð>Ñ>Ô>Ð>r#   r   c                óÌ   — t          | t          ¦  «        st          d¦  «        ‚| D ]<}t          |t          ¦  «        s%t          dt	          |¦  «        j        › d�¦  «        ‚Œ=| S )ag  Validate COCO annotations container type.

    Args:
        annotations: Raw ``annotations`` value from a COCO annotation file.

    Returns:
        COCO annotation dictionaries.

    Raises:
        ValueError: If annotations are not a list of objects.

    Example:
        >>> _validate_annotations([{"category_id": 1}])
        [{'category_id': 1}]
    z;Expected COCO annotations to contain an 'annotations' list.z3Expected each COCO annotation to be an object, got r2   )r6   r!   r8   r7   r:   r   )r   Ú
annotations     r$   Ú_validate_annotationsrµ   Z  s}   € õ  �k¥4Ñ(Ô(ð XÝÐVÑWÔWÐWØ!ð qð qˆ
Ý˜*¥dÑ+Ô+ð 	qÝÐoÕSWÐXbÑScÔScÔSlÐoÐoÐoÑpÔpÐpð	qàÐr#   Úcategory_idc           	     ó~  — d}| D ]·}t          |                     dd¦  «        ¦  «        |k    rŒ*|                     d¦  «        }|�|g k    rŒHt          |t          ¦  «        sŒ^t	          |¦  «        dz  dk    r#t          d|›dt	          |¦  «        › d	�¦  «        ‚t          |t	          |¦  «        dz  ¦  «        }Œ¸|S )
a  Infer keypoint count for one category from annotation vectors.

    Args:
        annotations: COCO annotation dictionaries.
        category_id: Category id whose annotations should be inspected.

    Returns:
        Maximum keypoint vector length found for the category.

    Raises:
        ValueError: If keypoint annotation length is not divisible by three.

    Example:
        >>> anns = [{"category_id": 1, "keypoints": [1, 2, 2, 3, 4, 2]}]
        >>> _keypoint_count_from_annotations(anns, 1)
        2
    r   r¶   éÿÿÿÿÚ	keypointsNr]   z COCO annotation for category_id z has zL keypoint values; expected a flat [x, y, v] list with length divisible by 3.)r(   rI   r6   r!   rP   r8   Úmax)r   r¶   Úkeypoint_countr´   Úraw_keypointss        r$   Ú _keypoint_count_from_annotationsr½   r  s÷   € ð$ €NØ!ð Fð Fˆ
Ýˆz�~Š~˜m¨RÑ0Ô0Ñ1Ô1°[Ò@Ð@ØØ"Ÿš {Ñ3Ô3ˆØÐ  M°RÒ$7Ð$7ØÝ˜-­Ñ.Ô.ð 	ØÝˆ}ÑÔ Ñ! QÒ&Ð&ÝðM°;ð Mð MÅsÈ=ÑGYÔGYð Mð Mð Mñô ð õ ˜^­S°Ñ-?Ô-?À1Ñ-DÑEÔEˆˆØÐr#   gš™™™™™¹?)Úkeypoint_oks_sigmaú
str | Pathr¾   Úfloatc               ób  — t          | ¦  «        }t          |¦  «        }t          |d         ¦  «        }t          |                     dg ¦  «        ¦  «        }g }g }g }|D ]ð}	t          |	d         ¦  «        }
|                     t          |	d         ¦  «        ¦  «         |	                     d¦  «        }t          |t          ¦  «        rG|rE|                     t          |¦  «        ¦  «         |                     t          |¦  «        ¦  «         Œ°t          ||
¦  «        }|                     |¦  «         |dk    r|                     g ¦  «         Œñt          d„ |D ¦   «         ¦  «        st          d|› d	�¦  «        ‚t          |d¬
¦  «        }t!          |||g|z  t#          |¦  «        ¬¦  «        S )aZ  Infer a keypoint schema from a COCO annotation JSON file.

    Args:
        annotation_path: Path to a COCO annotation JSON file.
        keypoint_oks_sigma: Default OKS sigma to repeat for the largest keypoint class.

    Returns:
        Category-aligned class names, ``num_keypoints_per_class``, and OKS sigmas.

    Raises:
        FileNotFoundError: If the annotation file does not exist.
        ValueError: If the annotation file has no categories, no keypoint metadata,
            malformed COCO fields, or malformed keypoint vectors.
        KeyError: If required COCO keys are missing.
    r©   r   r¬   rH   r¹   r   c              3  ó"   K  — | ]
}|d k    V — ŒdS )r   Nr"   ©rC   r‰   s     r$   r¡   z-infer_coco_keypoint_schema.<locals>.<genexpr>¿  s&   è è € Ð>Ð>˜Uˆu�qŠyÐ>Ð>Ð>Ð>Ð>Ð>r#   zCOCO annotation file 'za' has no keypoint metadata. Expected category 'keypoints' entries or annotation keypoint vectors.)Údefault)r   r   r   r   )r   r¨   r²   rµ   rI   r(   rL   r9   r6   r!   rP   r›   r½   Úanyr8   rº   r	   r£   )r¤   r¾   Úpathr<   r©   r   r   r   Úcategory_flip_pairsr±   r¶   Úcategory_keypointsÚinferred_countÚmax_keypointss                 r$   r   r   –  sà  € õ( �Ñ Ô €DÝ  Ñ&Ô&€DÝ% d¨<Ô&8Ñ9Ô9€JÝ'¨¯ª°ÀÑ(CÔ(CÑDÔD€Kà€KØ)+ÐØ+-ÐØð /ð /ˆÝ˜( 4œ.Ñ)Ô)ˆØ×Ò�3˜x¨Ô/Ñ0Ô0Ñ1Ô1Ð1Ø%Ÿ\š\¨+Ñ6Ô6ÐÝÐ(­$Ñ/Ô/ð 	/Ð4Fð 	/Ø#×*Ò*­3Ð/AÑ+BÔ+BÑCÔCÐCØ×&Ò&Õ'LÐM_Ñ'`Ô'`ÑaÔaÐaÐaå=¸kÈ;ÑWÔWˆNØ#×*Ò*¨>Ñ:Ô:Ð:Ø Ò!Ð!Ø#×*Ò*¨2Ñ.Ô.Ð.øåÐ>Ð>Ð&=Ð>Ñ>Ô>Ñ>Ô>ð 
ÝðT Tð Tð Tð Tñ
ô 
ð 	
õ
 Ð/¸Ð;Ñ;Ô;€MÝØØ 7Ø/Ð0°=Ñ@Ý?Ð@SÑTÔTð	ñ ô ð r#   c               óˆ  — t          | ¦  «        }t          |¦  «        }t          ||¦  «        }d|vr t          dt	          |¦  «        ›d�¦  «        ‚t          |d         |¦  «        \  }}t          ||¦  «        }t          ||¦  «        }t          ||gt          |¦  «        z  |g|z  |||t          |¦  «        ¬¦  «        S )aø  Infer a keypoint schema from an Ultralytics YOLO pose YAML file.

    Args:
        data_file: Path to a YOLO ``data.yaml`` or ``data.yml`` file.
        keypoint_oks_sigma: Default OKS sigma to repeat for the global keypoint count.

    Returns:
        Class-aligned keypoint counts plus optional YOLO keypoint names and flip indexes.

    Raises:
        FileNotFoundError: If the YAML file does not exist.
        ValueError: If required YOLO pose fields are missing or malformed.

    Example:
        >>> import tempfile
        >>> path = Path(tempfile.mkdtemp()) / "data.yaml"
        >>> _ = path.write_text("names: [person]\nkpt_shape: [1, 3]\n", encoding="utf-8")
        >>> infer_yolo_keypoint_schema(path).num_keypoints_per_class
        [1]
    Ú	kpt_shaper[   z( is missing required kpt_shape metadata.)r   r   r   r&   r'   r)   r   )r   r=   rV   r8   r9   rb   rk   rp   r   rP   ry   )	r>   r¾   rÆ   r<   r   r`   r)   r&   r'   s	            r$   r   r   Î  sØ   € õ2 �	‰?Œ?€DÝ˜dÑ#Ô#€DÝ5°d¸DÑAÔA€KØ˜$ÐÐÝÐeµ°D±	´	ÐeÐeÐeÑfÔfÐfÝ":¸4ÀÔ;LÈdÑ"SÔ"SÑ€M�<Ý1°$¸ÑFÔF€NÝ% d¨MÑ:Ô:€HÝØØ!. µ#°kÑ2BÔ2BÑ BØ/Ð0°=Ñ@Ø%ØØ!Ý.¨xÑ8Ô8ðñ ô ð r#   r   c                ó   — d„ | D ¦   «         S )a<  Return non-zero keypoint counts from a model schema.

    Args:
        num_keypoints_per_class: Model keypoint schema.

    Returns:
        Positive keypoint counts in schema order.

    Raises:
        This helper does not raise.

    Example:
        >>> active_keypoint_counts([0, 17, 25])
        [17, 25]
    c                ó   — g | ]
}|d k    ¯|‘ŒS )r   r"   rÃ   s     r$   rE   z*active_keypoint_counts.<locals>.<listcomp>
  s   € ÐDÐDÐD�e¸%À!º)¸)ˆE¸)¸)¸)r#   r"   )r   s    r$   r   r   ú  s   € ð  EÐDÐ6ÐDÑDÔDÐDr#   )r*   r   r+   r,   )r<   r,   r>   r   r+   r   )rW   r   r>   r   r+   rX   )r<   r,   r`   r(   r+   r   )r<   r,   r`   r(   r+   r   )r'   r   r+   r   )rH   r   r+   r9   )r�   r9   r+   r‚   )r&   r�   r+   r   )rœ   r�   r+   r   )r¤   r   r+   r,   )r©   r   r+   rª   )r   r   r+   rª   )r   rª   r¶   r(   r+   r(   )r¤   r¿   r¾   rÀ   r+   r	   )r>   r¿   r¾   rÀ   r+   r   )r   r   r+   r   )$r   Ú
__future__r   r¦   r|   Údataclassesr   r   Úpathlibr   Útypingr   Úrfdetr.utilities.loggerr   r–   Ú__all__r	   r   r
   r=   rV   rb   rk   rp   ry   r€   r�   r›   r£   r¨   r²   rµ   r½   r   r   r   r"   r#   r$   ú<module>rÕ      sÏ  ðð ;Ð :à "Ð "Ð "Ð "Ð "Ð "à €€€Ø 	€	€	€	Ø (Ð (Ð (Ð (Ð (Ð (Ð (Ð (Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð à .Ð .Ð .Ð .Ð .Ð .à	ˆ‰Œ€ðð ð €ð €�$˜dÐ#Ñ#Ô#ðAð Að Að Að Añ Aô Añ $Ô#ðAð4 €�$˜dÐ#Ñ#Ô#ðAð Að Að Að Añ Aô Añ $Ô#ðAð@ $Ð&8Ñ8€ðð ð ð ð:rð rð rð rð2'ð 'ð 'ð 'ð&2ð 2ð 2ð 2ð$ð ð ð ð ð ð ð ð2Lð Lð Lð Lð
	#ð 	#ð 	#ð 	#ðð ð ð ðB
ð 
ð 
ð 
ðð ð ð ð6?ð ?ð ?ð ?ð>ð ð ð ð0!ð !ð !ð !ðN !$ð5ð 5ð 5ð 5ð 5ð 5ðv !$ð)ð )ð )ð )ð )ð )ðXEð Eð Eð Eð Eð Er#   