Dec 9, 2024
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
 """
 `matplotlib.figure` implements the following classes:

        """
        self.set_size_inches(self.get_figwidth(), val, forward=forward)

    def set_figratio(self, width=None, height=None, aspect=None, forward=True):
        """
        Set the height of the figure in inches.

        Parameters
        ----------
        height : float
        width : float
        aspect: float
        forward : bool
            See `set_size_inches`.

        See Also
        --------
        matplotlib.figure.Figure.set_figwidth
        matplotlib.figure.Figure.set_figheight
        matplotlib.figure.Figure.set_size_inches
        """
        if height and width:
            self.set_size_inches(width, height, forward=forward)
        elif aspect:
            if height:
                self.set_size_inches(
                    self.get_figwidth()*aspect, height, forward=forward
                )
            elif width:
                self.set_size_inches(
                    width, self.get_figheight()*aspect, forward=forward
                )
            else:
                self.set_size_inches(
                    self.get_figwidth()*aspect,
                    self.get_figheight()*aspect,
                    forward=forward
                )
        else:
            raise ValueError("No value passed for aspect")

    def clear(self, keep_observers=False):
        # docstring inherited
        super().clear(keep_observers=keep_observers)
diff --git a/lib/matplotlib/tests/test_figure.py b/lib/matplotlib/tests/test_figure.py
    assert fig.get_figheight() == 3


 def test_set_fig_ratio():
    # defining plt fig
    fig = plt.figure()

    # setting width and height individually
    fig.set_figwidth(5)
    fig.set_figheight(1)

    # setting width and height with figratio
    fig.set_figratio(2, 4)
    assert fig.get_figwidth() == 2
    assert fig.get_figheight() == 4

    # setting width with value and height with aspect
    fig.set_figratio(width=3, aspect=2)
    assert fig.get_figwidth() == 3
    assert fig.get_figheight() == 8

    # setting height with value and width with aspect
    fig.set_figratio(height=3, aspect=2)
    assert fig.get_figwidth() == 6
    assert fig.get_figheight() == 3

    # upsizing width and height with an aspect of 4
    fig.set_figratio(aspect=4)
    assert fig.get_figwidth() == 24
    assert fig.get_figheight() == 12

    # error checking for when only width is passed in
    try:
        fig.set_figratio(width=4)
    except ValueError:
        assert fig.get_figwidth() == 24
        assert fig.get_figheight() == 12

    # error checking for when only height is passed in
    try:
        fig.set_figratio(height=4)
    except ValueError:
        assert fig.get_figwidth() == 24
        assert fig.get_figheight() == 12


 def test_axes_remove():
    fig, axs = plt.subplots(2, 2)
    axs[-1, -1].remove()
Original file line number	Diff line number	Diff line change
		@@ -1,3 +1,3 @@
		"""
		`matplotlib.figure` implements the following classes:

Expand DownExpand Up		@@ -3220,6 +3220,44 @@
		"""
		self.set_size_inches(self.get_figwidth(), val, forward=forward)

		def set_figratio(self, width=None, height=None, aspect=None, forward=True):
		"""
		Set the height of the figure in inches.

		Parameters
		----------
		height : float
		width : float
		aspect: float
		forward : bool
		See `set_size_inches`.

		See Also
		--------
		matplotlib.figure.Figure.set_figwidth
		matplotlib.figure.Figure.set_figheight
		matplotlib.figure.Figure.set_size_inches
		"""
		if height and width:
		self.set_size_inches(width, height, forward=forward)
		elif aspect:
		if height:
		self.set_size_inches(
		self.get_figwidth()*aspect, height, forward=forward
		)
		elif width:
		self.set_size_inches(
		width, self.get_figheight()*aspect, forward=forward
		)
		else:
		self.set_size_inches(
		self.get_figwidth()*aspect,
		self.get_figheight()*aspect,
		forward=forward
		)
		else:
		raise ValueError("No value passed for aspect")

		def clear(self, keep_observers=False):
		# docstring inherited
		super().clear(keep_observers=keep_observers)
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -436,6 +436,49 @@ def test_set_fig_size():
		assert fig.get_figheight() == 3


		def test_set_fig_ratio():
		# defining plt fig
		fig = plt.figure()

		# setting width and height individually
		fig.set_figwidth(5)
		fig.set_figheight(1)

		# setting width and height with figratio
		fig.set_figratio(2, 4)
		assert fig.get_figwidth() == 2
		assert fig.get_figheight() == 4

		# setting width with value and height with aspect
		fig.set_figratio(width=3, aspect=2)
		assert fig.get_figwidth() == 3
		assert fig.get_figheight() == 8

		# setting height with value and width with aspect
		fig.set_figratio(height=3, aspect=2)
		assert fig.get_figwidth() == 6
		assert fig.get_figheight() == 3

		# upsizing width and height with an aspect of 4
		fig.set_figratio(aspect=4)
		assert fig.get_figwidth() == 24
		assert fig.get_figheight() == 12

		# error checking for when only width is passed in
		try:
		fig.set_figratio(width=4)
		except ValueError:
		assert fig.get_figwidth() == 24
		assert fig.get_figheight() == 12

		# error checking for when only height is passed in
		try:
		fig.set_figratio(height=4)
		except ValueError:
		assert fig.get_figwidth() == 24
		assert fig.get_figheight() == 12


		def test_axes_remove():
		fig, axs = plt.subplots(2, 2)
		axs[-1, -1].remove()
Expand Down