add a cool table to the docs
@@ -29,6 +29,25 @@ These measures all reduce to the standard Shannon :ref:`mutual_information` for
total_correlation
dual_total_correlation
+It is perhaps illustrative to consider how each of these measures behaves on two canonical distributions: the giant bit and parity.
+
++-----------+----------------------------------------+-------------------------------------------------------------+
+| | giant bit | parity |
++-----------+---+----------------+-----------+---+---+----------------+----+---+-----------+-----------------------+
+| | I | II | T | B | J | I | II | T | B | J |
++-----------+---+----------------+-----------+---+---+----------------+----+---+-----------+-----------------------+
+| 2 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 |
++-----------+---+----------------+-----------+---+---+----------------+----+---+-----------+-----------------------+
+| 3 | 1 | -1 | 2 | 1 | 1 | -1 | 1 | 1 | 2 | :math:`\frac{1}{2}` |
++-----------+---+----------------+-----------+---+---+----------------+----+---+-----------+-----------------------+
+| 4 | 1 | 1 | 3 | 1 | 1 | 1 | 1 | 1 | 3 | :math:`\frac{1}{3}` |
++-----------+---+----------------+-----------+---+---+----------------+----+---+-----------+-----------------------+
+| 5 | 1 | -1 | 4 | 1 | 1 | -1 | 1 | 1 | 4 | :math:`\frac{1}{4}` |
++-----------+---+----------------+-----------+---+---+----------------+----+---+-----------+-----------------------+
+| :math:`n` | 1 | :math:`(-1)^n` | :math:`n` | 1 | 1 | :math:`(-1)^n` | 1 | 1 | :math:`n` | :math:`\frac{1}{n-1}` |
++-----------+---+----------------+-----------+---+---+----------------+----+---+-----------+-----------------------+
+
+
Common Informations
===================
These measures all somehow measure shared information, but do not equal the mutual information in the bivaraite case.
