src.dackar.RCA.equipment_similarity
===================================

.. py:module:: src.dackar.RCA.equipment_similarity

.. autoapi-nested-parse::

   equipment_similarity — KG-spec embedding + failure mode overlap for sister equipment identification.

   Two tiers of equipment similarity beyond KG topology:

     Tier 2: Failure mode overlap
         Derived from kg_context.failure_modes[] — no new KG query, no Chroma needed.
         Components sharing ≥ N failure modes are flagged as sisters.

     Tier 3: Spec embedding similarity
         element_definition node properties (type, size, design class, manufacturer, model)
         are pre-embedded into a dedicated Chroma collection (doc_type="equipment_specs")
         at KG setup time via KGEquipmentPoller.  At RCA time, the target component's
         description is used as a query to find similar equipment across the plant/fleet.

   Population is a one-time offline step — see KGEquipmentPoller and EQUIPMENT_SIMILARITY_GUIDE.md.



Submodules
----------

.. toctree::
   :maxdepth: 1

   /autoapi/src/dackar/RCA/equipment_similarity/equipment_similarity_resolver/index
   /autoapi/src/dackar/RCA/equipment_similarity/equipment_spec_builder/index
   /autoapi/src/dackar/RCA/equipment_similarity/equipment_spec_store/index
   /autoapi/src/dackar/RCA/equipment_similarity/kg_equipment_poller/index