panels.evidence
===============

.. py:module:: panels.evidence

.. autoapi-nested-parse::

   Evidence panel: retrieval health, doc-type mix, and per-candidate excerpts.

   Reads the ``evidence_bundle`` artifact (results, provenance, retrieval scope,
   planned queries, candidate-evidence summary) and the ``causality_candidates``
   artifact to order and label hits. Honors the ``rca_viz_evidence_filter``
   session value so jumps from the Candidates/RCA Card tabs land pre-filtered.



Attributes
----------

.. autoapisummary::

   panels.evidence.JsonDict


Functions
---------

.. autoapisummary::

   panels.evidence._linked_id
   panels.evidence._support_role
   panels.evidence._doc_type
   panels.evidence._bm25_from_hits
   panels.evidence.render_evidence_panel
   panels.evidence._candidate_filter_options
   panels.evidence._ordered_candidate_ids


Module Contents
---------------

.. py:data:: JsonDict

.. py:function:: _linked_id(hit)

.. py:function:: _support_role(hit)

.. py:function:: _doc_type(hit)

.. py:function:: _bm25_from_hits(results)

   Infer BM25 availability from hit metadata; align with retriever provenance.


.. py:function:: render_evidence_panel(evidence_bundle, causality_candidates)

   Render the Evidence section.

   @ In, evidence_bundle, dict, the ``evidence_bundle`` artifact; reads
       ``results``, ``provenance``, ``retrieval_scope``, ``planned_queries``,
       ``candidate_evidence_summary``; None shows an info note
   @ In, causality_candidates, dict, optional; supplies candidate ordering and
       the "filter by linked candidate" options
   @ Out, None


.. py:function:: _candidate_filter_options(causality_candidates, results)

.. py:function:: _ordered_candidate_ids(causality_candidates, results)