@@ -59,6 +59,15 @@ not need to be installed, but Matplotlib should be)::
5959
6060.. _command-line parameters :http://doc.pytest.org/en/latest/usage.html
6161
62+ Viewing image test output
63+ ^^^^^^^^^^^^^^^^^^^^^^^^^
64+
65+ The output of:ref: `image-based <image-comparison >` tests is stored in a
66+ ``result_images `` directory. These images can be compiled in an HTML page using the
67+ ``visualize_tests `` tool::
68+
69+ python tools/visualize_tests.py
70+
6271
6372Writing a simple test
6473---------------------
@@ -94,7 +103,9 @@ For numpy's default random number generator use::
94103
95104and then use ``rng `` when generating the random numbers.
96105
97- The seed is John Hunter's birthday.
106+ The seed is:ref: `John Hunter's <project_history >` birthday.
107+
108+ .. _image-comparison :
98109
99110Writing an image comparison test
100111--------------------------------
@@ -128,6 +139,10 @@ texts (labels, tick labels, etc) are not really part of what is tested, use
128139``remove_text=True `` as this will lead to smaller figures and reduce possible
129140issues with font mismatch on different platforms.
130141
142+
143+ Compare two methods of creating an image
144+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
145+
131146Baseline images take a lot of space in the Matplotlib repository.
132147An alternative approach for image comparison tests is to use the
133148`~matplotlib.testing.decorators.check_figures_equal ` decorator, which should be