11:orphan:
22
3- .. title :: Matplotlib: Python plotting
3+ .. title :: Matplotlib Documentation
44
55.. module :: matplotlib
66
7- Matplotlib: Visualization with Python
8- -------------------------------------
7+ Matplotlib Documentation
8+ ------------------------
99
1010Matplotlib is a comprehensive library for creating static, animated,
1111and interactive visualizations in Python.
1212
13- .. raw :: html
14-
15- <div class =" responsive_screenshots"
16- <a href =" tutorials/introductory/sample_plots.html"
17- <div class =" responsive_subfig"
18- <img align =" middle" src =" _images/sphx_glr_membrane_thumb.png"
19- border =" 0" alt =" screenshots"
20- </div >
21- <div class =" responsive_subfig"
22- <img align =" middle" src =" _images/sphx_glr_histogram_thumb.png"
23- border =" 0" alt =" screenshots"
24- </div >
25- <div class =" responsive_subfig"
26- <img align =" middle" src =" _images/sphx_glr_contour_thumb.png"
27- border =" 0" alt =" screenshots"
28- </div >
29- <div class =" responsive_subfig"
30- <img align =" middle" src =" _images/sphx_glr_3D_thumb.png"
31- border =" 0" alt =" screenshots"
32- </div >
33- </a >
34- </div >
35- <span class =" clear_screenshots" span >
36-
3713Matplotlib makes easy things easy and hard things possible.
3814
3915.. container :: bullet-box-container
4016
4117 .. container :: bullet-box
4218
43- Create
44-
45- - Develop `publication quality plots `_ with just a few lines of code
46- - Use `interactive figures `_ that can zoom, pan, update...
47-
48- .. _publication quality plots : https://matplotlib.org/gallery/index.html
49- .. _interactive figures : https://matplotlib.org/gallery/index.html#event-handling
50-
19+ Learn
20+
21+ - :doc: `Quick-start Guide <tutorials/introductory/usage >`
22+ - Basic :doc: `Plot Types <plot_types/index >` and :doc: `Example Gallery <gallery/index >`
23+ - `Introductory Tutorials <tutorials/introductory/> `
24+
5125 .. container :: bullet-box
5226
53- Customize
27+ Understand
5428
5529 - `Take full control `_ of line styles, font properties, axes properties...
5630 - `Export and embed `_ to a number of file formats and interactive environments
5731
5832 .. _Take full control : https://matplotlib.org/tutorials/index.html#tutorials
5933 .. _Export and embed : https://matplotlib.org/api/index_backend_api.html
6034
35+ .. container :: bullet-box-container
36+
6137 .. container :: bullet-box
6238
63- Extend
39+ How-tos
6440
6541 - Explore tailored functionality provided by
6642 `third party packages <https://matplotlib.org/mpl-third-party/ >`_
6743 - Learn more about Matplotlib through the many
6844 :doc: `external learning resources <resources/index >`
6945
46+ .. container :: bullet-box
47+
48+ Reference
49+
50+
7051Documentation
7152~~~~~~~~~~~~~
7253
@@ -76,81 +57,6 @@ Trying to learn how to do a particular kind of plot? Check out the
7657:doc: `examples gallery <gallery/index >` or the :doc: `list of plotting commands
7758<api/pyplot_summary>`.
7859
79- Join our community!
80- ~~~~~~~~~~~~~~~~~~~
81-
82- Matplotlib is a welcoming, inclusive project, and everyone within the community
83- is expected to abide by our `code of conduct
84- <https://github.com/matplotlib/matplotlib/blob/master/CODE_OF_CONDUCT.md> `_.
85-
86-
87- .. raw :: html
88-
89- <h3 >Get help</h3 >
90- <div class =" box"
91- <div class =" box-item"
92- <img src =" _static/fa/discourse-brands.svg" alt =" Discourse"
93- <p >Join our community at <a href =" https://discourse.matplotlib.org" a >
94- to get help, discuss contributing & ; development, and share your work.</p >
95- </div >
96- <div class =" box-item"
97- <img src =" _static/fa/question-circle-regular.svg" alt =" Questions"
98- <p >If you have questions, be sure to check the <a href =" faq/index.html" a >,
99- the <a href =" api/index.html" a > docs. The full text
100- <a href =" search.html" a > is a good way to discover the docs including the many examples.</p >
101- </div >
102- <div class =" box-item"
103- <img src =" _static/fa/stack-overflow-brands.svg" alt =" Stackoverflow"
104- <p >Check out the Matplotlib tag on <a href =" https://stackoverflow.com/questions/tagged/matplotlib" a >.</p >
105- </div >
106- <div class =" box-item"
107- <img src =" _static/fa/gitter-brands.svg" alt =" Gitter"
108- <p >Short questions may be posted on the <a href =" https://gitter.im/matplotlib/matplotlib" a >.</p >
109- </div >
110- </div >
111- <hr class =' box-sep'
112- <h3 >News</h3 >
113- <div class =" box"
114- <div class =" box-item"
115- <img src =" _static/fa/plus-square-regular.svg" alt =" News"
116- <p >To keep up to date with what's going on in Matplotlib, see the
117- <a href =" users/whats_new.html" a > page or browse the
118- <a href =" https://github.com/matplotlib/matplotlib" a >. Anything that could
119- require changes to your existing code is logged in the
120- <a href =" api/api_changes.html" a > file.</p >
121- </div >
122- <div class =" box-item"
123- <img src =" _static/fa/hashtag-solid.svg" alt =" Social media"
124- <ul >
125- <li >Tweet us at <a href =" https://twitter.com/matplotlib" a >!</li >
126- <li >See cool plots on <a href =" https://www.instagram.com/matplotart/" a > Instagram!</li >
127- <li >Check out our <a href =" https://matplotlib.org/matplotblog/" a >!</li >
128- </ul >
129- </div >
130- </div >
131- <hr class =' box-sep'
132- <h3 >Development</h3 >
133- <div class =" box"
134- <div class =" box-item"
135- <img src =" _static/fa/github-brands.svg" alt =" Github"
136- <p >Matplotlib is hosted on <a href =" https://github.com/matplotlib/matplotlib" a >.</p >
137- <ul >
138- <li >File bugs and feature requests on the <a href =" https://github.com/matplotlib/matplotlib/issues" a >.</li >
139- <li ><a href =" https://github.com/matplotlib/matplotlib/pulls" a > are always welcome.</li >
140- </ul >
141- <p >It is a good idea to ping us on <a href =" https://discourse.matplotlib.org" a > as well.</p >
142- </div >
143- <div class =" box-item"
144- <img src =" _static/fa/envelope-regular.svg" alt =" Mailing lists"
145- <p >Mailing lists</p >
146- <ul >
147- <li ><a href =" https://mail.python.org/mailman/listinfo/matplotlib-users" a > for usage questions</li >
148- <li ><a href =" https://mail.python.org/mailman/listinfo/matplotlib-devel" a > for development</li >
149- <li ><a href =" https://mail.python.org/mailman/listinfo/matplotlib-announce" a > for project announcements</li >
150- </ul >
151- </div >
152- </div >
153-
15460
15561Toolkits
15662========
@@ -159,19 +65,6 @@ Matplotlib ships with several add-on :doc:`toolkits <api/toolkits/index>`,
15965including 3D plotting with `.mplot3d `, axes helpers in `.axes_grid1 ` and axis
16066helpers in `.axisartist `.
16167
162- Third party packages
163- ====================
164-
165- A large number of
166- `third party packages <https://matplotlib.org/mpl-third-party/ >`_
167- extend and build on Matplotlib functionality, including several higher-level
168- plotting interfaces (seaborn _, HoloViews _, ggplot _, ...), and a projection
169- and mapping toolkit (Cartopy _).
170-
171- .. _seaborn : https://seaborn.pydata.org
172- .. _HoloViews : https://holoviews.org
173- .. _ggplot : https://yhat.github.io/ggpy/
174- .. _Cartopy : https://scitools.org.uk/cartopy/docs/latest/
17568
17669Citing Matplotlib
17770=================
@@ -184,41 +77,3 @@ If Matplotlib contributes to a project that leads to a scientific publication,
18477please acknowledge this work by citing the project. A :doc: `ready-made citation
18578entry <citing>` is available.
18679
187- Open source
188- ===========
189-
190- .. raw :: html
191-
192- <a href =" https://numfocus.org/"
193- <img src =" _static/numfocus_badge.png"
194- alt =" A Fiscally Sponsored Project of NUMFocus"
195- style =" float right ; margin-left 20px "
196- </a >
197-
198-
199- Matplotlib is a Sponsored Project of NumFOCUS, a 501(c)(3) nonprofit
200- charity in the United States. NumFOCUS provides Matplotlib with
201- fiscal, legal, and administrative support to help ensure the health
202- and sustainability of the project. Visit `numfocus.org <nf _>`_ for more
203- information.
204-
205- Donations to Matplotlib are managed by NumFOCUS. For donors in the
206- United States, your gift is tax-deductible to the extent provided by
207- law. As with any donation, you should consult with your tax adviser
208- about your particular tax situation.
209-
210- Please consider `donating to the Matplotlib project <donating _>`_ through
211- the NumFOCUS organization or to the `John Hunter Technology Fellowship
212- <jdh-fellowship_> `_.
213-
214- .. _donating : https://numfocus.org/donate-to-matplotlib
215- .. _jdh-fellowship : https://numfocus.org/programs/john-hunter-technology-fellowship/
216- .. _nf : https://numfocus.org
217-
218- The :doc: `Matplotlib license <users/license >` is based on the `Python Software
219- Foundation (PSF) license <psf-license_> `_.
220-
221- .. _psf-license : https://docs.python.org/3/license.html
222-
223- There is an active developer community and a long list of people who have made
224- significant :doc: `contributions <users/credits >`.
0 commit comments