From 2e2ead55f0ed52fb72b83ecaac7940d67cac2b3f Mon Sep 17 00:00:00 2001 From: "James A. Bednar" Date: Wed, 9 Mar 2016 14:51:33 -0600 Subject: [PATCH] Fixed outdated link to thirdpartypackages, and simplified the organization of that page. --- doc/_templates/index.html | 4 +- doc/thirdpartypackages/index.rst | 132 ++++++++++++++++--------------- 2 files changed, 70 insertions(+), 66 deletions(-) diff --git a/doc/_templates/index.html b/doc/_templates/index.html index 1c97a870c329..01ab18077e98 100644 --- a/doc/_templates/index.html +++ b/doc/_templates/index.html @@ -166,8 +166,8 @@

Toolkits

Third party packages

-

A large number of third party packages - extend and build on Matplotlib functionality. This includes several higher-level plotting interfaces; +

A large number of third party packages + extend and build on Matplotlib functionality, including several higher-level plotting interfaces seaborn, holoviews, ggplot, and diff --git a/doc/thirdpartypackages/index.rst b/doc/thirdpartypackages/index.rst index 3a29969ff065..2ed61767f316 100644 --- a/doc/thirdpartypackages/index.rst +++ b/doc/thirdpartypackages/index.rst @@ -5,57 +5,22 @@ ********************* Several external packages that extend or build on Matplotlib functionality -exist. Below we list a number of these. Please submit an issue or pull request +exist. Below we list a number of these. Note that they are each +maintained and distributed separately from Matplotlib, and will need +to be installed individually. + +Please submit an issue or pull request on Github if you have created a package that you would like to have included. We are also happy to host third party packages within the `Matplotlib Github Organization `_. -.. _toolkits-general: - -General Toolkits -**************** - - -.. _toolkit_mpldatacursor: - -MplDataCursor -============= - -`MplDataCursor `_ is a -toolkit written by Joe Kington to provide interactive "data cursors" -(clickable annotation boxes) for matplotlib. - - -.. _toolkit_natgrid: - -Natgrid -======= - -mpl_toolkits.natgrid is an interface to natgrid C library for gridding -irregularly spaced data. This requires a separate installation of the -`natgrid toolkit `__. - - -.. _toolkit_matplotlibvenn: - -Matplotlib-Venn -=============== - -`Matplotlib-Venn `_ provides a set of functions for plotting 2- and 3-set area-weighted (or unweighted) Venn diagrams. - -mplstereonet -=============== - -`mplstereonet `_ provides stereonets for plotting and analyzing orientation data in Matplotlib. - - .. _hl_plotting: High-Level Plotting ******************* -Several projects have started to provide a higher-level interface to -matplotlib. These are independent projects. +Several projects provide higher-level interfaces for creating +matplotlib plots. .. _toolkit_seaborn: @@ -75,7 +40,7 @@ understanding complex datasets. ggplot ====== -`ggplot `_ is a port of the R ggplot2 +`ggplot `_ is a port of the R ggplot2 package to python based on matplotlib. .. image:: /_static/ggplot.png @@ -86,7 +51,6 @@ to python based on matplotlib. holoviews ========= - `holoviews `_ makes it easier to visualize data interactively, especially in a `Jupyter notebook `_, by providing a set of declarative @@ -98,6 +62,47 @@ parameter exploration. .. image:: /_static/holoviews.png :height: 354px + +.. _toolkits-mapping: + +Mapping Toolkits +**************** + +Two independent mapping toolkits are available. + +.. _toolkit_basemap: + +Basemap +======= + +Plots data on map projections, with continental and political +boundaries. See `basemap `_ +docs. + +.. image:: /_static/basemap_contour1.png + :height: 400px + + + +Cartopy +======= +`Cartopy `_ builds on top of +matplotlib to provide object oriented map projection definitions and close +integration with Shapely for powerful yet easy-to-use vector data processing +tools. An example plot from the +`Cartopy gallery `_: + +.. image:: /_static/cartopy_hurricane_katrina_01_00.png + :height: 400px + + +.. _toolkits-misc: +.. _toolkits-general: + +Miscellaneous Toolkits +********************** + + .. _toolkit_prettyplotlib: prettyplotlib @@ -129,35 +134,34 @@ feature. .. image:: /_static/matplotlib_iterm2_demo.png -.. _toolkits-mapping: +.. _toolkit_mpldatacursor: -Mapping Toolkits -**************** +MplDataCursor +============= + +`MplDataCursor `_ is a +toolkit written by Joe Kington to provide interactive "data cursors" +(clickable annotation boxes) for matplotlib. -.. _toolkit_basemap: +.. _toolkit_natgrid: -Basemap +Natgrid ======= -Plots data on map projections, with continental and political -boundaries, see `basemap `_ -docs. +mpl_toolkits.natgrid is an interface to natgrid C library for gridding +irregularly spaced data. This requires a separate installation of the +`natgrid toolkit `__. -.. image:: /_static/basemap_contour1.png - :height: 400px +.. _toolkit_matplotlibvenn: +Matplotlib-Venn +=============== -Cartopy -======= +`Matplotlib-Venn `_ provides a set of functions for plotting 2- and 3-set area-weighted (or unweighted) Venn diagrams. -An alternative mapping library written for matplotlib ``v1.2`` and beyond. -`Cartopy `_ builds on top of -matplotlib to provide object oriented map projection definitions and close -integration with Shapely for powerful yet easy-to-use vector data processing -tools. An example plot from the -`Cartopy gallery `_: +mplstereonet +=============== -.. image:: /_static/cartopy_hurricane_katrina_01_00.png - :height: 400px +`mplstereonet `_ provides stereonets for plotting and analyzing orientation data in Matplotlib.