What’s New

v2026.07.0 (2026-07-03)

Removed workaround for matplotlib colorbar padding issue with cbar_mode equal to "single" and cbar_location equal to "left" or "bottom" for matplotlib versions greater than or equal to 3.10.0, since it was fixed upstream in matplotlib#28525.

Defaults for the width, height, and aspect are now chosen if fewer than two of those are specified in faceted.faceted(). This restores the old defaults from version 0.1 without changing the function signature introduced to provide an interface to more varieties of constrained figures in version 0.2. E.g. calls like faceted(1, 1) or faceted(1, 1, width=5.0) are now allowed again.

faceted.faceted() now supports three types of constrained figures: width-and-aspect constrained (as before), height-and-aspect constrained, and width-and-height constrained. Note the you must provide exactly two of the width, height, and aspect arguments in your call. A minor breaking change is that defaults are no longer provided for width and aspect (it would be cumbersome to have to override one of them with None in the case of creating a height-and-aspect constrained or width-and-height constrained figure).
A new convenience function for creating single-axis figures called faceted.faceted_ax(). It takes the same keyword arguments as the full faceted.faceted() function, except automatically returns scalar Axes objects.

Initial release. Note the name has changed since the development version from facets to faceted.
Default cbar_short_side_pad is now 0.0 instead of 0.5 inches.