|
1 | 1 | .. _thirdparty-index: |
2 | 2 |
|
3 | | -********************* |
4 | | - Third party packages |
5 | | -********************* |
6 | | - |
7 | | -Several external packages that extend or build on Matplotlib functionality |
8 | | -exist. Below we list a number of these. Note that they are each |
9 | | -maintained and distributed separately from Matplotlib, and will need |
10 | | -to be installed individually. |
| 3 | +******************** |
| 4 | +Third party packages |
| 5 | +******************** |
11 | 6 |
|
12 | | -Please submit an issue or pull request |
13 | | -on Github if you have created a package that you would like to have included. |
14 | | -We are also happy to host third party packages within the `Matplotlib Github |
15 | | -Organization <https://github.com/matplotlib>`_. |
| 7 | +Several external packages that extend or build on Matplotlib functionality are |
| 8 | +listed below. They are maintained and distributed separately from Matplotlib |
| 9 | +and thus need to be installed individually. |
16 | 10 |
|
17 | | -.. _hl_plotting: |
| 11 | +Please submit an issue or pull request on Github if you have created |
| 12 | +a package that you would like to have included. We are also happy to |
| 13 | +host third party packages within the `Matplotlib Github Organization |
| 14 | +<https://github.com/matplotlib>`_. |
18 | 15 |
|
19 | | -High-Level Plotting |
20 | | -******************* |
| 16 | +Mapping toolkits |
| 17 | +**************** |
21 | 18 |
|
22 | | -Several projects provide higher-level interfaces for creating |
23 | | -matplotlib plots. |
| 19 | +Basemap |
| 20 | +======= |
| 21 | +`Basemap <http://matplotlib.org/basemap>`_ plots data on map projections, with |
| 22 | +continental and political boundaries. |
24 | 23 |
|
25 | | -.. _toolkit_seaborn: |
| 24 | +.. image:: /_static/basemap_contour1.png |
| 25 | + :height: 400px |
26 | 26 |
|
27 | | -seaborn |
| 27 | +Cartopy |
28 | 28 | ======= |
| 29 | +`Cartopy <http://scitools.org.uk/cartopy/docs/latest>`_ builds on top |
| 30 | +of Matplotlib to provide object oriented map projection definitions |
| 31 | +and close integration with Shapely for powerful yet easy-to-use vector |
| 32 | +data processing tools. An example plot from the `Cartopy gallery |
| 33 | +<http://scitools.org.uk/cartopy/docs/latest/gallery.html>`_: |
29 | 34 |
|
30 | | -`seaborn <http://seaborn.pydata.org/>`_ is a high level interface for drawing |
31 | | -statistical graphics with matplotlib. It aims to make visualization a central |
32 | | -part of exploring and understanding complex datasets. |
33 | | - |
34 | | -.. image:: /_static/seaborn.png |
35 | | - :height: 157px |
| 35 | +.. image:: /_static/cartopy_hurricane_katrina_01_00.png |
| 36 | + :height: 400px |
36 | 37 |
|
37 | | -.. _toolkit_ggplot: |
| 38 | +Declarative libraries |
| 39 | +********************* |
38 | 40 |
|
39 | 41 | ggplot |
40 | 42 | ====== |
41 | | - |
42 | 43 | `ggplot <https://github.com/yhat/ggplot>`_ is a port of the R ggplot2 package |
43 | | -to python based on matplotlib. |
| 44 | +to python based on Matplotlib. |
44 | 45 |
|
45 | 46 | .. image:: /_static/ggplot.png |
46 | 47 | :height: 195px |
47 | 48 |
|
48 | | -.. _toolkit_holoviews: |
49 | | - |
50 | 49 | holoviews |
51 | 50 | ========= |
52 | | - |
53 | 51 | `holoviews <http://holoviews.org>`_ makes it easier to visualize data |
54 | | -interactively, especially in a `Jupyter notebook |
55 | | -<http://jupyter.org>`_, by providing a set of declarative |
56 | | -plotting objects that store your data and associated metadata. Your |
57 | | -data is then immediately visualizable alongside or overlaid with other |
58 | | -data, either statically or with automatically provided widgets for |
59 | | -parameter exploration. |
| 52 | +interactively, especially in a `Jupyter notebook <http://jupyter.org>`_, by |
| 53 | +providing a set of declarative plotting objects that store your data and |
| 54 | +associated metadata. Your data is then immediately visualizable alongside or |
| 55 | +overlaid with other data, either statically or with automatically provided |
| 56 | +widgets for parameter exploration. |
60 | 57 |
|
61 | 58 | .. image:: /_static/holoviews.png |
62 | 59 | :height: 354px |
63 | 60 |
|
| 61 | +Specialty plots |
| 62 | +*************** |
64 | 63 |
|
65 | | -.. _toolkits-mapping: |
| 64 | +Matplotlib-Venn |
| 65 | +=============== |
| 66 | +`Matplotlib-Venn <https://github.com/konstantint/matplotlib-venn>`_ provides a |
| 67 | +set of functions for plotting 2- and 3-set area-weighted (or unweighted) Venn |
| 68 | +diagrams. |
66 | 69 |
|
67 | | -Mapping Toolkits |
68 | | -**************** |
| 70 | +mpl-probscale |
| 71 | +============= |
| 72 | +`mpl-probscale <http://matplotlib.org/mpl-probscale/>`_ is a small extension |
| 73 | +that allows Matplotlib users to specify probabilty scales. Simply importing the |
| 74 | +``probscale`` module registers the scale with Matplotlib, making it accessible |
| 75 | +via e.g., ``ax.set_xscale('prob')`` or ``plt.yscale('prob')``. |
69 | 76 |
|
70 | | -Two independent mapping toolkits are available. |
| 77 | +.. image:: /_static/probscale_demo.png |
71 | 78 |
|
72 | | -.. _toolkit_basemap: |
| 79 | +mplstereonet |
| 80 | +============ |
| 81 | +`mplstereonet <https://github.com/joferkington/mplstereonet>`_ provides |
| 82 | +stereonets for plotting and analyzing orientation data in Matplotlib. |
73 | 83 |
|
74 | | -Basemap |
| 84 | +Natgrid |
75 | 85 | ======= |
| 86 | +`mpl_toolkits.natgrid <https://github.com/matplotlib/natgrid>`_ is an interface |
| 87 | +to the natgrid C library for gridding irregularly spaced data. |
76 | 88 |
|
77 | | -Plots data on map projections, with continental and political |
78 | | -boundaries. See `basemap <http://matplotlib.org/basemap>`_ |
79 | | -docs. |
80 | | - |
81 | | -.. image:: /_static/basemap_contour1.png |
82 | | - :height: 400px |
83 | | - |
84 | | - |
85 | | - |
86 | | -Cartopy |
| 89 | +pyUpSet |
87 | 90 | ======= |
88 | | -`Cartopy <http://scitools.org.uk/cartopy/docs/latest>`_ builds on top of |
89 | | -matplotlib to provide object oriented map projection definitions and close |
90 | | -integration with Shapely for powerful yet easy-to-use vector data processing |
91 | | -tools. An example plot from the |
92 | | -`Cartopy gallery <http://scitools.org.uk/cartopy/docs/latest/gallery.html>`_: |
| 91 | +`pyUpSet <https://github.com/ImSoErgodic/py-upset>`_ is a |
| 92 | +static Python implementation of the `UpSet suite by Lex et al. |
| 93 | +<http://www.caleydo.org/tools/upset/>`_ to explore complex intersections of |
| 94 | +sets and data frames. |
93 | 95 |
|
94 | | -.. image:: /_static/cartopy_hurricane_katrina_01_00.png |
95 | | - :height: 400px |
| 96 | +seaborn |
| 97 | +======= |
| 98 | +`seaborn <http://seaborn.pydata.org/>`_ is a high level interface for drawing |
| 99 | +statistical graphics with Matplotlib. It aims to make visualization a central |
| 100 | +part of exploring and understanding complex datasets. |
96 | 101 |
|
| 102 | +.. image:: /_static/seaborn.png |
| 103 | + :height: 157px |
97 | 104 |
|
98 | | -.. _toolkits-misc: |
99 | | -.. _toolkits-general: |
| 105 | +Windrose |
| 106 | +======== |
| 107 | +`Windrose <https://github.com/scls19fr/windrose>`_ is a Python Matplotlib, |
| 108 | +Numpy library to manage wind data, draw windroses (also known as polar rose |
| 109 | +plots), draw probability density functions and fit Weibull distributions. |
100 | 110 |
|
101 | | -Miscellaneous Toolkits |
102 | | -********************** |
| 111 | +Interactivity |
| 112 | +************* |
103 | 113 |
|
104 | | -.. _toolkit_probscale: |
| 114 | +mplcursors |
| 115 | +========== |
| 116 | +`mplcursors <https://mplcursors.readthedocs.io>`_ provides interactive data |
| 117 | +cursors for Matplotlib. |
105 | 118 |
|
106 | | -mpl-probscale |
| 119 | +MplDataCursor |
107 | 120 | ============= |
108 | | -`mpl-probscale <http://matplotlib.org/mpl-probscale/>`_ |
109 | | -is a small extension that allows matplotlib users to specify probabilty |
110 | | -scales. Simply importing the ``probscale`` module registers the scale |
111 | | -with matplotlib, making it accessible via e.g., |
112 | | -``ax.set_xscale('prob')`` or ``plt.yscale('prob')``. |
| 121 | +`MplDataCursor <https://github.com/joferkington/mpldatacursor>`_ is a toolkit |
| 122 | +written by Joe Kington to provide interactive "data cursors" (clickable |
| 123 | +annotation boxes) for Matplotlib. |
113 | 124 |
|
114 | | -.. image:: /_static/probscale_demo.png |
| 125 | +Miscellaneous |
| 126 | +************* |
| 127 | + |
| 128 | +adjustText |
| 129 | +========== |
| 130 | +`adjustText <https://github.com/Phlya/adjustText>`_ is a small library for |
| 131 | +automatically adjusting text position in Matplotlib plots to minimize overlaps |
| 132 | +between them, specified points and other objects. |
| 133 | + |
| 134 | +.. image:: /_static/adjustText.png |
115 | 135 |
|
116 | 136 | iTerm2 terminal backend |
117 | 137 | ======================= |
118 | | - |
119 | 138 | `matplotlib_iterm2 <https://github.com/oselivanov/matplotlib_iterm2>`_ is an |
120 | | -external matplotlib backend using iTerm2 nightly build inline image display |
| 139 | +external Matplotlib backend using the iTerm2 nightly build inline image display |
121 | 140 | feature. |
122 | 141 |
|
123 | 142 | .. image:: /_static/matplotlib_iterm2_demo.png |
124 | | - |
125 | | - |
126 | | -.. _toolkit_mpldatacursor: |
127 | | - |
128 | | -MplDataCursor |
129 | | -============= |
130 | | - |
131 | | -`MplDataCursor <https://github.com/joferkington/mpldatacursor>`_ is a |
132 | | -toolkit written by Joe Kington to provide interactive "data cursors" |
133 | | -(clickable annotation boxes) for matplotlib. |
134 | | - |
135 | | - |
136 | | -.. _toolkit_mplcursors: |
137 | | - |
138 | | -mplcursors |
139 | | -========== |
140 | | - |
141 | | -`mplcursors <https://mplcursors.readthedocs.io>`_ provides interactive |
142 | | -data cursors for matplotlib. |
143 | | - |
144 | | - |
145 | | -.. _toolkit_natgrid: |
146 | | - |
147 | | -Natgrid |
148 | | -======= |
149 | | - |
150 | | -mpl_toolkits.natgrid is an interface to natgrid C library for gridding |
151 | | -irregularly spaced data. This requires a separate installation of the |
152 | | -`natgrid toolkit <https://github.com/matplotlib/natgrid>`__. |
153 | | - |
154 | | - |
155 | | -.. _toolkit_matplotlibvenn: |
156 | | - |
157 | | -Matplotlib-Venn |
158 | | -=============== |
159 | | - |
160 | | -`Matplotlib-Venn <https://github.com/konstantint/matplotlib-venn>`_ provides a set of functions for plotting 2- and 3-set area-weighted (or unweighted) Venn diagrams. |
161 | | - |
162 | | -mplstereonet |
163 | | -=============== |
164 | | - |
165 | | -`mplstereonet <https://github.com/joferkington/mplstereonet>`_ provides stereonets for plotting and analyzing orientation data in Matplotlib. |
166 | | - |
167 | | -pyupset |
168 | | -=============== |
169 | | -`pyUpSet <https://github.com/ImSoErgodic/py-upset>`_ is a static Python implementation of the `UpSet suite by Lex et al. <http://www.caleydo.org/tools/upset/>`_ to explore complex intersections of sets and data frames. |
170 | | - |
171 | | -Windrose |
172 | | -=============== |
173 | | -`Windrose <https://github.com/scls19fr/windrose>`_ is a Python Matplotlib, Numpy library to manage wind data, draw windrose (also known as a polar rose plot), draw probability density function and fit Weibull distribution |
174 | | - |
175 | | -adjustText |
176 | | -=============== |
177 | | -`adjustText <https://github.com/Phlya/adjustText>`_ is a small library for automatically adjusting text position in matplotlib plots to minimize overlaps between them, specified points and other objects. |
178 | | - |
179 | | -.. image:: /_static/adjustText.png |
0 commit comments