1 | # This program is public domain |
---|
2 | """ |
---|
3 | Configure plotter for plottools. |
---|
4 | |
---|
5 | This must be imported first in __init__.py for plottools. |
---|
6 | |
---|
7 | If your application uses matplotlib outside plottools, then |
---|
8 | please do the following at the start of your application: |
---|
9 | |
---|
10 | # Select matplotlib version and backend |
---|
11 | import sans.plottools.config |
---|
12 | |
---|
13 | Note that plottools requires particular versions of matplotlib |
---|
14 | and a particular backend. As of this writing it is the WXAgg |
---|
15 | backend for matplotlib>=0.98. |
---|
16 | |
---|
17 | The plottools package uses pkg_resources if available to select |
---|
18 | the correct version of matplotlib. If you need multiple matplotlib |
---|
19 | versions in your path, be sure to use "easy_install -m" for all |
---|
20 | of them. If a version is installed without "-m" that does not |
---|
21 | meet the requirements, then pkg_resources.require() will fail, |
---|
22 | even if you have installed a suitable version with "-m". In this |
---|
23 | case you will need to fix up your site-packages directory, |
---|
24 | probably by removing site-packages/matplotlib and the associated |
---|
25 | egg file for that version, and reinstalling with "-m". You may |
---|
26 | also need to edit site-packages/easy-install.pth. |
---|
27 | """ |
---|
28 | import sys |
---|
29 | |
---|
30 | __all__ = [] |
---|
31 | |
---|
32 | plot_version = "0.98" |
---|
33 | plot_backend = "WXAgg" |
---|
34 | |
---|
35 | # Sort out matplotlib version |
---|
36 | import matplotlib |
---|
37 | try: |
---|
38 | import pkg_resources |
---|
39 | pkg_resources.require("matplotlib>=" + plot_version) |
---|
40 | except: |
---|
41 | from distutils.version import LooseVersion as Version |
---|
42 | if Version(matplotlib.__version__) < Version(plot_version): |
---|
43 | msg = "Matplotlib version must be %s or newer" % (plot_version, ) |
---|
44 | raise ImportError(msg) |
---|
45 | |
---|
46 | # Sort out matplotlib backend |
---|
47 | #import matplotlib |
---|
48 | if 'matplotlib.backends' not in sys.modules: |
---|
49 | # if no backend yet, be sure to use the correct one |
---|
50 | matplotlib.use(plot_backend) |
---|
51 | elif matplotlib.get_backend() != plot_backend: |
---|
52 | # if a backend has already been selected, make sure it is the correct one. |
---|
53 | raise ImportError("Matplotlib not using backend " + plot_backend) |
---|