Skip to content

DOC: some minor fixes to the usage rewrite #21794

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dstansby merged 3 commits into from
Nov 29, 2021
Merged

DOC: some minor fixes to the usage rewrite #21794

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
fd83646
DOC: some minor fixes to the usage rewrite
jklymak Nov 29, 2021
94d2fd5
DOC: add show to each example
jklymak Nov 29, 2021
26fc6a1
DOC: suppress extra prints
jklymak Nov 29, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
DOC: some minor fixes to the usage rewrite
  • Loading branch information
@jklymak
jklymak committed Nov 29, 2021
commit fd83646e31abadc2809514ab9ece92b647725472
24 changes: 12 additions & 12 deletions tutorials/introductory/usage.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,7 @@
#
# Coding styles
# =============

#
# The object-oriented and the pyplot interfaces
# ---------------------------------------------
#
Expand Down Expand Up @@ -172,8 +172,8 @@
###############################################################################
# (In addition, there is a third approach, for the case when embedding
# Matplotlib in a GUI application, which completely drops pyplot, even for
# figure creation. See the corresponding section in the gallery for more info
# (:ref:`user_interfaces`).)
# figure creation. See the corresponding section in the gallery for more info:
# :ref:`user_interfaces`.)
#
# Matplotlib's documentation and examples use both the OO and the pyplot
# styles. In general, we suggest using the OO style, particularly for
Expand Down Expand Up @@ -211,8 +211,6 @@ def my_plotter(ax, data1, data2, param_dict):
my_plotter(ax2, data3, data4, {'marker': 'o'})

###############################################################################
# These examples provide convenience for more complex graphs.
#
# Note that if you want to install these as a python package, or any other
# customizations you could use use one of the many templates on the web;
# Matplotlib has one at `mpl-cookiecutter
Expand Down Expand Up @@ -260,8 +258,8 @@ def my_plotter(ax, data1, data2, param_dict):
# Marker size depends on the method being used. `~.Axes.plot` specifies
# markersize in points, and is generally the "diameter" or width of the
# marker. `~.Axes.scatter` specifies markersize as approximately
# proportional to the visual area of the marker. There are also an array of
# markerstyles available as string codes (see :mod:`~.matplotlib.markers`) or
# proportional to the visual area of the marker. There is an array of
# markerstyles available as string codes (see :mod:`~.matplotlib.markers`), or
# users can define their own `~.MarkerStyle` (see
# :doc:`/gallery/lines_bars_and_markers/marker_reference`):

Expand All @@ -280,7 +278,7 @@ def my_plotter(ax, data1, data2, param_dict):
# Axes labels and text
# --------------------
#
# `~.Axes.set_xlabel`, `~.Axes.set_ylabel` and `~.Axes.set_title` are used to
# `~.Axes.set_xlabel`, `~.Axes.set_ylabel`, and `~.Axes.set_title` are used to
# add text in the indicated locations (see :doc:`/tutorials/text/text_intro` for
# more discussion). Text can also be directly added to plots using
# `~.Axes.text`:
Expand Down Expand Up @@ -421,7 +419,7 @@ def my_plotter(ax, data1, data2, param_dict):
# Plotting dates and strings
# --------------------------
#
# Matplotlib can handle plotting arrays of dates and arrays of strings as
# Matplotlib can handle plotting arrays of dates and arrays of strings, as
# well as floating point numbers. These get special locators and formatters
# as appropriate. For dates:

Expand All @@ -446,8 +444,8 @@ def my_plotter(ax, data1, data2, param_dict):
##############################################################################
# One caveat about categorical plotting is that some methods of parsing
# text files return a list of strings, even if the strings all represent
# numbers or dates. If you pass 1000 strings Matplotlib will think you
# meant 1000 categories and will add 1000 ticks to your plot.
# numbers or dates. If you pass 1000 strings, Matplotlib will think you
# meant 1000 categories and will add 1000 ticks to your plot!
#
# Color mapped data
# =================
Expand Down Expand Up @@ -507,7 +505,9 @@ def my_plotter(ax, data1, data2, param_dict):
# :doc:`/gallery/subplots_axes_and_figures/colorbar_placement` for
# details. You can also change the appearance of colorbars with the
# *extend* keyword to add arrows to the ends, and *shrink* and *aspect* to
# control the size.
# control the size. Finally, the colorbar will have default Locators
# and Formatters appropriate to the Norm. These can be changed as for
# other axis objects.
#
#
# Working with multiple figures and axes
Expand Down