§
    ß©ºj¡  ã                  ó  — U 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	m
Z
mZ ddlmZmZmZmZmZmZ ddlmZmZmZmZmZmZmZmZmZmZmZmZm Z  ddl!m"Z" dd	l#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>m?Z?m@Z@mAZAmBZBmCZC dd
l#mDZE ddl#mFZG ddl#mHZI ddlJmKZKmLZLmMZMmNZNmOZO ddlPmQZQmRZRmSZSmTZTmUZU ddlVmWZWmXZXmYZYmZZZm[Z[m\Z\m]Z]m^Z^m_Z_m`Z`maZambZbmcZcmdZdmeZe g d¢Zf e	dd¬¦  «         G d„ d¦  «        ¦   «         Zg e	dd¬¦  «         G d„ d¦  «        ¦   «         Zh e	dd¬¦  «         G d„ d¦  «        ¦   «         Zi e	dd¬¦  «         G d„ d¦  «        ¦   «         Zjegehz  eiz  ejz  Zkeelef         elz  ejm        el         z  ez  Zndeod<   dCd!„Zpegd"ehd"eid"ejd#iZqd$eod%<    G d&„ d'¦  «        Zr er¦   «         Zsd(eod)<   dDd-„Ztd.Zud/eod0<   dEd6„ZvdFd9„Zw e	dd¬¦  «         G d:„ d+¦  «        ¦   «         ZxdGd>„ZydHdB„ZzdS )IzõInstance-segmentation / detection / keypoints evaluation surface.

Per ADR-0029, the AP-fold evaluation paradigm (bbox, segm, boundary,
keypoints) lives under ``vernier.instance``. Sibling to
:mod:`vernier.panoptic` and :mod:`vernier.semantic`.
é    )ÚannotationsN)ÚMappingÚSequence)Ú	dataclassÚfieldÚreplace)ÚAnyÚFinalÚLiteralÚNoReturnÚ	TypeAliasÚoverload)ÚCompressedRLEÚDetectionMatrixÚ
DetectionsÚDetectionsInputÚGtAnnotationsÚ
GtCategoryÚGtImagesÚJsonRLEÚPolygonSegmentationÚResultAnnotationÚRLEInputÚSegmentationInputÚUncompressedRLE)Úconfusion_matrix) ÚBackgroundEvaluatorÚ	BreakdownÚCocoDatasetÚDimensionMismatchErrorÚInvalidAnnotationErrorÚInvalidConfigErrorÚMemoryBudgetWarningÚNonFiniteErrorÚOutOfBudgetErrorÚPartialDatasetMismatchÚPartialFormatMismatchÚPartialParamsMismatchÚPartialPartitionOverlapÚPartialRankCollisionÚQueueFullErrorÚSummaryÚevaluate_bbox_gridÚevaluate_bbox_partitionedÚevaluate_bbox_summaryÚevaluate_boundary_gridÚevaluate_boundary_partitionedÚevaluate_boundary_summaryÚevaluate_keypoints_gridÚevaluate_keypoints_partitionedÚevaluate_keypoints_summaryÚevaluate_segm_gridÚevaluate_segm_partitionedÚevaluate_segm_summaryÚper_class_to_arrow_pycapsuleÚ per_detection_to_arrow_pycapsuleÚper_image_to_arrow_pycapsuleÚper_pair_to_arrow_pycapsule)Úcells_from_grid)Úevaluate_instance_to_partial)Úmerge_instance_partials)Ú	LrpConfigÚLrpPerClassÚ	LrpReportÚPartitionedLrpReportÚoptimal_lrp)ÚFpIouHistogramÚ
TideConfigÚ
TideReportÚerror_decompositionÚfp_iou_histogram)ÚDEFAULT_DILATION_RATIOÚSUPPORTED_TABLESÚCategoryFilterÚCategoryFilterAllÚCategoryFilterByGroupingÚCategoryFilterByIdsÚCategoryFilterFrequencyÚ
EvalResultÚIncompatibleSummaryPlanÚInvalidEvalParamsÚInvalidInstanceParamsÚ
ParityModeÚ	TableNameÚTablesConfigÚnormalize_tables_arg):r   ÚBboxÚBoundaryr   rL   rM   rN   rO   rP   r   r   r   r   r   r    rQ   Ú	EvaluatorrE   r   r   r   rR   r!   r"   rS   rT   ÚIouKindr   Ú	Keypointsr@   rA   rB   ÚManifestr#   r$   r%   r&   r'   r(   r)   r*   rC   r   r+   r   r   ÚSegmr   r,   rV   rW   rF   rG   r   r   rH   rI   rD   T)ÚfrozenÚslotsc                  ó   — e Zd ZdZdS )rY   z0Bounding-box IoU kernel selector. No parameters.N©Ú__name__Ú
__module__Ú__qualname__Ú__doc__© ó    úi/root/private/project/pallet_detection_v2/.venv/lib/python3.11/site-packages/vernier/instance/__init__.pyrY   rY   ©   s   € € € € € à:Ð:Ð:Ð:ri   rY   c                  ó   — e Zd ZdZdS )r_   z5Segmentation-mask IoU kernel selector. No parameters.Nrc   rh   ri   rj   r_   r_   ®   s   € € € € € à?Ð?Ð?Ð?ri   r_   c                  ó"   — e Zd ZU dZeZded<   dS )rZ   zÊBoundary IoU kernel selector (ADR-0010).

    ``dilation_ratio`` is the boundary band width as a fraction of the
    image diagonal. ``0.02`` is the COCO default; ``0.008`` is the LVIS
    variant.
    ÚfloatÚdilation_ratioN)rd   re   rf   rg   rJ   rn   Ú__annotations__rh   ri   rj   rZ   rZ   ³   s/   € € € € € € ðð ð 3€NÐ2Ð2Ð2Ñ2Ð2Ð2ri   rZ   c                  ó8   — e Zd ZU dZ ed„ ¬¦  «        Zded<   dS )r]   aÓ  OKS (Object Keypoint Similarity) kernel selector (ADR-0012).

    ``sigmas`` maps ``category_id`` -> per-keypoint sigma tuple. An empty
    mapping (the default) uses pycocotools' COCO-person 17-sigma table
    for every category. Per-category overrides honor quirk **F1**
    ("corrected"): pycocotools hard-codes the COCO-person sigmas; vernier
    accepts a per-category mapping while keeping the default byte-identical
    on single-category-person datasets.
    c                 ó\   — t          t          t          t          df         f         ¦   «         S )N.)ÚdictÚintÚtuplerm   rh   ri   rj   ú<lambda>zKeypoints.<lambda>Ì   s   € ¥¥S­%µ°s°
Ô*;Ð%;Ô <Ñ >Ô >€ ri   ©Údefault_factoryúMapping[int, tuple[float, ...]]ÚsigmasN)rd   re   rf   rg   r   ry   ro   rh   ri   rj   r]   r]   ¿   sR   € € € € € € ðð ð /4¨eØ>Ð>ð/ñ /ô /€Fð ð ð ñ ð ð ri   r]   r   r^   Ú
cross_axesúSequence[Sequence[str]] | NoneÚreturnúlist[list[str]] | Nonec                ó"   — | €dS d„ | D ¦   «         S )z½Coerce ``cross_axes`` into the ``list[list[str]]`` shape the FFI
    consumes. ``None`` passes through unchanged so the kwarg's default
    on the FFI side (no cross product) is what fires.Nc                ó,   — g | ]}t          |¦  «        ‘ŒS rh   ©Úlist)Ú.0Úaxess     rj   ú
<listcomp>z)_normalize_cross_axes.<locals>.<listcomp>ê   s   € Ð.Ð.Ð.˜4�D�‰JŒJÐ.Ð.Ð.ri   rh   )rz   s    rj   Ú_normalize_cross_axesr…   â   s#   € ð ÐØˆtØ.Ð. :Ð.Ñ.Ô.Ð.ri   )é   é
   éd   )é   z+Final[dict[type[IouKind], tuple[int, ...]]]Ú_KERNEL_MAX_DETSc                  ó   — e Zd ZdZdZdd„ZdS )Ú
_UnsetTypeuE  Singleton sentinel type for ``with_options`` keyword defaults.

    A dedicated class â€” rather than ``object()`` â€” lets pyright narrow
    on ``isinstance(arg, _UnsetType)`` cleanly without typing the
    parameter as ``Any``. Mirrors the pattern used by
    :data:`dataclasses.MISSING` and :data:`typing.NoDefault`.
    rh   r|   Ústrc                ó   — dS )Nz<UNSET>rh   ©Úselfs    rj   Ú__repr__z_UnsetType.__repr__  s   € Øˆyri   N)r|   r�   )rd   re   rf   rg   Ú	__slots__r‘   rh   ri   rj   rŒ   rŒ   ú   s9   € € € € € ðð ð €Iðð ð ð ð ð ri   rŒ   zFinal[_UnsetType]Ú_UNSETÚevr[   útuple[str, object] | Nonec                óf   — | j         �	d| j         fS | j        �	d| j        fS | j        �	d| j        fS dS )zõReturn ``(name, value)`` for the first custom-grid field set in
    field-declaration order, or ``None`` if none are set. Used by the
    :class:`IncompatibleSummaryPlan` redirect to point at *one* offending
    field even when multiple are set.NÚiou_thresholdsÚrecall_thresholdsÚarea_ranges)r—   r˜   r™   )r”   s    rj   Ú"_first_custom_grid_field_and_valuerš     sL   € ð
 
ÔÐ$Ø  "Ô"3Ð4Ð4Ø	ÔÐ'Ø# RÔ%9Ð:Ð:Ø	„~Ð!Ø˜rœ~Ð.Ð.Øˆ4ri   u   the canonical summary plans are keyed on hardcoded slot indices in the (T, R, K, A, M) tensor â€” AP_S is 'the second area-bucket entry of the all-IoU slice at maxDet=100', not 'the small-area slot'. Your custom grid breaks this index assumption. Use evaluate_tables(...) for tabular output that carries explicit labels per row, or remove the custom grid (set the field back to None) to use evaluate(). See ADR-0040.z
Final[str]Ú!_INCOMPATIBLE_SUMMARY_REMEDIATIONÚladderútuple[float, ...]Ú
field_namer�   ÚNonec               ó®  — t          | ¦  «        dk    rt          || d¬¦  «        ‚d}t          ¦   «         }| D ]œ}t          j        |¦  «        st          || d|›d�¬¦  «        ‚d|cxk    rdk    sn t          || d	|›d�¬¦  «        ‚||v rt          || d
|›d�¬¦  «        ‚|�||k     rt          || d¬¦  «        ‚|                     |¦  «         |}Œ�dS )zõValidate an IoU or recall threshold ladder per ADR-0040.

    Non-empty, every element finite and in ``[0.0, 1.0]``, sorted
    ascending, no duplicates. Raises :class:`InvalidInstanceParams`
    with a remediation pointer on any violation.
    r   zImust be non-empty (ADR-0040). Default canonical ladder applies when None.©r   ÚvalueÚremediationNz"every element must be finite (got z; ADR-0040)g        g      ð?z*every element must lie in [0.0, 1.0] (got zduplicate value z$; ADR-0040 requires distinct entriesz"must be sorted ascending; ADR-0040)ÚlenrT   ÚsetÚmathÚisfiniteÚadd)rœ   rž   ÚprevÚseenÚvs        rj   Ú_validate_threshold_ladderr¬   $  s]  € õ ˆ6�{„{�aÒÐÝ#ØØØcð
ñ 
ô 
ð 	
ð
 €DÝ‘u”u€DØð ð ˆÝŒ}˜QÑÔð 	Ý'Ø ØØQÀÐQÐQÐQðñ ô ð ð
 �aˆˆŠˆ˜3ŠˆˆˆÝ'Ø ØØYÈÐYÐYÐYðñ ô ð ð
 �ˆ9ˆ9Ý'Ø ØØX¨qÐXÐXÐXðñ ô ð ð
 Ð  D¢ Ý'Ø ØØ@ðñ ô ð ð
 	�Š�‰ŒˆØˆˆð5ð ri   Úbdr   c                ó@   — | j         dk    rt          d| d¬¦  «        ‚dS )u\  Validate the ``area_ranges`` Breakdown per ADR-0040.

    Must be a range-keyed Breakdown (built via
    :meth:`Breakdown.from_ranges`); class-group breakdowns are rejected.
    The Breakdown's own constructor already enforced
    non-empty / finite / lo <= hi / unique-label invariants â€” this
    function only adds the variant-shape check.
    Úranger™   z†must be a range Breakdown (Breakdown.from_ranges(...)); class-group Breakdowns belong on semantic / panoptic class_grouping (ADR-0040)r¡   N)ÚkindrT   )r­   s    rj   Ú_validate_area_ranges_breakdownr±   P  s<   € ð 
„w�'ÒÐÝ#ØØðað	
ñ 
ô 
ð 	
ð Ðri   c            
      ó   — e Zd ZU dZ ee¬¦  «        Zded<   dZded<   dZ	d	ed
<   dZ
ded<   dZded<   dZded<   dZded<   dZded<   dcd„Zddd„Zded„Zddeeeedddœdfd"„Zeddddddd#œdgd2„¦   «         Zedddddd3œdhd6„¦   «         Zedddddd7œdid:„¦   «         Zedddddd;œdjd=„¦   «         Zddddddd#œdkdA„ZddBœdldD„ZdEddFœdmdG„ZdddHœdndJ„ZdodN„ZeddddddOœdpdR„¦   «         ZdqdT„ZddUddVdWdddddXœ	drdb„ZdS )sr[   uô  Extended-API COCO-style evaluator.

    The instance is immutable per ADR-0006: construct once, call
    :meth:`evaluate` per dataset/detections pair. To change a parameter,
    use :meth:`with_options` (which returns a new evaluator).

    Defaults match pycocotools' detection eval grid, except for
    ``parity_mode``, which defaults to ``"corrected"`` (the ADR-0002
    recommendation for net-new users); migrating users wanting bit-exact
    pycocotools behavior should set ``parity_mode="strict"``.

    The ``iou`` field is a discriminated dataclass union (:data:`IouKind`);
    each variant carries its own kernel-specific parameters (per ADR-0011).
    Use ``Bbox()`` / ``Segm()`` / ``Boundary(dilation_ratio=...)``.

    ``max_dets`` defaults to ``None``, meaning "use the canonical ladder
    for the selected ``iou`` kernel" (ADR-0012). Resolution happens at
    dispatch via :data:`_KERNEL_MAX_DETS`; explicit values always win.
    The current three kernels all resolve to ``(1, 10, 100)``.

    ``cast_inputs`` (ADR-0030) gates one-shot ``f32â†’f64`` / ``i32â†’i64``
    promotion when array-form ``Detections`` are passed to
    :meth:`evaluate`; off by default to preserve the strict ADR-0004
    boundary. JSON-bytes detections ignore this flag.
    rv   r\   ÚiouÚ	correctedrU   Úparity_modeNútuple[int, ...] | NoneÚmax_detsztuple[float, ...] | Noner—   r˜   zBreakdown | Noner™   TÚboolÚuse_catsFÚcast_inputsr|   rŸ   c                ó´   — | j         �t          | j         d¬¦  «         | j        �t          | j        d¬¦  «         | j        �t	          | j        ¦  «         d S d S )Nr—   )rž   r˜   )r—   r¬   r˜   r™   r±   r�   s    rj   Ú__post_init__zEvaluator.__post_init__‰  sj   € ØÔÐ*Ý& tÔ':ÐGWÐXÑXÔXÐXØÔ!Ð-Ý& tÔ'=ÐJ]Ð^Ñ^Ô^Ð^ØÔÐ'Ý+¨DÔ,<Ñ=Ô=Ð=Ð=Ð=ð (Ð'ri   c                ó$   — t          | ¦  «        duS )z<``True`` when any of the ADR-0040 custom-grid fields is set.N)rš   r�   s    rj   Ú_has_custom_gridzEvaluator._has_custom_grid‘  s   € å1°$Ñ7Ô7¸tÐCÐCri   ú	list[int]c                ó¦   — | j         }|�t          |¦  «        S t          t                               t	          | j        ¦  «        d¦  «        ¦  «        S )a!  Materialize the effective ``max_dets`` ladder for this evaluator.

        Falls back to an empty ladder when ``iou`` is an unrecognized
        type so the dispatch ``case _:`` arm in :meth:`evaluate` can
        surface the friendly :class:`TypeError` instead of a ``KeyError``.
        Nrh   )r·   r�   rŠ   ÚgetÚtyper³   )r�   Úexplicits     rj   Ú_resolve_max_detszEvaluator._resolve_max_dets•  sD   € ð ”=ˆØÐÝ˜‘>”>Ð!ÝÕ$×(Ò(­¨d¬h©¬¸Ñ<Ô<Ñ=Ô=Ð=ri   )r³   rµ   r·   r—   r˜   r™   r¹   rº   úIouKind | NoneúParityMode | Noneú#tuple[int, ...] | None | _UnsetTypeú%tuple[float, ...] | None | _UnsetTypeúBreakdown | None | _UnsetTypeúbool | Nonec               ó(  — i }	|�||	d<   |�||	d<   t          |t          ¦  «        s||	d<   t          |t          ¦  «        s||	d<   t          |t          ¦  «        s||	d<   t          |t          ¦  «        s||	d<   |�||	d<   |�||	d	<   t          | fi |	¤ŽS )
aq  Return a copy of this evaluator with the given fields overridden.

        Sentinel-keyed fields (``max_dets``, ``iou_thresholds``,
        ``recall_thresholds``, ``area_ranges``) are three-valued:
        the default ``_UNSET`` leaves the field unchanged, ``None``
        resets to the kernel-canonical default, and a value sets an
        explicit override.
        Nr³   rµ   r·   r—   r˜   r™   r¹   rº   )Ú
isinstancerŒ   r   )
r�   r³   rµ   r·   r—   r˜   r™   r¹   rº   Úkwargss
             rj   Úwith_optionszEvaluator.with_options¡  sÐ   € ð( %'ˆØˆ?ØˆF�5‰MØÐ"Ø$/ˆF�=Ñ!Ý˜(¥JÑ/Ô/ð 	*Ø!)ˆF�:ÑÝ˜.­*Ñ5Ô5ð 	6Ø'5ˆFÐ#Ñ$ÝÐ+­ZÑ8Ô8ð 	<Ø*;ˆFÐ&Ñ'Ý˜+¥zÑ2Ô2ð 	0Ø$/ˆF�=Ñ!ØÐØ!)ˆF�:ÑØÐ"Ø$/ˆF�=Ñ!Ý�tÐ&Ð&˜vÐ&Ð&Ð&ri   )ÚtablesÚtables_configÚmanifestrz   ÚcalibrationÚnum_threadsÚgtúbytes | CocoDatasetÚdtr   rÏ   rÐ   úTablesConfig | NonerÑ   rz   rÒ   úLiteral[False]rÓ   ú
int | Noner,   c               ó   — d S ©Nrh   ©	r�   rÔ   rÖ   rÏ   rÐ   rÑ   rz   rÒ   rÓ   s	            rj   ÚevaluatezEvaluator.evaluateÈ  s	   € ð �#ri   )rÐ   rÑ   rz   rÒ   rÓ   ú&Literal['all'] | tuple[TableName, ...]rQ   c               ó   — d S rÛ   rh   rÜ   s	            rj   rÝ   zEvaluator.evaluateÖ  ó	   € ð �Sri   )rÏ   rÐ   rz   rÒ   rÓ   r^   r{   c               ó   — d S rÛ   rh   rÜ   s	            rj   rÝ   zEvaluator.evaluateä  rà   ri   )rÏ   rÐ   rÑ   rz   rÓ   úLiteral[True]c               ó   — d S rÛ   rh   rÜ   s	            rj   rÝ   zEvaluator.evaluateò  rà   ri   ú-Literal['all'] | tuple[TableName, ...] | NoneúManifest | NoneúSummary | EvalResultc          
     óX  — t          | ¦  «        }	|	�|	\  }
}t          |
|dt          ¬¦  «        ‚|                      ¦   «         }|�=|�t	          d¦  «        ‚|rt	          d¦  «        ‚|                      ||||||¬¦  «        S |€|r*|                      |||||pt          ¦   «         ||¬¦  «        S | j        xt          d˜ x�(\    t          ||| j        || j        | j        |¬	¦  «        S  xt          d˜ x�(\    t          ||| j        || j        | j        |¬	¦  «        S  xt           d
˜ x�*\  } t#          ||| j        || j        || j        |¬¦  «        S  t$          d˜ x�6\  }t'          ||| j        || j        t)          |¦  «        | j        |¬¦  «        S  	 t+          | j        ¦  «         dS )u{  Run the evaluation pipeline against a GT/DT pair.

        ``dt`` accepts any of four shapes, all of which evaluate
        identically for the same logical detections:

        - the COCO ``loadRes``-shaped JSON payload as ``bytes``;
        - the array-form :class:`Detections` shapes introduced by
          ADR-0030 â€” a single per-image dict or a sequence of them;
        - a list of per-annotation :class:`ResultAnnotation` dicts, the
          shape ``pycocotools.COCO.loadRes`` consumes and the one a
          TorchMetrics-style caller already holds (ADR-0057);
        - a :data:`DetectionMatrix` â€” an ``(N, 7)`` C-contiguous
          ``float64`` array laid out as ``image_id, x, y, w, h, score,
          category_id`` (ADR-0057). It carries no segmentation and no
          keypoints, exactly as a bbox-only results file does.

        Everything but ``bytes`` skips JSON serialization end-to-end and
        reads NumPy / DLPack buffers or Python scalars straight into the
        kernel.

        ``gt`` is either the GT JSON bytes (parse-and-discard, identical
        to prior behavior) or a :class:`CocoDataset` handle (parsed-once,
        with the cache reused across calls â€” see ADR-0020).

        ``tables=`` is the opt-in keyword for result tables. Defaults
        to ``None``, returning :class:`Summary` (existing behavior,
        bit-identical to 0.0.1). Pass ``"all"`` or a tuple of
        :data:`TableName`\ s to opt into the wider :class:`EvalResult`
        return type.

        ``manifest=`` opts into ADR-0046 partitioned eval. Accepts a
        dict (the canonical JSON-records shape), a file path
        (``.json``), or any object exposing the Arrow PyCapsule
        Interface (a polars / pandas / pyarrow DataFrame of per-image
        metadata). Returns an :class:`EvalResult` whose ``.summary``
        is bit-identical to the un-partitioned call and whose
        ``.slices`` property is a polars DataFrame with one row per
        ``(axis, value)`` cell. ``cross_axes=`` opts joint cells in
        (per ADR-0046 Â§E2; marginals are the default).

        ``calibration=`` opts into ADR-0018 detection-family calibration.
        When ``True``, the per-image cell store is retained on the
        returned :class:`EvalResult` (as ``_eval_cells``) and
        :meth:`EvalResult.calibration` becomes available; the canonical
        ``tables=None`` fast path is upgraded from :class:`Summary` to
        :class:`EvalResult` to carry the handle. Not currently supported
        on the ``manifest=`` partitioned path.

        Per ADR-0040, raises :class:`IncompatibleSummaryPlan` when
        ``iou_thresholds`` / ``recall_thresholds`` / ``area_ranges``
        is set explicitly: the canonical 12-stat summary plan is keyed
        on hardcoded slot indices that don't generalize. Use
        :meth:`evaluate_tables` for tabular output that carries
        explicit labels per row.
        Nz/COCO 12-stat / keypoints 10-stat / LVIS 13-stat)r   r¢   Úplanr£   u  tables= and manifest= cannot be combined. The partitioned eval returns headline metrics per slice on `result.slices`; for the per-class by per-slice cross product, run per_class evaluate once per slice with a filtered detection set â€” see docs/how-to/per-class-by-slice.md.zØcalibration=True and manifest= cannot be combined; calibration over the per-image cell store is not yet wired on the ADR-0046 partitioned path. Run un-partitioned with calibration=True to fold the full-dataset cells.©rÓ   ©rÒ   rÓ   rh   )rµ   r·   r¹   rº   rÓ   ©rn   )rµ   r·   r¹   rn   rº   rÓ   ©ry   )rµ   r·   r¹   ry   rº   rÓ   )rš   rR   r›   rÄ   Ú
ValueErrorÚ_evaluate_partitionedÚ_evaluate_with_tablesrW   r³   rY   r/   rµ   r¹   rº   r_   r8   rZ   r2   r]   r5   Ú_normalize_sigmasÚ_reject_unknown_iou)r�   rÔ   rÖ   rÏ   rÐ   rÑ   rz   rÒ   rÓ   Úoffenderrž   r¢   Úmax_dets_listÚrÚss                  rj   rÝ   zEvaluator.evaluate   sy  € õF 6°dÑ;Ô;ˆØÐØ (ÑˆJ˜Ý)Ø ØØFÝ=ð	ñ ô ð ð ×.Ò.Ñ0Ô0ˆØÐØÐ!Ý ð9ñô ð ð ð Ý ðGñô ð ð ×-Ò-Ø�B˜ x°Èð .ñ ô ð ð Ð ÐØ×-Ò-ØØØØØÐ/¥¡¤Ø'Ø'ð .ñ ô ð ð ŒhØ•����‘�Ý,ØØØ $Ô 0Ø*Ø!œ]Ø $Ô 0Ø +ðñ ô ð ð ð •����‘�Ý,ØØØ $Ô 0Ø*Ø!œ]Ø $Ô 0Ø +ðñ ô ð ð ð ,•Ð+Ð+Ð+Ð+Ñ+¨¨Ý0ØØØ $Ô 0Ø*Ø!œ]Ø#$Ø $Ô 0Ø +ð	ñ 	ô 	ð 	ð ,õ Ð$Ð$Ð$Ð$Ñ$ !Ý1ØØØ $Ô 0Ø*Ø!œ]Ý,¨QÑ/Ô/Ø $Ô 0Ø +ð	ñ 	ô 	ð 	ð %ð Ý# D¤HÑ-Ô-Ð-Ð-Ð-ri   ré   ró   c               óü  — t          |¦  «        }| j        xt          d˜ x�1\    t          ||| j        |d         | j        || j        ||¬¦	  «	        }nÜ xt          d˜ x�1\    t          ||| j        |d         | j        || j        ||¬¦	  «	        }nŸ xt          d˜ x�3\  }	 t          ||| j        |d         | j        |	|| j        ||¬¦
  «
        }n` t          d˜ x�?\  }
t          ||| j        |d         | j        t          |
¦  «        || j        ||¬¦
  «
        }n 	 t          | j        ¦  «         |                     ¦   «         }t!          |j        |t%          |j        ¦  «        t%          |j        ¦  «        ¬	¦  «        S )
zåADR-0046 partitioned eval dispatch. Routes the user's
        manifest input through the kernel-specific FFI entry, then
        wraps the resulting `PartitionedSummary` in an `EvalResult`
        carrying the slices RecordBatch.rh   Néÿÿÿÿ)rµ   Úmax_dets_per_imager¹   rÑ   rº   rz   rÓ   rë   )rµ   rø   r¹   rn   rÑ   rº   rz   rÓ   rì   )rµ   rø   r¹   ry   rÑ   rº   rz   rÓ   )ÚsummaryÚ_slices_batchÚoverall_n_imagesÚoverall_n_detections)r…   r³   rY   r.   rµ   r¹   rº   r_   r7   rZ   r1   r]   r4   rð   rñ   Úslices_capsulerQ   Úoverallrs   rû   rü   )r�   rÔ   rÖ   ró   rÑ   rz   rÓ   ÚcrossÚpsumrô   rõ   Úslices_batchs               rj   rî   zEvaluator._evaluate_partitionedœ  så  € õ & jÑ1Ô1ˆØŒhØ•����‘�Ý0ØØØ $Ô 0Ø'4°RÔ'8Ø!œ]Ø%Ø $Ô 0Ø$Ø +ð
ñ 
ô 
��ð ð •����‘�Ý0ØØØ $Ô 0Ø'4°RÔ'8Ø!œ]Ø%Ø $Ô 0Ø$Ø +ð
ñ 
ô 
��ð ð ,•Ð+Ð+Ð+Ð+Ñ+¨¨Ý4ØØØ $Ô 0Ø'4°RÔ'8Ø!œ]Ø#$Ø%Ø $Ô 0Ø$Ø +ðñ ô ��ð ,õ Ð$Ð$Ð$Ð$Ñ$ !Ý5ØØØ $Ô 0Ø'4°RÔ'8Ø!œ]Ý,¨QÑ/Ô/Ø%Ø $Ô 0Ø$Ø +ðñ ô ��ð %ð Ý# D¤HÑ-Ô-Ð-Ø×*Ò*Ñ,Ô,ˆÝØ”LØ&Ý  Ô!6Ñ7Ô7Ý!$ TÔ%>Ñ!?Ô!?ð	
ñ 
ô 
ð 	
ri   Úall)rÏ   rÐ   c               óx   — |                       ¦   «         }|                      |||||pt          ¦   «         ¦  «        S )a�  Tables-only evaluate path (ADR-0040 redirect target).

        Equivalent to :meth:`evaluate` with ``tables=`` set, but
        bypasses the :class:`IncompatibleSummaryPlan` redirect so
        custom-grid users can reach the result tables. Honors
        ``iou_thresholds`` / ``recall_thresholds`` / ``area_ranges``
        when set, falling through to the canonical COCO grid otherwise.
        )rÄ   rï   rW   )r�   rÔ   rÖ   rÏ   rÐ   ró   s         rj   Úevaluate_tableszEvaluator.evaluate_tablesè  sA   € ð  ×.Ò.Ñ0Ô0ˆØ×)Ò)Ø��M 6¨=Ð+J½L¹N¼Nñ
ô 
ð 	
ri   rê   rW   c               ó.  — |�t          |t          ¦  «        nt          ¦   «         }t          |ddhz  ¦  «        }	| j        €dnt          | j        ¦  «        }
| j        €dnt          | j        ¦  «        }| j        }| j        xt          d˜ x�3\    t          ||| j        |d         | j        |	| j        |
|||¬¦  «        }nó xt          d˜ x�3\    t          ||| j        |d         | j        |	| j        |
|||¬¦  «        }n´ xt           d˜ x�5\  } t#          ||| j        |d         | j        ||	| j        |
|||¬¦  «        }ns t$          d	˜ x�R\  }|rt'          d
¦  «        ‚t)          ||| j        |d         | j        t+          |¦  «        |	| j        |
|||¬¦  «        }n 	 t-          | j        ¦  «         |                     |¦  «        }|                      ¦   «         rdn|                     |¦  «        }|                     ¦   «         }d|v rt7          ||¦  «        nd}d|v rt9          |||¦  «        nd}d|v rt;          ||j        ¦  «        nd}d|v rt?          ||j         |j!        ¦  «        nd}|rtE          |¦  «        nd}tG          ||||||¬¦  «        S )a1  Tables-enabled evaluate path. Builds the EvalGrid, runs
        accumulate + summarize, then dispatches per-table FFI builders
        for the requested set.

        ``calibration=True`` additionally materializes an
        :class:`vernier._core.EvalCells` handle off the grid and stashes
        it on the returned :class:`EvalResult` for the ADR-0018
        calibration fold. With both ``tables=None`` and
        ``calibration=True`` we still go through this path so the grid
        is available; only the per-table FFI calls are short-circuited.
        NÚper_detectionÚper_pairrh   r÷   )	rµ   rø   r¹   Ú
retain_iourº   r—   r˜   r™   rÓ   rë   )
rµ   rø   r¹   rn   r  rº   r—   r˜   r™   rÓ   rì   zmtables= is detection-only in v0.5; keypoints uses a 3-bucket area grid that per_image/per_class do not target)
rµ   rø   r¹   ry   r  rº   r—   r˜   r™   rÓ   Ú	per_imageÚ	per_class)rù   Ú_per_image_batchÚ_per_class_batchÚ_per_detection_batchÚ_per_pair_batchÚ_eval_cells)$rX   rK   r¥   r¸   r—   r�   r˜   r™   r³   rY   r-   rµ   r¹   rº   r_   r6   rZ   r0   r]   ÚNotImplementedErrorr3   rð   rñ   Ú
accumulater¾   Ú	summarizeÚdatasetr;   r9   r:   Úper_detection_with_geometryr<   Úper_pair_iou_floorÚper_pair_max_rowsÚ_cells_from_gridrQ   )r�   rÔ   rÖ   ró   rÏ   rÐ   rÒ   rÓ   Ú	requestedÚneed_retentionÚ
custom_iouÚcustom_recallÚcustom_areasÚgridrô   rõ   Úaccumrù   r  Úper_image_batchÚper_class_batchÚper_detection_batchÚper_pair_batchÚ
eval_cellss                           rj   rï   zEvaluator._evaluate_with_tablesý  s†  € ð. ?EÐ>PÕ  Õ)9Ñ:Ô:Ð:ÕVYÑV[ÔV[ð 	õ ˜i¨?¸JÐ*GÑGÑHÔHˆð "Ô0Ð8�T�T½dÀ4ÔCVÑ>WÔ>Wˆ
Ø $Ô 6Ð >˜˜ÅDÈÔI_ÑD`ÔD`ˆØÔ'ˆàŒhØ•����‘�Ý)ØØØ $Ô 0Ø'4°RÔ'8Ø!œ]Ø-Ø $Ô 0Ø#-Ø&3Ø ,Ø +ðñ ô ��ð ð •����‘�Ý)ØØØ $Ô 0Ø'4°RÔ'8Ø!œ]Ø-Ø $Ô 0Ø#-Ø&3Ø ,Ø +ðñ ô ��ð ð ,•Ð+Ð+Ð+Ð+Ñ+¨¨Ý-ØØØ $Ô 0Ø'4°RÔ'8Ø!œ]Ø#$Ø-Ø $Ô 0Ø#-Ø&3Ø ,Ø +ðñ ô ��ð ,õ Ð$Ð$Ð$Ð$Ñ$ !Øð Ý-ðKñô ð õ /ØØØ $Ô 0Ø'4°RÔ'8Ø!œ]Ý,¨QÑ/Ô/Ø-Ø $Ô 0Ø#-Ø&3Ø ,Ø +ðñ ô ��ð %ð( Ý# D¤HÑ-Ô-Ð-à—’ Ñ.Ô.ˆð ×/Ò/Ñ1Ô1ÐU�$�$°u·²À}Ñ7UÔ7Uˆð —,’,‘.”.ˆð <GÈ)Ð;SÐ;SÕ(¨¨wÑ7Ô7Ð7ÐY]ð 	ð CNÐQZÐBZÐBZÕ(¨¨u°gÑ>Ô>Ð>Ð`dð 	ð
  )Ð+Ð+õ -¨T°=Ô3\Ñ]Ô]Ð]àð 	ð ˜YÐ&Ð&õ (ØØÔ0ØÔ/ñô ð ð ð 	ð 0;ÐDÕ% dÑ+Ô+Ð+Àˆ
ÝØØ,Ø,Ø!4Ø*Ø"ð
ñ 
ô 
ð 	
ri   ÚbytesÚrank_idrs   c               óÄ   — t          | ¦  «        }|�|\  }}t          ||d¬¦  «        ‚|                      ¦   «         }|                     d¦  «        }t	          ||||fi |¤ŽS )a;  Run the evaluation as a per-rank streaming submit and return
        the serialized partial bytes (ADR-0031, ADR-0035).

        ``rank_id`` identifies this evaluator's rank in a multi-process
        eval. The partial bytes can be gathered across ranks (e.g. via
        ``torch.distributed.all_gather_object``) and merged on the head
        rank with :meth:`from_partials` to produce a global Summary
        bit-equal to a batch :meth:`evaluate` over the union (in
        ``parity_mode="strict"`` once the ``(score, rank_id,
        local_position)`` tiebreak lands; under ADR-0004's 4-ULP
        envelope today).

        Per ADR-0040, raises :class:`InvalidInstanceParams` when any
        of ``iou_thresholds`` / ``recall_thresholds`` / ``area_ranges``
        is set: extending the ADR-0031 wire format to carry the
        resolved custom grid + bumping ``params_hash`` to cover the
        new fields is a follow-up. Batch :meth:`evaluate_tables`
        already honors the custom grid; pair it with a single-rank
        run until the streaming follow-up ships.
        NaL  evaluate_to_partial() with a custom iou_thresholds / recall_thresholds / area_ranges grid is deferred to a follow-up to ADR-0040 (extends the ADR-0031 wire format and the params_hash hash to cover the resolved custom grid). Use evaluate_tables(...) for single-rank custom grids today; multi-rank custom grids land in the next phase.r¡   Úiou_type)rš   rT   Ú_streaming_kwargsÚpopÚ_evaluate_instance_to_partial)	r�   rÔ   rÖ   r%  rò   rž   r¢   rÍ   r'  s	            rj   Úevaluate_to_partialzEvaluator.evaluate_to_partial�  sƒ   € õ6 6°dÑ;Ô;ˆØÐØ (ÑˆJ˜Ý'Ø Øðð	ñ ô ð ð ×'Ò'Ñ)Ô)ˆØ—:’:˜jÑ)Ô)ˆÝ,¨R°°X¸wÐQÐQÈ&ÐQÐQÐQri   ©r³   rµ   r·   r¹   rº   ÚpartialsúSequence[bytes]c              óÌ   —  | |�|nt          ¦   «         ||||¬¦  «        }|                     ¦   «         }	|	                     d¦  «        }
t          |t	          |¦  «        |
fi |	¤ŽS )aJ  Merge ``partials`` (one per rank) into a global :class:`Summary`
        (ADR-0031, ADR-0035).

        The kwargs mirror :class:`Evaluator`'s config fields and must
        match what each rank used to produce its partial. Mismatches
        raise the structured ``Partial*`` errors (re-exported on this
        module).
        Nr,  r'  )rY   r(  r)  Ú_merge_instance_partialsr�   )ÚclsrÔ   r-  r³   rµ   r·   r¹   rº   ÚconfigrÍ   r'  s              rj   Úfrom_partialszEvaluator.from_partials¿  sy   € ð* �Ø���­D©F¬FØ#ØØØ#ð
ñ 
ô 
ˆð ×)Ò)Ñ+Ô+ˆØ—:’:˜jÑ)Ô)ˆÝ'¨­D°©N¬N¸HÐOÐOÈÐOÐOÐOri   údict[str, Any]c                óf  — |                       ¦   «         }| j        || j        | j        dœ}| j        xt
          d˜ x�	\    d|d<   nl xt          d˜ x�	\    d|d<   nW xt          d˜ x�\  } d|d<   ||d<   n< t          d	˜ x�\  }d
|d<   t          |¦  «        |d<   n 	 t          | j        ¦  «         |S )N)rµ   r·   r¹   rº   rh   Úbboxr'  Úsegmrë   Úboundaryrn   rì   Ú	keypointsry   )rÄ   rµ   r¹   rº   r³   rY   r_   rZ   r]   rð   rñ   )r�   ró   rÍ   rô   rõ   s        rj   r(  zEvaluator._streaming_kwargsß  s  € ð
 ×.Ò.Ñ0Ô0ˆàÔ+Ø%ØœØÔ+ð	"
ð "
ˆð ŒhØ•����‘�Ø%+��zÑ"Ð"ð à•����‘�Ø%+��zÑ"Ð"ð à+•Ð+Ð+Ð+Ð+Ñ+¨¨Ø%/��zÑ"Ø+,�Ð'Ñ(Ð(ð ,õ Ð$Ð$Ð$Ð$Ñ$ !Ø%0��zÑ"Ý#4°QÑ#7Ô#7��xÑ Ð ð %ð Ý# D¤HÑ-Ô-Ð-Øˆri   é   é   g      @©	Úmemory_budget_bytesÚqueue_capacityÚworker_affinityÚworker_niceÚshutdown_timeout_secondsr  r%  Úrecord_latency_samplesrÓ   r=  r>  r?  r@  rA  rm   r  rB  r   c       	        óX   — |                       ¦   «         }t          |f||||||||	|
dœ	|¤ŽS )u  Build a :class:`BackgroundEvaluator` (ADR-0014, ADR-0020) that
        shares this evaluator's ``iou``, ``parity_mode``, ``max_dets``,
        ``use_cats``, and ``cast_inputs``.

        Passing a :class:`CocoDataset` for ``gt`` reuses the parsed-once
        handle's per-kernel GT-side derivation caches across every
        ``submit()`` round (ADR-0020). For boundary IoU this collapses
        the dominant per-epoch cost â€” building the GT band per
        annotation â€” from O(epochs) to O(1). Bbox and keypoints have
        no GT-side cache today, so the win there is just the JSON
        parse; segm sits between.

        The five queueing / scheduling knobs mirror the keyword-only
        parameters on :class:`BackgroundEvaluator`'s constructor.

        ``num_threads`` (ADR-0047 Stage B) opts the worker into inner
        parallel matching. ``None`` (default) preserves ADR-0014's
        one-core bound â€” exactly today's behavior. ``num_threads > 1``
        builds a per-worker scoped ``rayon::ThreadPool`` at worker
        spawn, owned by the worker thread, and dropped on worker exit;
        each ``submit()``'s per-image matching pass dispatches through
        that pool. The val-loader persona opts in here; the trainer
        persona leaves it ``None``.
        r<  )r(  r   )r�   rÔ   r=  r>  r?  r@  rA  r  r%  rB  rÓ   rÍ   s               rj   Ú
backgroundzEvaluator.backgroundú  sZ   € ðL ×'Ò'Ñ)Ô)ˆÝ"Øð
à 3Ø)Ø+Ø#Ø%=Ø!ØØ#9Ø#ð
ð 
ð ð
ð 
ð 	
ri   )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Ÿ   rz   rŸ   rÒ   rØ   rÓ   rÙ   r|   r,   )rÔ   rÕ   rÖ   r   rÏ   rÞ   rÐ   r×   rÑ   rŸ   rz   rŸ   rÒ   r¸   rÓ   rÙ   r|   rQ   )rÔ   rÕ   rÖ   r   rÏ   rŸ   rÐ   r×   rÑ   r^   rz   r{   rÒ   rØ   rÓ   rÙ   r|   rQ   )rÔ   rÕ   rÖ   r   rÏ   rŸ   rÐ   r×   rÑ   rŸ   rz   rŸ   rÒ   râ   rÓ   rÙ   r|   rQ   )rÔ   rÕ   rÖ   r   rÏ   rä   rÐ   r×   rÑ   rå   rz   r{   rÒ   r¸   rÓ   rÙ   r|   ræ   )rÔ   rÕ   rÖ   r   ró   r¿   rÑ   r^   rz   r{   rÓ   rÙ   r|   rQ   )
rÔ   rÕ   rÖ   r   rÏ   rÞ   rÐ   r×   r|   rQ   )rÔ   rÕ   rÖ   r   ró   r¿   rÏ   rä   rÐ   rW   rÒ   r¸   rÓ   rÙ   r|   rQ   )rÔ   r$  rÖ   r   r%  rs   r|   r$  )rÔ   r$  r-  r.  r³   rÅ   rµ   rU   r·   r¶   r¹   r¸   rº   r¸   r|   r,   )r|   r4  )rÔ   rÕ   r=  rÙ   r>  rs   r?  rÙ   r@  rs   rA  rm   r  r¸   r%  rÙ   rB  r¸   rÓ   rÙ   r|   r   )rd   re   rf   rg   r   rY   r³   ro   rµ   r·   r—   r˜   r™   r¹   rº   r¼   r¾   rÄ   r“   rÎ   r   rÝ   rî   r  rï   r+  Úclassmethodr3  r(  rD  rh   ri   rj   r[   r[   d  s�  € € € € € € ðð ð4 �5¨Ð.Ñ.Ô.€CÐ.Ð.Ð.Ñ.Ø)€KÐ)Ð)Ð)Ñ)Ø'+€HÐ+Ð+Ð+Ñ+Ø/3€NÐ3Ð3Ð3Ñ3Ø26ÐÐ6Ð6Ð6Ñ6Ø$(€KÐ(Ð(Ð(Ñ(Ø€HÐÐÐÑØ€KÐÐÐÑð>ð >ð >ð >ðDð Dð Dð Dð
>ð 
>ð 
>ð 
>ð #Ø)-Ø8>Ø@FØCIØ5;Ø $Ø#'ð%'ð %'ð %'ð %'ð %'ð %'ðN ð Ø-1ØØØ&+Ø"&ðð ð ð ð ñ „Xðð ð .2ØØØ!Ø"&ðð ð ð ð ñ „Xðð ð Ø-1à59Ø&+Ø"&ðð ð ð ð ñ „Xðð ð Ø-1ØØà"&ðð ð ð ð ñ „Xðð$ AEØ-1Ø$(Ø59Ø!Ø"&ðZ.ð Z.ð Z.ð Z.ð Z.ð Z.ðH #'ðJ
ð J
ð J
ð J
ð J
ð J
ðb :?Ø-1ð
ð 
ð 
ð 
ð 
ð 
ð: "Ø"&ðQ
ð Q
ð Q
ð Q
ð Q
ð Q
ðf-Rð -Rð -Rð -Rð^ ð #Ø"-Ø+/ØØ!ðPð Pð Pð Pð Pñ „[ðPð>ð ð ð ð> +/ØØ&*ØØ*-Ø Ø"Ø',Ø"&ð3
ð 3
ð 3
ð 3
ð 3
ð 3
ð 3
ð 3
ri   ry   rx   údict[int, list[float]]c                ó>   — d„ |                       ¦   «         D ¦   «         S )Nc                ó4   — i | ]\  }}|t          |¦  «        “ŒS rh   r€   )r‚   ÚcatÚsigss      rj   ú
<dictcomp>z%_normalize_sigmas.<locals>.<dictcomp>5  s$   € Ð<Ð<Ð<¡	  TˆC•�d‘”Ð<Ð<Ð<ri   )Úitemsrì   s    rj   rð   rð   0  s    € ð
 =Ð<¨V¯\ª\©^¬^Ð<Ñ<Ô<Ð<ri   r³   Úobjectr   c                ó(   — t          d| ›d�¦  «        ‚)Nzunsupported iou kernel u\   ; expected Bbox(), Segm(), Boundary(...), or Keypoints(...) â€” see vernier.instance.IouKind)Ú	TypeError)r³   s    rj   rñ   rñ   8  s.   € Ý
ð	M #ð 	Mð 	Mð 	Mñô ð ri   )rz   r{   r|   r}   )r”   r[   r|   r•   )rœ   r�   rž   r�   r|   rŸ   )r­   r   r|   rŸ   )ry   rx   r|   rF  )r³   rM  r|   r   ){rg   Ú
__future__r   r¦   ÚosÚcollections.abcr   r   Údataclassesr   r   r   Útypingr	   r
   r   r   r   r   Úvernier._array_typesr   r   r   r   r   r   r   r   r   r   r   r   r   Úvernier._confusionr   Úvernier._corer   r   r   r    r!   r"   r#   r$   r%   r&   r'   r(   r)   r*   r+   r,   r-   r.   r/   r0   r1   r2   r3   r4   r5   r6   r7   r8   r9   r:   r;   r<   r=   r  r>   r*  r?   r0  Úvernier._lrpr@   rA   rB   rC   rD   Úvernier._tiderE   rF   rG   rH   rI   Úvernier._typesrJ   rK   rL   rM   rN   rO   rP   rQ   rR   rS   rT   rU   rV   rW   rX   Ú__all__rY   r_   rZ   r]   r\   r�   ÚPathLiker^   ro   r…   rŠ   rŒ   r“   rš   r›   r¬   r±   r[   rð   rñ   rh   ri   rj   ú<module>r]     s  ððð ð ð #Ð "Ð "Ð "Ð "Ð "à €€€Ø 	€	€	€	Ø -Ð -Ð -Ð -Ð -Ð -Ð -Ð -Ø 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ø EÐ EÐ EÐ EÐ EÐ EÐ EÐ EÐ EÐ EÐ EÐ EÐ EÐ EÐ EÐ Eðð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð 0Ð /Ð /Ð /Ð /Ð /ð!ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ð !ðDð ð ð ð ð ðð ð ð ð ð ðð ð ð ð ð ðð ð ð ð ð ð ð ð ð ð ð ð ð ðð ð ð ð ð ð ð ð ð ð ð ð ð ðð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð$;ð ;ð ;€ð| €�$˜dÐ#Ñ#Ô#ð;ð ;ð ;ð ;ð ;ñ ;ô ;ñ $Ô#ð;ð €�$˜dÐ#Ñ#Ô#ð@ð @ð @ð @ð @ñ @ô @ñ $Ô#ð@ð €�$˜dÐ#Ñ#Ô#ð3ð 3ð 3ð 3ð 3ñ 3ô 3ñ $Ô#ð3ð €�$˜dÐ#Ñ#Ô#ðð ð ð ð ñ ô ñ $Ô#ðð& �‰+˜Ñ
  9Ñ
,€ð ˜c 3˜hÔ'¨#Ñ-°´¸CÔ0@Ñ@À3ÑF€Ð FÐ FÐ FÑ Fð/ð /ð /ð /ð" 	ˆ,Øˆ,ØˆlØˆuð	AÐ ð ð ð ñ ðð ð ð ð ñ ô ð ð '˜J™LœL€Ð (Ð (Ð (Ñ (ðð ð ð ðDð "ð ð ð ñ ð)ð )ð )ð )ðX
ð 
ð 
ð 
ð( €�$˜dÐ#Ñ#Ô#ðH
ð H
ð H
ð H
ð H
ñ H
ô H
ñ $Ô#ðH
ðV=ð =ð =ð =ðð ð ð ð ð ri   