.. _sphx_glr_auto_examples_basics:

Basics
======

Introductory examples covering core ``shapiq`` concepts: Shapley value computation,
custom cooperative games, and parallel computation.



.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to speed up shapiq explanations using parallel computation via joblib. We use a simple synthetic game to keep runtime short.">

.. only:: html

  .. image:: /auto_examples/basics/images/thumb/sphx_glr_plot_parallel_computation_thumb.png
    :alt:

  :doc:`/auto_examples/basics/plot_parallel_computation`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Parallel Computation with joblib</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to define custom cooperative games and use them with shapiq. We model a simple cooking game and show how to query the value function, precompute all coalition values, and save/load them.">

.. only:: html

  .. image:: /auto_examples/basics/images/thumb/sphx_glr_plot_custom_games_thumb.png
    :alt:

  :doc:`/auto_examples/basics/plot_custom_games`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Defining Custom Games</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example introduces cooperative game theory and shows how to compute Shapley values with shapiq -- both exactly and via approximation -- and how to apply them for explainable AI (XAI).">

.. only:: html

  .. image:: /auto_examples/basics/images/thumb/sphx_glr_plot_sv_calculation_thumb.png
    :alt:

  :doc:`/auto_examples/basics/plot_sv_calculation`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Computing Shapley Values</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /auto_examples/basics/plot_parallel_computation
   /auto_examples/basics/plot_custom_games
   /auto_examples/basics/plot_sv_calculation