lenskit.metrics.ranking.Entropy
===============================

.. py:class:: lenskit.metrics.ranking.Entropy(dataset, attribute, n = None)
   :canonical: lenskit.metrics.ranking._entropy.Entropy

   Bases: :py:obj:`lenskit.metrics.ranking._base.ListMetric`, :py:obj:`lenskit.metrics.ranking._base.RankingMetricBase`


   Evaluate diversity using Shannon entropy over item categories.

   This metric measures the diversity of categories in recommendation list.
   Higher entropy indicates more diverse category distribution.

   :param dataset: The LensKit dataset containing item entities and their attributes.
   :param attribute: Name of the attribute to use for categories (e.g., 'genre', 'tag')
   :param n: Recommendation list length to evaluate

   :Stability: Caller


   .. py:attribute:: attribute
      :type:  str


   .. py:property:: label

      The metric's default label in output.
      The base implementation returns the class name by default.


   .. py:method:: measure_list(recs, test)

      Compute measurements for a single list.

      :returns:

                - A float for simple metrics
                - Intermediate data for decomposed metrics
                - A dict mapping metric names to values for multi-metric classes