What’s new?

The following lists past and future (where dates are replaced with ##) changes to ProPlot. Authors are shown next to each change. Where not indicated, Luke Davis was the author.

See the author page for a list of contributors, and see the contribution guide if you are interested in submitting your own changes.

ProPlot v1.0.0 (2022-##-##)

This will be published when some major refactoring tasks are completed, and deprecation warnings will be removed. See GH#89, GH#109, GH#110, and GH#111.

ProPlot v0.8.0 (2021-##-##)


  • Deprecate format functions in favor of the axes-artist set override (GH#89).


  • All format features are now implemented with individual setters, like in matplotlib, but we still encourage using the bulk set method through documentation examples and by populating the set docstring (so valid arguments are no longer implicit).

  • Users can now use figure with add_subplot as an alternative to the recommended subplots workflow (GH#110). This is a major improvement!

  • GridSpec now accepts physical units, rather than having subplots handle the units (GH#110).

  • Allow “hanging” twin x and y axes as members of the EdgeStack container. Arbitrarily many siblings are now permitted.

  • Use GeometrySolver for calculating various automatic layout stuff instead of having 1000 hidden Figure methods (GH#110).

  • Use EdgeStack class for handling stacks of colorbars, legends, and text (GH#110).


  • Add comprehensive unit tests and migrate from Travis CI to Github Actions.

  • Validate assignments to RcConfigurator and turn the configurator into a monkey patch of rcParams (GH#109).

  • Implement and document plotting wrappers (e.g. standardize_1d) on the individual methods themselves (e.g. plot; GH#111). This is much easier for users.

  • Handle all projection keyword arguments in add_subplot instead of subplots (GH#110).

  • Panels, colorbars, and legends are now members of EdgeStack stacks rather than getting inserted directly into the main GridSpec (GH#110).

ProPlot v0.7.0 (2021-07-11)


  • Remove v0.6.0 renamed classes (e.g. ProjAxes) from top-level namespace (@442e6aa6). These were kept available just for documentation. The renamed functions shade, saturate, and inline_backend_fmt will be available until v0.8.

  • Change default rc[‘savefig.transparent’] back to False (GH#252). Dubious justification for True in the first place, and makes default PNG proplot figures unreadable wherever “dark mode” is enabled.

  • Rename SciVisColor colormaps from Blue1, Blue2, etc. to plurals Blues1, Blues2, etc. to avoid name conflict with open-color colors (@8be0473f). Requesting the old names (case-sensitive) redirects to the new names (@3f0794d0). This permits making monochromatic open-color maps with e.g. plot.Colormap('blue9') and feels more consistent with ColorBrewer convention of using plurals like Blues, Reds, etc.

  • Shuffle various SciVisColor colormap names to make them consistent/succinct. Make Browns1 the most colorful/vibrant one, just like Greens1 and Blues1; split up the RedPurple maps into Reds and Purples; and add the Yellows category from the Oranges maps (@8be0473f). Requesting the old names (case-sensitive) redirects to the new names (@3f0794d0).

  • Add rc[‘image.discrete’] options and discrete keyword for toggling DiscreteNorm application, and disable by default for imshow, matshow, spy, hexbin, and hist2d plots (GH#233, @5a7e05e4). Also make hexbin and hist2d behavior with discrete=True more sane by using maximum possible counts for autoscaling, and change DiscreteNorm argument extend to more intuitive name unique.

  • Rename rc[‘subplots.pad’] and rc[‘subplots.axpad’] to more intuitive rc[‘subplots.outerpad’] and rc[‘subplots.innerpad’] (@3c7a33a8). Also rename Figure keywords.

  • Rename width and height subplots keyword args to figwidth and figheight to avoid confusion with refwidth/refheight (@12d01996). Will accept old keyword args without warning since they are used heavily.

  • Rename aspect, axwidth, and axheight keyword args to more intuitive refaspect, refwidth, and refheight (@12d01996). Will accept old keyword args without warning since they are used heavily.

  • Rename abovetop keyword for moving title/abc labels above top panels, colorbars, and legends to rc[‘title.above’] (@9ceacb7b). Example usage: ax.format(title='Title', titleabove=True).

  • Rename the proplot.colors.PerceptuallyUniformColormap.from_color keyword shade to luminance, and add the saturation keyword (@3d8e7dd0). These can also be passed to Colormap when it is called with positional arguments.

  • Rename seldom-used Figure argument fallback_to_cm to more understandable mathtext_fallback (GH#251).

  • Reduce default rc[‘savefig.dpi’] to 1000 (@bfda9c98). Nature recommends 1000, Science recommends “more than 300”, PNAS recommends 1000–1200. So 1000 is fine.

  • Increase default rc[‘colorbar.insetpad’] to avoid recurring issue where ticklabels run close to the background patch (@f5435976)

  • Use proplot TeX Gyre fonts with use_style styles unless specified otherwise (@6d7444fe). Styles otherwise build on matplotlib defaults.

  • When using medians=True or means=True with indicate_error plot simple error bars by default instead of bars and “boxes” (@4e30f415). Only plot “boxes” with central “markers” by default for violin plots (@13b45ccd).

  • legend_extras no longer returns the background patch generated for centered-row legends (GH#254). This is consistent with colorbar_extras not returning background patches generated for inset colorbars. Until proplot adds new subclasses, it makes more sense if these functions only return Legend and Colorbar instances.


  • Add the remaining commonly-used backend-related pyplot functions ion, ioff, isinteractive, and switch_backend to the top-level proplot namespace (@cd440155). This avoids forcing users to import pyplot inside a proplot session (the remaining pyplot functions are related to the “non-object-oriented” workflow, which proplot explicitly discourages).

  • Add support for local proplotrc files in addition to “hidden” .proplotrc files with leading dot (@8a989aca).

  • Add minimal support for “3D” Axes3D axes (GH#249). Example usage: fig.subplots(proj='3d').

  • Add wequal, hequal, and equal options to still use automatic spacing but force the tight layout algorithm to make spacings equal (GH#215, GH#64) by Zachary Moon.

  • Determine colormap levels using only in-bounds data if the x or y axis limits were explicitly set (GH#209). Add inbounds apply_cmap keyword and rc[‘image.inbounds’] setting to control this.

  • Allow calling proplot.colors.PerceptuallyUniformColormap.from_hsl by passing hue, saturation, or luminance to Colormap without any positional arguments (@3d8e7dd0).

  • Allow passing alpha, luminance, saturation to Colormap as lists to be applied to each component cmap (@3d8e7dd0).

  • Add convenient shorthands for channel references throughout colormap functions – e.g. h for hue, l for luminance, etc. (@3d8e7dd0).

  • Add the 'Flare' and 'Crest' seaborn colormaps (@14bc16c9). These are seaborn’s color cycle-friendly alternatives to existing maps.

  • Add the shift_hue function analogous to scale_saturation and scale_luminance (@67488bb1).

  • Add the to_hex function and make all color-manipulation funcs return HEX strings by default (@67488bb1). Otherwise scatter throws warnings.

  • Use 90 as the default luminance when creating monochromatic colormaps with to_listed set to True (as when Cycle calls Colormap; @3d8e7dd0).

  • Add plotx and scatterx commands that interpret plotting args as (y, x) rather than (x, y), analogous to areax (GH#258).

  • Add support for indicate_error horizontal error bars and shading for horizontal plotting commands barh, plotx, and scatterx (GH#258).

  • Add support for ax.plot_command('x_key', 'y_key', data=dataset) for virtually all plotting commands using standardize_1d and standardize_2d (GH#258). This was an existing plot feature.

  • Add support for the plotting style ax.plot(x1, y1, fmt1, x2, y2, fmt2, ...) as allowed by matplotlib (GH#258).

  • Add absolute_width keyword to bar_extras to make width argument absolute (GH#258). Remains False by default.

  • Use “sticky” edges in x-direction for lines drawn with plot() and in y-direction for lines drawn with plotx() (GH#258). This eliminates padding along the “dependent” axis when limits are not specified, similar to histograms and barplots and matching a feature we previously added to fill_between (GH#166).

  • Add support for “stacked” plots to vlines and hlines (GH#258).

  • Add stack as alternative to stacked for bar and area plots (@4e30f415). Imperative keywords are better.

  • Allow passing e.g. barstds=3 or barpctiles=90 to request error bars denoting +/-3 standard deviations and 5-95 percentile range (@4e30f415).

  • Add singular indicate_error keywords barstd, barpctile, etc. as alternatives to barstds, barpctiles, etc. (@81151a58). Also prefer them in the documentation.

  • Permit different colors for boxplot and violinplot using color lists (GH#217, GH#218) by Mickaël Lalande. Also allow passing other args as lists (@4e30f415).

  • Allow passing means=True to boxplot to toggle mean line (@4e30f415).

  • Allow setting the mean and median boxplot linestyle with (mean|median)(ls|linestyle) keywords (@4e30f415).

  • Automatically set fill=True when passing a fill color or color(s) to boxplot_wrapper (@4e30f415).

  • Allow updating vlines and hlines styling with singular color and linestyle and all of their aliases (GH#258).

  • Allow updating axes fonts that use scalings like 'small' and 'large' by passing fontsize=N to format (GH#212).

  • Add titlebbox and abcbbox as alternatives to titleborder and abcborder for “inner” titles and a-b-c labels (GH#240) by Pratiman Patel. Borders are still used by default.

  • Allow putting title and abc in the same location – the title and label are simply offset away from ech other (GH#402214f9). Padding between them is controlled by the new param rc[‘abc.titlepad’].

  • Add new rc[‘suptitle.pad’], rc[‘leftlabel.pad’], rc[‘toplabel.pad’], rc[‘bottomlabel.pad’], rc[‘rightlabel.pad’] settings to control padding used when aligning super labels (@402214f9). These can also be passed to format and applied locally. The new defaults increase super title padding by a bit.

  • More robust interpretation of rc[‘abc.style’] – now match case with first 'a' or 'A' in string, and only replace that one (GH#201).

  • Interpret fontsize-relative legend rc params like legend.borderpad with 'em' as default units rather than 'pt' (@6d98fd44).

  • Add rc.basemap setting for changing the default backend (@c9ca0bdd). If users have a cartopy vs. basemap preference, they probably want to use it globally.

  • Add rc[‘cartopy.circular’] setting for optionally disabling the “circular bounds on polar projections” feature (@c9ca0bdd).

  • Support the standard aliases 'ls', 'linestyle', 'linestyles', etc. in Cycle calls (@3d8e7dd0).

  • Add queue keyword to colorbar and legend to support workflow where users successively add handles to location (GH#254).

  • Add nozero keyword arg to apply_cmap to remove the zero contour from automatically generated levels (@10e0f13b). Example usage: ax.contour(x, y, z, nozero=True).

  • Add positive and negative keyword args to apply_cmap for requesting automatically-generated all-positive or all-negative levels (@335d58f4). Example usage: ax.contourf(x, y, z, positive=True).

  • Add rotation keyword to colorbar_wrapper for rotating colorbar tick labels, like xrotation and yrotation (@2d835f20).

  • Add tickdir and tickdirection keywords to colorbar_wrapper for controlling tick style, like xtickdir and ytickdir (@f377f090).

  • Allow specifying labels for auto-generated legends using a 'labels' key in a legend_kw keyword argument (@a11d1813).

  • Replace legends drawn in the same location by default rather than drawing two legends on top of each other (GH#254).

  • Use Artist labels for the default list-of-artist colorbar tick labels if values was not passed – and if labels are non-numeric, rotate them 90 degrees for horizontal colorbars by default (@ed8e1314). Makes the choice between “traditional” legends and “colorbar-style” legends more seamless.

  • Use same default-level generation algorithm for contour plots without colormaps as for all other colormap plots (@10e0f13b). Makes automatically-generated solid-color contours and colormap-style contours identical.

  • Add suffix '_copy' to colormaps converted with to_listed and to_linear_segmented to avoid accidental overwriting (@91998e93).

  • If available, use rc[‘pcolormesh.snap’] to repair overlap in transparent colorbar solids rather than manual-blending workaround (@c9f59e49).

  • Add xmin, xmax, ymin, and ymax keyword args to format as alternatives to xlim and ylim (@ae0719b7). Example usage: ax.format(xmin=0) as opposed to ax.format(xlim=(0, None)).

  • Allow passing full “side” names to lonlabels and latlabels rather than abbreviations, e.g. 'left' instead of 'l' (@a5060f67). This is more consistent with rest of package.

  • Set default transform to ccrs.PlateCarree when calling matplotlib.axes.Axes.fill on CartopyAxes (GH#193). This is more consistent with rest of package.

Bug fixes

  • Fix 3 fatal issues preventing proplot import and basic usage in matplotlib >= 3.4 (GH#251).

  • Fix deprecation warnings associated with matplotlib 3.4 refactoring of subplot classes (GH#251).

  • Fix deprecated reference to rc.fallback_to_cm in matplotlib >= 3.3 (GH#251).

  • Fix IndexFormatter deprecation warning in matplotlib >= 3.3 by replacing with proplot-local copy (GH#251).

  • Fix deprecation warning in matplotlib >= 3.3 – add extend as mappable attribute rather than passing it to colorbar() (@a23e7043).

  • Fix issue where figures with fixed-aspect axes don’t scale properly in matplotlib >= 3.3 (GH#210, GH#235).

  • Fix issue where “twin” (“alternate”) axes content always hidden beneath “parent” content due to adding as children (GH#223).

  • Fix issue where default layout in complex subplot grids with non-adjacent edges is incorrect (GH#221).

  • Fix issue where apply_cycle fails to merge mean-uncertainty legend handles due to presence of placeholder labels (@4e30f415).

  • Fix issue where standardize_1d inappropriately infers legend entries from y-coordinate metadata rather than column metadata (@4e30f415).

  • Fix issue where barb and quiver cannot accept 1D data arrays (GH#255).

  • Fix issue where cannot set rc.style = 'default' (GH#240) by Pratiman Patel.

  • Fix issue where get_legend returns None even with legends present (GH#224).

  • Fix issue where new child axes reset row/col label settings (@f32d9703).

  • Fix issue where DataArray string coordinates are not extracted from container before applying as tick labels (GH#214).

  • Fix issue where cannot set extend other than 'neither' for scatter colorbars (GH#206).

  • Fix issue where hexbin ignores vmin and vmax keywords (GH#250).

  • Fix issue where parametric plot x axis is reversed (@3bde6c47).

  • Fix issue where e.g. ax.area(x, 0, y2, negpos=True has positive colors below x-axis and negative above x-axis (GH#258).

  • Fix issue where “negpos” plots ignore edgecolor because they pass color rather than facecolor to plotting commands.

  • Fix issue where cannot have datetime labels on area plots (GH#255).

  • Fix issue where default orientation of barh vertical axis is reversed (@258).

  • Fix issue where hist with xarray.DataArray or pandas.Dataframe input causes erroneous axis labels; use labels for legend instead (GH#195).

  • Fix issue where axis is accidentally inverted for histogram plots (GH#191).

  • Fix issue where [xy]minorlocator=1 is not allowed (GH#219).

  • Fix issue where inner titles ignore axes-local titlepad (@14f3d0e3).

  • Fix issue where we again fail to sufficiently pad title above tick marks with tick marks on top x-axis (@402214f9).

  • Fix issue where non-Cartesian heatmap errors rather than warns (GH#238).

  • Fix issue where labels=True with no contours causes error (GH#238).

  • Fix issue where Cycle fails to register new names and fails to display in show_cycles (@94ffc1dc, @4a7a3c79).

  • Fix issue where proplot ignores set_under and set_over values when translating matplotlib colormap classes to proplot subclasses (GH#190).

  • Fix issue where DiscreteNorm does not account for set_under and set_over colors distinct from adjacent in-bounds colors (GH#190).

  • Fix issue where proplot fails to detect legend entries for “outer” legends (GH#189).

  • Fix issue where list-of-list-style legend() handle and label input fails completely (@a298f81f). This input style is used to specify “centered” legend rows.

  • Fix error message when no legend handles are found (@2c6bf3e2).

  • Fix issue where multiple-artist legend entries (e.g., for lines indicating means and shading indicating uncertainty) are accidentally truncated (@a11d1813).

  • Fix issue where numeric zero cannot be applied as legend label (@02417c8c).

  • Fix issue where simple pandas.DataFrame.plot calls with legend=True fail (GH#254, GH#198).

  • Fix unnecessary restriction where users can only draw <2 “alt” axes and clean up the alt[xy] and dual[xy] internals (GH#226).

  • Fix matplotlib bug where altx and alty reset the minor locator of the shared axis to AutoMinorLocator even if the axis scale is 'log' (@2f64361d).

  • Fix issue where axis coordinates are incorrect when violinplot or boxplot receive non-DataFrame input (@b5c3ec4c).

  • Fix issue where indicate_error cannot accept 1D error bounds (@ef2d72cd).

  • Fix issue where show_cmaps cannot display reversed colormaps (@2dd51177).

  • Fix issue where 'grays_r' translated to 'greys' (@074c6aef).

  • First reverse, then shift cmap_r_s colormaps (@e5156294).

  • Fix obscure parametric bug where numpy.stack tries to make nested ragged arrays from parametric coords (@b16d56a8).

  • Fix issue where where SubplotSpec.get_active_rows_columns returned incorrect number of “active” rows and columns (@5cf20b84).

  • For rc lookup with context=True, use most restrictive search mode rather than least. Otherwise ax.format() calls inside context blocks can be overwritten with the default rc values in subsequent ax.format() calls (@8005fcc1).


  • Refactor massive standardize_(1d|2d) and (cmap|cycle)_changer wrappers to break things into manageable chunks (GH#258, @6af22567, @d3352720).

  • Refactor colorbar and legend methods and their massive wrappers to clean things up and expand the “queueing” feature beyond wrappers (GH#254).

  • Add prefix 'proplot_' to registered axes “projections” (@be7ef21e). More clear and guards against conflicts with external packages and other mpl versions.

  • Add system for processing flexible keyword arguments across different commands to internals/__init__.py. Analogous to mpl _alias processing.


  • Finally use pplt as the recommended abbreviation: import proplot as pplt.

  • Major clean up of “Why ProPlot?” page and user guide pages.

  • Fix incomplete cmap.from_file docstrings (@54f1bc7c).

  • Rename “Changelog” to “What’s New?” and list all contributors in “About the Authors”.

  • Rename public/documented funcs ending in _wrapper to ending in _extras to avoid implication they are the only funcs wrapping those commands (@d1e1e85b).

  • Rename public/documented func make_mapping_array to private function, following lead of matplotlib’s makeMappingArray (@66ae574b).

  • Rename public/documented funcs cmap_changer and cycle_changer to apply_cmap and apply_cycle (@86f7699a).

ProPlot v0.6.4 (2020-06-13)


  • Change autoformat from a Figure keyword argument into the rc.autoformat rc setting (@3a7e5a7c).

  • Combine shading and lines when drawing on-the-fly legends with indicate_error shading using tuple of fill_between, plot handles, and have shadelabel and fadelabel instead create separate entries only when passed (GH#187).

Bug fixes

  • Fix major issue where calling legend() without any handles triggers error rather than using default handles (GH#188).

  • Fix issue where on-the-fly colorbar labels were ignored (@a642eeed).

  • Stop overwriting existing axis labels when autoformat=True and DataArrays or DataFrames passed to plotting command (@76c7c586).

  • Support single-level contours with colormap colors (GH#182).

  • Support changing line width, line style, and color properties for barb, quiver, streamplot, matshow, spy, and hist2d plots (GH#177).

  • Use rc[‘patch.linewidth’] for default bar edge width, stop setting default histogram plot linewidth to zero, and set rc[‘patch.linewidth’] to 0.6 to match proplot’s default line width for lines, axes edges, and hatches (GH#186).

ProPlot v0.6.3 (2020-06-02)

Bug fixes

  • Fix issue where proplot import fails if cartopy is not installed (@e29d49e8).

ProPlot v0.6.2 (2020-06-02)


  • Remove Figure setters like set_sharex, replace with read-only properties (@7b455008). These did not work and did not add critical functionality.


Bug fixes

  • Various improvements to auto-figure sizing with Qt backend and when calling print_figure (@db4e48d5, @82457347, @744d7d37).

  • Suppress warning when matplotlibrc contains non-style param (@4a0c7f10).

  • Fix fatal standardize_2d error when autoformat=False (GH#181)

  • Fix issue where Colormap(..., alpha=alpha) made persistent changes to the original registered colormap (@cb24ea51).

  • Prevent matplotlib deprecation warning by removing set_smart_bounds dependency and improving axis scale transforms (@432576d8).

  • Fix panel sharing issue in presence of stacked or multiple panels (@28eaf0ca).

  • Fix geographic feature toggling, zorder bugs (@acf0d5d4, @ea151b25).

  • Fix hist bug due to bar(..., width=width) now being relative to the x step size (@e32ed0bc).

  • Fix bug where savefig receives Path instead of string (GH#176).


ProPlot v0.6.1 (2020-05-20)

Bug fixes

  • Fix issue where cartopy version checking fails if cartopy is not installed (@86cd50b8).

  • Fix issue where “tight” layout of geographic plots was broken in pre-v0.18 cartopy (@72cb93c6).

  • Fix issue where gridline coverage was incomplete in some zoomed-in projections (@458c6d7c).

  • Fix issue where basemap minor gridlines did not update when major gridlines were updated (@427326a7).

ProPlot v0.6.0 (2020-05-20)


  • Remove the geoaxes and geogrid rc settings (GH#168). Gridline settings are now controlled with grid.

  • Remove the lonstep and latstep settings – we now use LongitudeLocator and LatitudeLocator to select “nice” gridline locations even when zoomed in (GH#168)

  • Change default rc settings closer to matplotlib, including margins and line width (GH#166, @f801852b). Many were changed for no good reason.

  • Change default line style for geographic gridlines from ':' to '-' and match style from primary gridlines (GH#166, @f801852b).

  • Rename add_errorbars to indicate_error and rename various keyword args (GH#166, @d8c50a8d).

  • Remove 'rgbcycle' setting (GH#166, @6653b7f0).

  • Deprecate support for “parametric” plots inside plot, instead use parametric (@64210bce).

  • Change units units keyword argument to more natural dest (@62903b48).

  • Remove the public objects normalizers, locators, formatters, cartopy_projs, basemap_kwargs, cmaps, colors, and fonts (GH#149).

  • Drop support for .xrgb and .xrgba files (@4fa72b0c). Not sure if any online sources produce these kinds of files.

  • Drop support for .rgba files, but optionally read 4th opacity column from .rgb and .txt files (@4fa72b0c).

  • Stop reversing the 'Spectral' colormap when ProPlot is imported (GH#149, @ce4ef6a0).

  • Remove 'Blue0' SciVisColor colormap (GH#149, @7cb4ce0f). It was odd man out in the table, and not even really perceptually uniform.

  • Remove custom ProPlot cycles – these should be thought out much more carefully (@43f65d17).

  • Remove “crayola” colors and clean up the register_colors algorithm (GH#149, @8922d6de). Crayola color names less intuitive than XKCD.

  • Use 'cmap_s' instead of 'cmap_shifted' to quickly get a 180 degree-shifted colormap, similar to 'cmap_r' (GH#149, @da4ccb08).

  • Rename GrayCycle colormap to MonoCycle to more accurately reflect colormap design origins (GH#149, @d67e45bf).

  • Rename rc_configurator and subplot_grid to RcConfigurator and SubplotsContainer to match capitalized class naming convention (GH#149).

  • Rename MidpointNorm to more intuitive DivergingNorm, and make “fair” color scaling the default behavior (@2f549c9).

  • Rename XYAxes to CartesianAxes, GeoAxes to CartopyAxes, and ProjAxes to GeoAxes (GH#149, @4a6a0e34).

  • Rename BinNorm to DiscreteNorm and fix issues with diverging norm color scaling (GH#149, @98a976f1).

  • Rename ColorDict to ColorDatabase, CmapDict to ColormapDatabase (GH#149, @9d7fd3e0).

  • Rename concatenate to append, updated to copy, truncated to truncate, and punched to cut (GH#149, @e1a08930). The old method names remain with a deprecation warning.


  • Add SigFigFormatter (GH#149, @da6105d2) and SciFormatter (GH#175, @c43f7f91) axis formatters.

  • Make default areax and areay bounds “sticky”, similar to histograms and barplots (GH#166).

  • Use _LonAxis and _LatAxis dummy axes with custom LongitudeLocator and LatitudeLocator to control geographic gridlines (GH#168).

  • Add 'dmslat' and 'dmslon' as formatters for cartopy projections, along with dms format keyword argument. This labels points with degrees/minutes/seconds when appropriate (GH#168).

  • Support “minor” geographic gridlines with the gridminor keyword arg and existing gridminor settings (GH#168). Default locator used for minor gridlines is AutoMinorLocator.

  • Add loninline, latinline, and rotatelabels keywords for controlling cartopy gridliner behavior (GH#168).

  • Add proplot.config.RcConfigurator.save and proplot.config.RcConfigurator.from_file methods (GH#167, @e6dd8314).

  • Increase default rc[‘savefig.dpi’] to 1200, matching recommendations from academic journals (GH#167, @c00e7314). Also add detailed discussion to user guide.

  • No longer distinguish between “quick” settings and proplot’s “added” settings (GH#167, @e6dd8314). Quick settings, added settings, and matplotlib settings can all have “children” so the distinction no longer makes sense.

  • Add opacity-preserving functions to_rgba and to_xyza, plus set_alpha for changing alpha channel of arbitrary color (GH#171, @81c647da).

  • Add to set_alpha the ability to create an opacity gradation, rather than just an opacity for the entire colormap (GH#171, @4583736).

  • Support passing colormap objects, not just names, to show_cmaps and show_cycles (GH#171, @7f8ca59f).

  • Add options to indicate_error for adding shading to arbitrary plots (GH#166, @d8c50a8d). Also support automatic legend entries for shading and ensure indicate_error preserves metadata.

  • Wrap pcolorfast just like pcolor and pcolormesh are wrapped (GH#166, @50a262dd).

  • Add negpos feature to bar_wrapper and new rc.negcolor and rc.poscolor rc keyword arguments (GH#166, @ab4d6746).

  • Support vlines and hlines flexible arguments and add negpos feature (GH#166, @1c53e947, @e42ee913).

  • Support cartopy 0.18 locators, formatters, deprecations, and new labelling features (GH#158).

  • Support building a colormap and DiscreteNorm inside scatter, just like contourf and pcolormesh (GH#162).

  • Add rc[‘geogrid.labelpad’] and rc[‘geogrid.rotatelabels’] settings for cartopy gridline labels (GH#158).

  • Support more AutoFormatter features on SimpleFormatter (GH#152, @6decf962).

  • Support drawing colorbars with descending levels (GH#149, @10763146)

  • Add support for matplotlib stylesheets with use_style function and style rc param (GH#149, @edc6f3c9).

  • Add categories keyword arg to show_cmaps and show_cycles (GH#149, @79be642d).

  • Hide bad colormaps like 'jet' from the show_cmaps table instead of deleting them outright, just like CSS4 colors (GH#149, @ce4ef6a0).

  • Draw show_colors table as single figure with category labels, similar to show_cmaps (GH#149, @c8ca2909).

  • Make 'Grays' and 'Greys' synonyms for the same ColorBrewer colormap (GH#149, @da4ccb08).

  • Permit drawing “outer” axes and figure legends without explicitly passing handles (GH#149, @a69b48eb). Figure legends use the handles from all axes.

  • Add to_listed and to_linear_segmented methods for handling conversions (GH#149, @e1a08930).

  • Permit merging mixed colormap types LinearSegmentedColormap with PerceptuallyUniformColormap (@972956b1).

  • Include the alpha channel when saving colormaps and cycles by default (GH#149, @117e05f2).

  • Permit 8-character hex strings with alpha channels when loading colormaps and color cycles from hex files (GH#149, @381a84d4).

  • Publicly support “filling” axes with colorbars using loc='fill' (GH#149, @057c9895).

  • Return both figure and axes in show_ functions; this gives users access to the axes and prevents drawing them twice in notebooks (GH#149, @2f600bc9).

  • Enable passing callables to Formatter to create a FuncFormatter instance.

  • Support sampling LinearSegmentedColormap into ListedColormaps inside of Colormap rather than Cycle (GH#84, @972956b1).

Bug fixes

  • Fix various issues with axis label sharing and axis sharing for twinned axes and panel axes (GH#164).

  • Permit modifying existing cartopy geographic features with successive calls to format (GH#168).

  • Fix issue drawing bar plots with datetime x axes (GH#156).

  • Fix issue where AutoFormatter tools were not locale-aware, i.e. use comma as decimal point sometimes (GH#152, @c7636296).

  • Fix issue where AutoFormatter nonzero-value correction algorithm was right for wrong reasons and could be wrong in rare circumstances (GH#152, @c7636296).

  • Fix issue where matplotlib.style.use resets backend (GH#149, @c8319104).

  • Fix issue with colormaps with dots in name (GH#149, @972956b1).

  • Fix logarithmic scale argument parsing deprecation (GH#149, @6ed7dbc5).

  • Fix deprecation of direct access to matplotlib.cm.cmap_d in matplotlib >=3.2.0 (GH#149, @a69c16da).

  • Fix issues with string font sizes (GH#149, @6121de03). Add hidden _get_font_size method to translate font size to numeric.

  • Fix issue where passing actual projection instances generated with Proj to subplots could incorrectly pair cartopy projections with basemap axes and vice versa (GH#149).

  • Fix issue where could not draw colorbar from list of single-color PathCollections, i.e. scatter plots (GH#149, @e893900b).

  • Fix issue where importing proplot in jupyter notebooks resets the default inline backend (GH#149, @6121de03).

  • Improve axis label sharing algorithm (@6535b219).

  • Fix main axis label sharing bugs in presence of panels (@7b709db9).

  • Fix v0.4.0 regression where panel sharing no longer works (@289e5538).

  • Fix AutoFormatter bug with values close to zero (GH#124, @9b7f89fd)

  • Fix AutoFormatter bug with small negative numbers (GH#117).

  • Label cyclic Scientific colour maps as cyclic (@e10a3109).

  • Permit special colormap normalization and level scaling for colormap-colored contour plots, just like contourf (GH#149, @054cceb5).


  • Major internal change: Move functions into smaller separate files to mimic how matplotlib library is divided up (GH#149).

  • Add internals folder containing default proplot rc params, deprecation helper functions, and other internal tools (GH#149).

  • Make colorbar axes instances of CartesianAxes, just like panel axes.

  • Rename ubiquitous _notNone function to _not_none and change to more sensible behavior.

  • Turn some private config functions into static methods (@6121de03).

  • Remove “smart bounds” feature from FuncScale (GH#166, @9ac149ea).

  • Clean up axes iterators (GH#149, @c8a0768a).


  • Call figure objects fig instead of f.

  • Major clean up of notebook examples (@f86542b5).

  • Major clean up wrappers documentation (@9648c18f)

  • Fix dead “See Also” links (@d32c6506).

  • Use “Other parameters” tables more often (@d32c6506).

ProPlot v0.5.0 (2020-02-10)


  • Remove abcformat from format (@2f295e18).

  • Rename top to abovetop in format (@500dd381).

  • Rename abc.linewidth and title.linewidth to borderwidth (@54eb4bee).

  • Rename text_wrapper linewidth and invert to borderwidth and borderinvert (@54eb4bee).


  • Add back Fabio Crameri’s scientific colour maps (GH#116).

  • Permit both e.g. locator and xlocator as keyword arguments to altx, etc. (@57fab860).

  • Permit descending BinNorm and LinearSegmentedNorm levels (GH#119).

  • Permit overriding the font weight, style, and stretch in the show_fonts table (@e8b9ee38).

  • Permit hiding “unknown” colormaps and color cycles in the show_cmaps and show_cycles tables (@cb206f19).

Bug fixes

  • Fix issue where show_cmaps and show_cycles colormap names were messed up (@13045599)

  • Fix issue where show_cmaps and show_cycles did not return figure instance (@98209e87).

  • Fix issue where user values passed to colorbar_wrapper were sometimes ignored (@fd4f8d5f).

  • Permit passing lists of colors to manually shade line contours and filled contours in cmap_changer.

  • Prevent formatting rightmost meridian label as 1e-10 on cartopy map projections (@37fdd1eb).

  • Support CF-time axes by fixing bug in standardize_1d and standardize_2d (GH#103, GH#121).

  • Redirect to the “default” location when using legend=True and colorbar=True to generate on-the-fly legends and colorbars (@c2c5c58d). This feature was accidentally removed.

  • Let colorbar_wrapper accept lists of colors (@e5f11591). This feature was accidentally removed.


  • Remove various unused keyword arguments (@33654a42).

  • Major improvements to the API controlling axes titles and a-b-c labels (@1ef7e65e).

  • Always use full names left, right, top, and bottom instead of l, r, b, and t, for clarity (@1ef7e65e).

  • Improve GrayCycle colormap, is now much shorter and built from reflected Fabio GrayC colormaps (@5b2c7eb7).

ProPlot v0.4.3 (2020-01-21)


  • Remove ipython_autoreload, ipython_autosave, and ipython_matplotlib (GH#112, GH#113). Move inline backend configuration to a hidden method that gets called whenever the rc_configurator is initalized.



ProPlot v0.4.2 (2020-01-09)


  • Add family keyword arg to show_fonts (GH#106).

  • Package the TeX Gyre font series with ProPlot (GH#106). Remove a couple other fonts.

  • Put the TeX Gyre fonts at the head of the serif, sans-serif, monospace, cursive, and fantasy rcParams font family lists (GH#104, GH#106).

Bug fixes

  • Fix issues with Fira Math weights unrecognized by matplotlib (GH#106).

ProPlot v0.4.1 (2020-01-08)


  • Change the default .proplotrc format from YAML to the .matplotlibrc syntax (GH#101).


  • Comments (lines starting with #) are now permitted in all RGB and HEX style colormap and cycle files (GH#100).

  • Break down show_cycles bars into categories, just like show_cmaps (GH#100).

Bug fixes

  • Fix issue where show_cmaps and show_cycles draw empty axes (GH#100).

  • Add back the default .proplorc file to docs (GH#101). To do this, conf.py auto-generates a file in _static.


  • Add geogrid.color/linewidth/etc and gridminor.color/linewidth/etc props as children of grid.color/linewidth/etc (GH#101).

  • Various rc_configurator improvements, remove outdated global variables (GH#101).

  • Better error handling when loading colormap/cycle files, and calls to Colormap and Cycle now raise errors while calls to register_cmaps and register_cycles still issue warnings (GH#100).

ProPlot v0.4.0 (2020-01-07)


  • Rename basemap_defaults to basemap_kwargs and cartopy_projs to cartopy_names (@431a06ce).

  • Remove subplots.innerspace, subplots.titlespace, subplots.xlabspace, and subplots.ylabspace spacing arguments, automatically calculate default non-tight spacing using _get_space based on current tick lengths, label sizes, etc.

  • Remove redundant use_fonts, use rcParams['sans-serif'] precedence instead (GH#95).

  • dualx and dualy no longer accept “scale-spec” arguments. Must be a function, two functions, or an axis scale instance (GH#96).

  • Remove Axes share[x|y], span[x|y], and align[x|y] kwargs (GH#99). These settings are now always figure-wide.

  • Rename Cycle samples to N, rename show_colors nbreak to nhues (GH#98).


  • Add from_file static methods (GH#98). You can now load files by passing a name to Colormap.

  • Add TeX Gyre Heros as open source Helvetica-alternative; this is the new default font. Add Fira Math as DejaVu Sans-alternative; has complete set of math characters (GH#95).

  • Add xlinewidth, ylinewidth, xgridcolor, ygridcolor keyword args to format (GH#95).

  • Add getters and setters for various Figure settings like share[x|y], span[x|y], and align[x|y] (GH#99).

  • Let twinx, twiny, altx, and alty accept format keyword args just like dualx and dualy (GH#99).

  • Add Figure fallback_to_cm kwarg. This is used by show_fonts to show dummy glyphs to clearly illustrate when fonts are missing characters, but preserve graceful fallback for end user.

  • Improve Proj constructor function. It now accepts Projection and Basemap instances, just like other constructor functions, and returns only the projection instance (GH#92).

  • rc __getitem__ always returns the setting. To get context block-restricted settings, you must explicitly pass context=True to get, fill, or category (GH#91).

Bug fixes

  • Fix context bug (GH#80 and GH#91).

  • Fix issues with dualx and dualy with non-linear parent scales (GH#96).

  • Ignore TTC fonts because they cannot be saved in EPS/PDF figures (GH#94 and GH#95).

  • Do not try to use Helvetica Neue because “thin” font style is read as regular (GH#94 and GH#95).


  • Use the imperative mood for docstring summaries (GH#92).

  • Fix show_cycles bug (GH#90) and show cycles using colorbars rather than lines (GH#98).


  • Define rc default values with inline dictionaries rather than with a default .proplotrc file, change the auto-generated user .proplotrc (GH#91).

  • Remove useless panel_kw keyword arg from legend_wrapper and colorbar_wrapper (GH#91). Remove wflush, hflush, and flush keyword args from subplots that should have been removed long ago.

ProPlot v0.3.1 (2019-12-16)

Bug fixes

  • Fix issue where custom fonts were not synced (@a1b47b4c).

  • Fix issue with latest versions of matplotlib where %matplotlib inline fails silently so the backend is not instantiated (@cc39dc56).

ProPlot v0.3.0 (2019-12-15)



  • Add use_font, only sync Google Fonts fonts (GH#87).

  • New 'DryWet' colormap is colorblind friendly (@0280e266).

  • Permit shifting arbitrary colormaps by 180 degrees by appending the name with '_shifted', just like '_r' (@e2e2b2c7).

Bug fixes

  • Add brute force workaround for saving colormaps with callable segmentdata (@8201a806).

  • Fix issue with latest versions of matplotlib where %matplotlib inline fails silently so the backend is not instantiated (@cc39dc56).

  • Fix shifted when shift is not 180 (@e2e2b2c7).

  • Save the cyclic and gamma attributes in JSON files too (@8201a806).


  • Cleanup notebooks, especially the colormaps demo (e.g. @952d4cb3).


ProPlot v0.2.7 (2019-12-09)

Bug fixes

  • Fix issue where AutoFormatter logarithmic scale points are incorrect (@9b164733).



  • Remove prefix, suffix, and negpos keyword args from SimpleFormatter, remove precision keyword arg from AutoFormatter (@8520e363).

  • Make 'deglat', 'deglon', 'lat', 'lon', and 'deg' instances of AutoFormatter instead of SimpleFormatter (@8520e363). The latter should just be used for contours.

ProPlot v0.2.6 (2019-12-08)

Bug fixes

  • Fix issue where twin axes are drawn twice (@56145122).

ProPlot v0.2.5 (2019-12-07)


  • Much better CutoffScale algorithm, permit arbitrary cutoffs (GH#83).

ProPlot v0.2.4 (2019-12-07)


  • Rename ColorCacheDict to ColorDict (@aee7d1be).

  • Rename colors to Colors (@aee7d1be)

  • Remove fonts_system and fonts_proplot, rename colordict to colors, make top-level variables more robust (@861583f8).



  • Improvements to register_colors.

ProPlot v0.2.3 (2019-12-05)

Bug fixes

  • Fix issue with overlapping gridlines using monkey patches on gridliner instances (@8960ebdc).

  • Fix issue where auto colorbar labels are not applied when globe=True (@ecb3c899).

  • More sensible zorder for gridlines (@90d94e55).

  • Fix issue where customized super title settings are overridden when new axes are created (@35cb21f2).


  • Organize ipython notebook documentation (@35cb21f2).


  • Major cleanup of the colorbar_wrapper source code, handle minor ticks using the builtin matplotlib API just like major ticks (@b9976220).

ProPlot v0.2.2 (2019-12-04)


  • Rename axes_grid to subplot_grid (@ac14e9dd).

Bug fixes


  • Make notebook examples PEP8 compliant (@97f5ffd4). Much more readable now.

ProPlot v0.2.1 (2019-12-02)


  • Rename autoreload_setup, autosave_setup, and matplotlib_setup to ipython_autoreload, ipython_autosave, and ipython_matplotlib, respectively (@84e80c1e).

ProPlot v0.2.0 (2019-12-02)


  • Remove the nbsetup rc setting in favor of separate autosave, autoreload, and matplotlib settings for triggering the respective % magic commands. (@3a622887; nbsetup is still accepted but no longer documented).

  • Rename the format rc setting in favor of the inlinefmt setting (@3a622887; format is still accepted but no longer documented).

  • Rename FlexibleGridSpec and FlexibleSubplotSpec to GridSpec and SubplotSpec (@3a622887; until GH#110 is merged it is impossible to use these manually, so this won’t bother anyone).


  • Support manual resizing for all backends, including osx and qt (@3a622887).

Bug fixes

  • Disable automatic resizing for the nbAgg interactive inline backend. Found no suitable workaround (@3a622887).


  • Organize the rc documentation and the default .proplotrc file (@3a622887).

  • Rename rcParamsCustom to rcParamsLong (@3a622887; this is inaccessible to the user).

  • When calling fig.canvas.print_figure() on a stale figure, call fig.canvas.draw() first. May be overkill for savefig but critical for correctly displaying already-drawn notebook figures.

ProPlot v0.1.0 (2019-12-01)


  • Include flake8 in Travis CI testing (@8743b857).

  • Enforce source code PEP8 compliance (@78da51a7).

  • Use pre-commit for all future commits (@e14f6809).

  • Implement tight layout stuff with canvas monkey patches (@67221d10). ProPlot now works for arbitrary backends, not just inline and qt.


ProPlot v0.0.0 (2019-11-27)

The first version released on PyPi.