There was some discussion at #25511 about if and when subfigures should respect the gridspec's white space settings.

It is true that spacing/padding is ignored when computing the position in add_subfigure when given a subplot spec.

The code for this is here, where we recompute sizes of boxes based only on height/width ratios:

Replacing this with:

bbox = self._subplotspec.get_position(self)
self.bbox_relative.p0 = bbox.p0
self.bbox_relative.p1 = bbox.p1

Resolves to the expected behavior of this issue, though does cause ~6 test failures (though actually mostly relatively minor, to be honest... some slight tweaking to text/colorbar positions, though some more distinct differences as well).

I suspect that the reason for ignoring the padding has to do with the idea that a subfigure has its own internal padding usually, and so not having the padding may in many cases make the subfigures look better by default (perhaps especially when juxtaposed with non-subfigure subplots?)

That said, using Figure.subfigures actually does allow adding hspace/wspace (but not left/right/top/bottom, actually), and is respected, so perhaps it makes sense make the two more consistent?

I will tag in @jklymak and @anntzer to provide opinions here (as original author and the one who rewrote the code linked above, respectively)

If we decide to change behavior, the technical solution is pretty easy, though may need to either replace test files or adjust test code to get the reproduce the old figures (e.g. by explicitly setting hspace/wspace to 0).

Xrefs:

• Proposal: add_subfigs.... #17375 (original issue requesting subfigures)
• ENH: Subfigures #18356 (original implementation)
• Simplify _redo_transform_rel_fig. #20023 (rewrite of code above)

I do not see specific conversation in these threads as to whether to account for padding or not.

The original subfigures was not meant to account for paddings in a GridSpec. #25960 added keywords for subfigures, but does not look at the GridSpec.

1. subfigures are meant to be mixed with subplots. Almost certainly the padding around a single subfigure in an array of subplots will need to be different than the subplots spacing.

2. subfigure padding should almost certainly not be the default subplot padding as the layout needs are not the same.

Overall I think the current API is probably the correct one (ignore GridSpec, and control with keyword arguments). As stated before, users should not typically be creating gridspecs themselves.

The above can be accomplished with

subfigs = main.subfigures(2, 4, wspace=0.15, hspace=0.15)

The only thing I'd add is I wouldn't objects if we wanted to add bottom, top etc to fig.subfigures.

It certainly would be good to have options like top, etc., to fig.subfigures. Using that method, I have an example that is a little more specific to what I am intending to do.

import matplotlib.pyplot as plt
import numpy as np

dpi = 100
width = 600
height = 600

main = plt.figure(figsize=(width / dpi, height / dpi), dpi=100,
                             facecolor='#000000', frameon=False)

colors = np.array([
    ['red', 'black', 'green', 'blue'],
    ['brown', 'gray', 'white', 'gold']
])

sf = main.subfigures(2, 4)

for row in range(2):
    for col in range(4):
        sf[row, col].set_facecolor(colors[row, col])
        sf[row, col].add_subplot(xticks=[], yticks=[])

plt.show()

The idea is that I can highlight an axes based on some other information with the facecolor of the subfigure. Being able to define the extent in figure.subfigures would help with making room for other things like text, etc.