Skip to content

Commit 4d9738f

Browse files
phobsonphobson
authored
Merge pull request #8538 from anntzer/thirdparty
Update doc/thirdpartypackages/index.rst
2 parents 5ea88ad + 091cac0 commit 4d9738f

File tree

1 file changed

+93
-130
lines changed

1 file changed

+93
-130
lines changed

‎doc/thirdpartypackages/index.rst

Lines changed: 93 additions & 130 deletions
Original file line numberDiff line numberDiff line change
@@ -1,179 +1,142 @@
11
.. _thirdparty-index:
22

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+
********************
116

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.
1610

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>`_.
1815

19-
High-Level Plotting
20-
*******************
16+
Mapping toolkits
17+
****************
2118

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.
2423

25-
.. _toolkit_seaborn:
24+
.. image:: /_static/basemap_contour1.png
25+
:height: 400px
2626

27-
seaborn
27+
Cartopy
2828
=======
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>`_:
2934

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
3637

37-
.. _toolkit_ggplot:
38+
Declarative libraries
39+
*********************
3840

3941
ggplot
4042
======
41-
4243
`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.
4445

4546
.. image:: /_static/ggplot.png
4647
:height: 195px
4748

48-
.. _toolkit_holoviews:
49-
5049
holoviews
5150
=========
52-
5351
`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.
6057

6158
.. image:: /_static/holoviews.png
6259
:height: 354px
6360

61+
Specialty plots
62+
***************
6463

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.
6669

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')``.
6976

70-
Two independent mapping toolkits are available.
77+
.. image:: /_static/probscale_demo.png
7178

72-
.. _toolkit_basemap:
79+
mplstereonet
80+
============
81+
`mplstereonet <https://github.com/joferkington/mplstereonet>`_ provides
82+
stereonets for plotting and analyzing orientation data in Matplotlib.
7383

74-
Basemap
84+
Natgrid
7585
=======
86+
`mpl_toolkits.natgrid <https://github.com/matplotlib/natgrid>`_ is an interface
87+
to the natgrid C library for gridding irregularly spaced data.
7688

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
8790
=======
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.
9395

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.
96101

102+
.. image:: /_static/seaborn.png
103+
:height: 157px
97104

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.
100110

101-
Miscellaneous Toolkits
102-
**********************
111+
Interactivity
112+
*************
103113

104-
.. _toolkit_probscale:
114+
mplcursors
115+
==========
116+
`mplcursors <https://mplcursors.readthedocs.io>`_ provides interactive data
117+
cursors for Matplotlib.
105118

106-
mpl-probscale
119+
MplDataCursor
107120
=============
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.
113124

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
115135

116136
iTerm2 terminal backend
117137
=======================
118-
119138
`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
121140
feature.
122141

123142
.. 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

Comments
 (0)