Aug 26, 2020 · Aug 26, 2020 · Aug 26, 2020 · Aug 26, 2020
diff --git a/.flake8 b/.flake8
    examples/subplots_axes_and_figures/custom_figure_class.py: E402
    examples/subplots_axes_and_figures/demo_constrained_layout.py: E402
    examples/subplots_axes_and_figures/demo_tight_layout.py: E402
    examples/subplots_axes_and_figures/figure_size_units.py: E402
    examples/subplots_axes_and_figures/secondary_axis.py: E402
    examples/subplots_axes_and_figures/two_scales.py: E402
    examples/subplots_axes_and_figures/zoom_inset_axes.py: E402
diff --git a/examples/subplots_axes_and_figures/figure_size_units.py b/examples/subplots_axes_and_figures/figure_size_units.py
 """
 ==============================
 Figure size in different units
 ==============================

 The native figure size unit in Matplotlib is inches, deriving from print
 industry standards. However, users may need to specify their figures in other
 units like centimeters or pixels. This example illustrates how to do this
 efficiently.
 """

 # sphinx_gallery_thumbnail_number = 2

 import matplotlib.pyplot as plt
 text_kwargs = dict(ha='center', va='center', fontsize=28, color='C1')

 ##############################################################################
 # Figure size in inches (default)
 # -------------------------------
 #
 plt.subplots(figsize=(6, 2))
 plt.text(0.5, 0.5, '6 inches x 2 inches', **text_kwargs)
 plt.show()


 #############################################################################
 # Figure size in centimeter
 # -------------------------
 # Multiplying centimeter-based numbers with a conversion factor from cm to
 # inches, gives the right numbers. Naming the conversion factor ``cm`` makes
 # the conversion almost look like appending a unit to the number, which is
 # nicely readable.
 #
 cm = 1/2.54  # centimeters in inches
 plt.subplots(figsize=(15*cm, 5*cm))
 plt.text(0.5, 0.5, '15cm x 5cm', **text_kwargs)
 plt.show()


 #############################################################################
 # Figure size in pixel
 # --------------------
 # Similarly, one can use a conversion from pixels.
 #
 # Note that you could break this if you use `~.pyplot.savefig` with a
 # different explicit dpi value.
 #
 px = 1/plt.rcParams['figure.dpi']  # pixel in inches
 plt.subplots(figsize=(600*px, 200*px))
 plt.text(0.5, 0.5, '600px x 200px', **text_kwargs)
 plt.show()

 #############################################################################
 # Quick interactive work is usually rendered to the screen, making pixels a
 # good size of unit. But defining the conversion factor may feel a little
 # tedious for quick iterations.
 #
 # Because of the default ``rcParams['figure.dpi'] = 100``, one can mentally
 # divide the needed pixel value by 100 [*]_:
 #
 plt.subplots(figsize=(6, 2))
 plt.text(0.5, 0.5, '600px x 200px', **text_kwargs)
 plt.show()

 #############################################################################
 # .. [*] Unfortunately, this does not work well for the ``matplotlib inline``
 #        backend in jupyter because that backend uses a different default of
 #        ``rcParams['figure.dpi'] = 72``. Additionally, it saves the figure
 #        with ``bbox_inches='tight'``, which crops the figure and makes the
 #        actual size unpredictable.

 #############################################################################
 #
 # ------------
 #
 # References
 # """"""""""
 #
 # The use of the following functions and methods is shown in this example:

 import matplotlib

 matplotlib.pyplot.figure
 matplotlib.pyplot.subplots
 matplotlib.pyplot.subplot_mosaic
Original file line number	Diff line number	Diff line change
Expand Up		@@ -249,6 +249,7 @@ per-file-ignores =
		examples/subplots_axes_and_figures/custom_figure_class.py: E402
		examples/subplots_axes_and_figures/demo_constrained_layout.py: E402
		examples/subplots_axes_and_figures/demo_tight_layout.py: E402
		examples/subplots_axes_and_figures/figure_size_units.py: E402
		examples/subplots_axes_and_figures/secondary_axis.py: E402
		examples/subplots_axes_and_figures/two_scales.py: E402
		examples/subplots_axes_and_figures/zoom_inset_axes.py: E402
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,85 @@
		"""
		==============================
		Figure size in different units
		==============================

		The native figure size unit in Matplotlib is inches, deriving from print
		industry standards. However, users may need to specify their figures in other
		units like centimeters or pixels. This example illustrates how to do this
		efficiently.
		"""

		# sphinx_gallery_thumbnail_number = 2

		import matplotlib.pyplot as plt
		text_kwargs = dict(ha='center', va='center', fontsize=28, color='C1')

		##############################################################################
		# Figure size in inches (default)
		# -------------------------------
		#
		plt.subplots(figsize=(6, 2))
		plt.text(0.5, 0.5, '6 inches x 2 inches', **text_kwargs)
		plt.show()


		#############################################################################
		# Figure size in centimeter
		# -------------------------
		# Multiplying centimeter-based numbers with a conversion factor from cm to
		# inches, gives the right numbers. Naming the conversion factor ``cm`` makes
		# the conversion almost look like appending a unit to the number, which is
		# nicely readable.
		#
		cm = 1/2.54 # centimeters in inches
		plt.subplots(figsize=(15cm, 5cm))
		plt.text(0.5, 0.5, '15cm x 5cm', **text_kwargs)
		plt.show()


		#############################################################################
		# Figure size in pixel
		# --------------------
		# Similarly, one can use a conversion from pixels.
		#
timhoffm marked this conversation as resolved. Show resolvedHide resolved
		# Note that you could break this if you use `~.pyplot.savefig` with a
		# different explicit dpi value.
		#
		px = 1/plt.rcParams['figure.dpi'] # pixel in inches
		plt.subplots(figsize=(600px, 200px))
		plt.text(0.5, 0.5, '600px x 200px', **text_kwargs)
		plt.show()

		#############################################################################
		# Quick interactive work is usually rendered to the screen, making pixels a
		# good size of unit. But defining the conversion factor may feel a little
		# tedious for quick iterations.
		#
		# Because of the default ``rcParams['figure.dpi'] = 100``, one can mentally
		# divide the needed pixel value by 100 [*]_:
		#
		plt.subplots(figsize=(6, 2))
		plt.text(0.5, 0.5, '600px x 200px', **text_kwargs)
		plt.show()

		#############################################################################
		# .. [*] Unfortunately, this does not work well for the ``matplotlib inline``
		# backend in jupyter because that backend uses a different default of
		# ``rcParams['figure.dpi'] = 72``. Additionally, it saves the figure
		# with ``bbox_inches='tight'``, which crops the figure and makes the
		# actual size unpredictable.

		#############################################################################
		#
		# ------------
		#
		# References
		# """"""""""
		#
		# The use of the following functions and methods is shown in this example:

		import matplotlib
timhoffm marked this conversation as resolved. Show resolvedHide resolved

		matplotlib.pyplot.figure
		matplotlib.pyplot.subplots
		matplotlib.pyplot.subplot_mosaic
Copy link Member jklymakAug 26, 2020 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Not used? Copy link Member tacaswellAug 26, 2020 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. This is to trigger theback links which I think is useful here (as these are the entry points where we want people to use to set the figure size)? timhoffm reacted with thumbs up emoji