.. _sphx_glr_auto_examples_visualization:

Visualization
=============

Examples showcasing ``shapiq``'s visualization capabilities: force plots,
beeswarm plots, SI graph plots, UpSet plots, and more.



.. raw:: html

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

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A minimal example showing how to compute exact Shapley values for a small cooperative game using ExactComputer.">

.. only:: html

  .. image:: /auto_examples/visualization/images/thumb/sphx_glr_plot_shapley_values_thumb.png
    :alt:

  :doc:`/auto_examples/visualization/plot_shapley_values`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates the UpSet plot for visualizing feature interactions. The UpSet plot shows the most important interactions as vertical bars with the interacting features in a matrix below.">

.. only:: html

  .. image:: /auto_examples/visualization/images/thumb/sphx_glr_plot_upset_thumb.png
    :alt:

  :doc:`/auto_examples/visualization/plot_upset`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">UpSet Plot</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates the SI graph plot, which visualizes Shapley interactions as a network. Players are nodes; interactions are edges whose color, thickness, and opacity encode strength and direction.">

.. only:: html

  .. image:: /auto_examples/visualization/images/thumb/sphx_glr_plot_si_graph_thumb.png
    :alt:

  :doc:`/auto_examples/visualization/plot_si_graph`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">SI Graph Plot</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A comprehensive tour of all local and global visualization functions in shapiq: force plot, waterfall plot, network plot, SI graph plot, stacked bar plot, and global bar plot.">

.. only:: html

  .. image:: /auto_examples/visualization/images/thumb/sphx_glr_plot_visualizing_interactions_thumb.png
    :alt:

  :doc:`/auto_examples/visualization/plot_visualizing_interactions`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Visualization Catalog</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to create, manipulate, aggregate, and visualize InteractionValues objects -- the central output type of shapiq.">

.. only:: html

  .. image:: /auto_examples/visualization/images/thumb/sphx_glr_plot_interaction_values_thumb.png
    :alt:

  :doc:`/auto_examples/visualization/plot_interaction_values`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Working with InteractionValues</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates beeswarm_plot, which provides a global perspective on feature interactions by plotting interaction values across multiple instances, colored by feature value.">

.. only:: html

  .. image:: /auto_examples/visualization/images/thumb/sphx_glr_plot_beeswarm_thumb.png
    :alt:

  :doc:`/auto_examples/visualization/plot_beeswarm`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Beeswarm Plot</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates scatter_plot, which plots the per-sample value of an interaction against the value of one feature. For first-order interactions this matches SHAP&#x27;s shap.plots.scatter; for higher-order interactions the x-axis is restricted to a single feature in the interaction tuple.">

.. only:: html

  .. image:: /auto_examples/visualization/images/thumb/sphx_glr_plot_scatter_thumb.png
    :alt:

  :doc:`/auto_examples/visualization/plot_scatter`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Scatter Plot</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /auto_examples/visualization/plot_shapley_values
   /auto_examples/visualization/plot_upset
   /auto_examples/visualization/plot_si_graph
   /auto_examples/visualization/plot_visualizing_interactions
   /auto_examples/visualization/plot_interaction_values
   /auto_examples/visualization/plot_beeswarm
   /auto_examples/visualization/plot_scatter