If no artist or sequence of artists is specified, all manually plotted artistsin all axes in all figures will be activated. (This can be limited to onlycertain axes by passing in an axes object or a sequence of axes to the ``axes``kwarg.)

To hide the annotation boxes, press "d" on the keyboard. (Think of "delete"."h" was taken by matplotlib's default key for "home".) To disable or re-enableinteractive datacursors, press "t" (for "toggle"). These keys can becustomized through the ``keybindings`` kwarg.

Controlling the Displayed Text------------------------------The displayed text can be controlled either by using the ``formatter`` kwarg, which expects a function that accepts an arbitrary sequence of kwargs andreturns the string to be displayed. Often, it's convenient to pass in the``format`` method of a template string (e.g. ``formatter="longitude:{x:.2f}\nlatitude{y:.2f}".format``).

As an example of using the ``formatter`` kwarg to display only the label of theartist instead of the x, y coordinates::

Working with Images-------------------``datacursor`` will also display the array value at the selected point in animage. This example also demonstrates using the ``display="single"`` option todisplay only one data cursor instead of one-per-axes.::

Further Customization---------------------Additional keyword arguments to ``datacursor`` are passed on to ``annotate``.This allows one to control the appearance and location of the "popup box",arrow, etc. Note that properties passed in for the ``bbox`` and ``arrowprops``kwargs will be merged with the default style. Therefore, specifying thingslike ``bbox=dict(alpha=1)`` will yield an opaque, yellow, rounded box, insteadof matplotlib's default blue, square box. As a basic example::

Installation------------``mpldatacursor`` can be installed from PyPi using``easy_install``/``pip``/etc. (e.g. ``pip install mpldatacursor``) or you maydownload the source and install it directly with ``python setup.py install``.