Figure.format¶
- Figure.format()[source]¶
Modify figure-wide labels and call
format
for the input axes. By default the numbered subplots are used.- Parameters
axs (sequence of
Axes
, optional) – The axes to format. Default is the numbered subplots.rowlabels, collabels, llabels, tlabels, rlabels, blabels – Aliases for
leftlabels
andtoplabels
, and forleftlabels
,toplabels
,rightlabels
, andbottomlabels
, respectively.leftlabels, toplabels, rightlabels, bottomlabels (sequence of
str
, optional) – Labels for the subplots lying along the left, top, right, and bottom edges of the figure. The length of each list must match the number of subplots along the corresponding edge.leftlabelpad, toplabelpad, rightlabelpad, bottomlabelpad (
float
orunit-spec
, default:rc['leftlabel.pad']
=5.0
,rc['toplabel.pad']
=5.0
,rc['rightlabel.pad']
=5.0
,rc['bottomlabel.pad']
=5.0
) – The padding between the labels and the axes content. If float, units are points. If string, interpreted byunits
.leftlabels_kw, toplabels_kw, rightlabels_kw, bottomlabels_kw (dict-like, optional) – Additional settings used to update the labels with
text.update()
.figtitle – Alias for
suptitle
.suptitle (
str
, optional) – The figure “super” title, centered between the left edge of the leftmost subplot and the right edge of the rightmost subplot.suptitlepad (
float
, default:rc['suptitle.pad']
=5.0
) – The padding between the super title and the axes content. If float, units are points. If string, interpreted byunits
.suptitle_kw (optional) – Additional settings used to update the super title with
text.update()
.includepanels (
bool
, default:False
) – Whether to include panels when aligning figure “super titles” along the top of the subplot grid and when aligning thespanx
x axis labels andspany
y axis labels along the sides of the subplot grid.
Important
leftlabelpad
,toplabelpad
,rightlabelpad
, andbottomlabelpad
keywords are actually configuration settings. We explicitly document these arguments here because it is common to change them for specific figures. But many other configuration settings can be passed toformat
too.- Other Parameters
title (
str
or sequence, optional) – The axes title. Can optionally be a sequence strings, in which case the title will be selected from the sequence according tonumber
.abc (
bool
orstr
or sequence, default:rc.abc
=False
) – The “a-b-c” subplot label style. Must contain the charactera
orA
, for example'a.'
, or'A'
. IfTrue
then the default style of'a'
is used. Thea
orA
is replaced with the alphabetic character matching thenumber
. Ifnumber
is greater than 26, the characters loop around to a, …, z, aa, …, zz, aaa, …, zzz, etc. Can also be a sequence of strings, in which case the “a-b-c” label will simply be selected from the sequence according tonumber
.abcloc, titleloc (
str
, default:rc['abc.loc']
='left'
,rc['title.loc']
='center'
) – Strings indicating the location for the a-b-c label and main title. The following locations are valid:Location
Valid keys
center above axes
'center'
,'c'
left above axes
'left'
,'l'
right above axes
'right'
,'r'
lower center inside axes
'lower center'
,'lc'
upper center inside axes
'upper center'
,'uc'
upper right inside axes
'upper right'
,'ur'
upper left inside axes
'upper left'
,'ul'
lower left inside axes
'lower left'
,'ll'
lower right inside axes
'lower right'
,'lr'
abcborder, titleborder (
bool
, default:rc['abc.border']
=True
andrc['title.border']
=True
) – Whether to draw a white border around titles and a-b-c labels positioned inside the axes. This can help them stand out on top of artists plotted inside the axes.abcbbox, titlebbox (
bool
, default:rc['abc.bbox']
=False
andrc['title.bbox']
=False
) – Whether to draw a white bbox around titles and a-b-c labels positioned inside the axes. This can help them stand out on top of artists plotted inside the axes.abc_kw, title_kw (dict-like, optional) – Additional settings used to update the a-b-c label and title with
text.update()
.titlepad (
float
, default:rc['title.pad']
=5.0
) – The padding for the inner and outer titles and a-b-c labels. If float, units are points. If string, interpreted byunits
.titleabove (
bool
, default:rc['title.above']
=True
) – Whether to try to put outer titles and a-b-c labels above panels, colorbars, or legends that are above the axes.abctitlepad (
float
, default:rc['abc.titlepad']
=4.0
) – The horizontal padding between a-b-c labels and titles in the same location. If float, units are points. If string, interpreted byunits
.ltitle, ctitle, rtitle, ultitle, uctitle, urtitle, lltitle, lctitle, lrtitle (
str
or sequence, optional) – Shorthands for the below keywords.lefttitle, centertitle, righttitle, upperlefttitle, uppercentertitle, upperrighttitle, lowerlefttitle, lowercentertitle, lowerrighttitle (
str
or sequence, optional) – Additional titles in specific positions (seetitle
for details). This works as an alternative to theax.format(title='Title', titleloc=loc)
workflow and permits adding more than one title-like label for a single axes.a, alpha, fc, facecolor, ec, edgecolor, lw, linewidth, ls, linestyle (default:
rc['axes.alpha']
=None
,rc['axes.facecolor']
='white'
,rc['axes.edgecolor']
='black'
,rc['axes.linewidth']
=0.6
,'-'
) – Additional settings applied to the background patch, and their shorthands. Their defaults values are the'axes'
properties.aspect (
{'auto', 'equal'}
orfloat
, optional) – The data aspect ratio. Seeset_aspect
for details.xlabel, ylabel (
str
, optional) – The x and y axis labels. Applied withset_xlabel
andset_ylabel
.xlabel_kw, ylabel_kw (dict-like, optional) – Additional axis label settings applied with
set_xlabel
andset_ylabel
. See alsolabelpad
,labelcolor
,labelsize
, andlabelweight
below.xlim, ylim (
2-tuple
offloats
orNone
, optional) – The x and y axis data limits. Applied withset_xlim
andset_ylim
.xmin, ymin (
float
, optional) – The x and y minimum data limits. Useful if you do not want to set the maximum limits.xmax, ymax (
float
, optional) – The x and y maximum data limits. Useful if you do not want to set the minimum limits.xreverse, yreverse (
bool
, optional) – Whether to “reverse” the x and y axis direction. Makes the x and y axes ascend left-to-right and top-to-bottom, respectively.xscale, yscale (
scale-spec
, optional) – The x and y axis scales. Passed to theScale
constructor. For example,xscale='log'
applies logarithmic scaling, andxscale=('cutoff', 100, 2)
applies aCutoffScale
.xscale_kw, yscale_kw (dict-like, optional) – The x and y axis scale settings. Passed to
Scale
.xmargin, ymargin, margin (
float
, default:rc.margin
=0.05
) – The default margin between plotted content and the x and y axis spines in axes-relative coordinates. This is useful if you don’t witch to explicitly set axis limits. Use the keywordmargin
to set both at once.xbounds, ybounds (
2-tuple
offloat
, optional) – The x and y axis data bounds within which to draw the spines. For example,xlim=(0, 4)
combined withxbounds=(2, 4)
will prevent the spines from meeting at the origin. This also appliesxspineloc='bottom'
andyspineloc='left'
by default if both spines are currently visible.xtickrange, ytickrange (
2-tuple
offloat
, optional) – The x and y axis data ranges within which major tick marks are labelled. For example,xlim=(-5, 5)
combined withxtickrange=(-1, 1)
and a tick interval of 1 will only label the ticks marks at -1, 0, and 1. SeeAutoFormatter
for details.xwraprange, ywraprange (
2-tuple
offloat
, optional) – The x and y axis data ranges with which major tick mark values are wrapped. For example,xwraprange=(0, 3)
causes the values 0 through 9 to be formatted as 0, 1, 2, 0, 1, 2, 0, 1, 2, 0. SeeAutoFormatter
for details. This can be combined withxtickrange
andytickrange
to make “stacked” line plots.xloc, yloc (optional) – Shorthands for
xspineloc
,yspineloc
.xspineloc, yspineloc (
{'b', 't', 'l', 'r', 'bottom', 'top', 'left', 'right', 'both', 'neither', 'none', 'zero', 'center'}
or2-tuple
, optional) – The x and y spine locations. Applied withset_position
. Propagates totickloc
unless specified otherwise.xtickloc, ytickloc (
{'b', 't', 'l', 'r', 'bottom', 'top', 'left', 'right', 'both', 'neither', 'none'}
, optional) – Which x and y axis spines should have major and minor tick marks. Inherits fromspineloc
by default and propagates toticklabelloc
unless specified otherwise.xticklabelloc, yticklabelloc (
{'b', 't', 'l', 'r', 'bottom', 'top', 'left', 'right', 'both', 'neither', 'none'}
, optional) – Which x and y axis spines should have major tick labels. Inherits fromtickloc
by default and propagates tolabelloc
andoffsetloc
unless specified otherwise.xlabelloc, ylabelloc (
{'b', 't', 'l', 'r', 'bottom', 'top', 'left', 'right'}
, optional) – Which x and y axis spines should have axis labels. Inherits fromticklabelloc
by default (ifticklabelloc
is a single side).xoffsetloc, yoffsetloc (
{'b', 't', 'l', 'r', 'bottom', 'top', 'left', 'right'}
, optional) – Which x and y axis spines should have the axis offset indicator. Inherits fromticklabelloc
by default (ifticklabelloc
is a single side).xtickdir, ytickdir, tickdir (
{'out', 'in', 'inout'}
, optional) – Direction that major and minor tick marks point for the x and y axis. Use the keywordtickdir
to control both.xticklabeldir, yticklabeldir (
{'in', 'out'}
, optional) – Whether to place x and y axis tick label text inside or outside the axes. Propagates toxtickdir
andytickdir
unless specified otherwise.xrotation, yrotation (
float
, default:0
) – The rotation for x and y axis tick labels. for normal axes,rc['formatter.timerotation']
='vertical'
for time x axes.xgrid, ygrid, grid (
bool
, default:rc.grid
=True
) – Whether to draw major gridlines on the x and y axis. Use the keywordgrid
to toggle both.xgridminor, ygridminor, gridminor (
bool
, default:rc.gridminor
=False
) – Whether to draw minor gridlines for the x and y axis. Use the keywordgridminor
to toggle both.xtickminor, ytickminor, tickminor (
bool
, default:rc['tick.minor']
=True
) – Whether to draw minor ticks on the x and y axes. Use the keywordtickminor
to toggle both.xticks, yticks (optional) – Aliases for
xlocator
,ylocator
.xlocator, ylocator (
locator-spec
, optional) – Used to determine the x and y axis tick mark positions. Passed to theLocator
constructor. Can be float, list of float, string, ormatplotlib.ticker.Locator
instance. Use[]
,'null'
, or'none'
for no ticks.xlocator_kw, ylocator_kw (dict-like, optional) – Keyword arguments passed to the
matplotlib.ticker.Locator
class.xminorticks, yminorticks (optional) – Aliases for
xminorlocator
,yminorlocator
.xminorlocator, yminorlocator (optional) – As for
xlocator
,ylocator
, but for the minor ticks.xminorlocator_kw, yminorlocator_kw – As for
xlocator_kw
,ylocator_kw
, but for the minor locator.xticklabels, yticklabels (optional) – Aliases for
xformatter
,yformatter
.xformatter, yformatter (
formatter-spec
, optional) – Used to determine the x and y axis tick label string format. Passed to theFormatter
constructor. Can be string, list of strings, ormatplotlib.ticker.Formatter
instance. Use[]
,'null'
, or'none'
for no labels.xformatter_kw, yformatter_kw (dict-like, optional) – Keyword arguments passed to the
matplotlib.ticker.Formatter
class.xcolor, ycolor, color (
color-spec
, default:rc['meta.color']
='black'
) – Color for the x and y axis spines, ticks, tick labels, and axis labels. Use the keywordcolor
to set both at once.xgridcolor, ygridcolor, gridcolor (
color-spec
, default:rc['grid.color']
='black'
) – Color for the x and y axis major and minor gridlines. Use the keywordgridcolor
to set both at once.xlinewidth, ylinewidth, linewidth (
color-spec
, default:rc['meta.width']
=0.6
) – Line width for the x and y axis spines and major ticks. Propagates totickwidth
unless specified otherwise. Use the keywordlinewidth
to set both at once.xtickcolor, ytickcolor, tickcolor (
color-spec
, default:rc['tick.color']
='black'
) – Color for the x and y axis ticks. Defaults arexcolor
,ycolor
, andcolor
if they were passed. Use the keywordtickcolor
to set both at once.xticklen, yticklen, ticklen (
unit-spec
, default:rc['tick.len']
=4.0
) – Major tick lengths for the x and y axis. If float, units are points. If string, interpreted byunits
. Use the keywordticklen
to set both at once.xticklenratio, yticklenratio, ticklenratio (
float
, default:rc['tick.lenratio']
=0.5
) – Relative scaling ofxticklen
andyticklen
used to determine minor tick lengths. Use the keywordticklenratio
to set both at once.xtickwidth, ytickwidth, tickwidth, (
unit-spec
, default:rc['tick.width']
=0.6
) – Major tick widths for the x ans y axis. Default islinewidth
if it was passed. If float, units are points. If string, interpreted byunits
. Use the keywordtickwidth
to set both at once.xtickwidthratio, ytickwidthratio, tickwidthratio (
float
, default:rc['tick.widthratio']
=0.8
) – Relative scaling ofxtickwidth
andytickwidth
used to determine minor tick widths. Use the keywordtickwidthratio
to set both at once.xticklabelpad, yticklabelpad, ticklabelpad (
unit-spec
, default:rc['tick.labelpad']
=2.0
) – The padding between the x and y axis ticks and tick labels. Use the keywordticklabelpad
to set both at once. If float, units are points. If string, interpreted byunits
.xticklabelcolor, yticklabelcolor, ticklabelcolor (
color-spec
, default:rc['tick.labelcolor']
='black'
) – Color for the x and y tick labels. Defaults arexcolor
,ycolor
, andcolor
if they were passed. Use the keywordticklabelcolor
to set both at once.xticklabelsize, yticklabelsize, ticklabelsize (
unit-spec
orstr
, default:rc['tick.labelsize']
='medium'
) – Font size for the x and y tick labels. If float, units are points. If string, interpreted byunits
. Use the keywordticklabelsize
to set both at once.xticklabelweight, yticklabelweight, ticklabelweight (
str
, default:rc['tick.labelweight']
='normal'
) – Font weight for the x and y tick labels. Use the keywordticklabelweight
to set both at once.xlabelpad, ylabelpad (
unit-spec
, default:rc['label.pad']
=4.0
) – The padding between the x and y axis bounding box and the x and y axis labels. If float, units are points. If string, interpreted byunits
.xlabelcolor, ylabelcolor, labelcolor (
color-spec
, default:rc['label.color']
='black'
) – Color for the x and y axis labels. Defaults arexcolor
,ycolor
, andcolor
if they were passed. Use the keywordlabelcolor
to set both at once.xlabelsize, ylabelsize, labelsize (
unit-spec
orstr
, default:rc['label.size']
='medium'
) – Font size for the x and y axis labels. If float, units are points. If string, interpreted byunits
. Use the keywordlabelsize
to set both at once.xlabelweight, ylabelweight, labelweight (
str
, default:rc['label.weight']
='normal'
) – Font weight for the x and y axis labels. Use the keywordlabelweight
to set both at once.fixticks (
bool
, default:False
) – Whether to transform the tick locators to aFixedLocator
. If your axis ticks are doing weird things (for example, ticks are drawn outside of the axis spine) you can try setting this toTrue
.r0 (
float
, default:0
) – The radial origin.theta0 (
{'N', 'NW', 'W', 'SW', 'S', 'SE', 'E', 'NE'}
, optional) – The zero azimuth location.thetadir (
{1, -1, 'anticlockwise', 'counterclockwise', 'clockwise'}
, optional) – The positive azimuth direction. Clockwise corresponds to-1
and anticlockwise corresponds to1
.thetamin, thetamax (
float
, optional) – The lower and upper azimuthal bounds in degrees. Ifthetamax != thetamin + 360
, this produces a sector plot.thetalim (
2-tuple
offloat
orNone
, optional) – Specifiesthetamin
andthetamax
at once.rmin, rmax (
float
, optional) – The inner and outer radial limits. Ifr0 != rmin
, this produces an annular plot.rlim (
2-tuple
offloat
orNone
, optional) – Specifiesrmin
andrmax
at once.rborder (
bool
, optional) – Whether to draw the polar axes border. Visibility of the “inner” radial spine and “start” and “end” azimuthal spines is controlled automatically by matplotlib.thetagrid, rgrid, grid (
bool
, optional) – Whether to draw major gridlines for the azimuthal and radial axis. Use the keywordgrid
to toggle both.thetagridminor, rgridminor, gridminor (
bool
, optional) – Whether to draw minor gridlines for the azimuthal and radial axis. Use the keywordgridminor
to toggle both.thetagridcolor, rgridcolor, gridcolor (
color-spec
, optional) – Color for the major and minor azimuthal and radial gridlines. Use the keywordgridcolor
to set both at once.thetalocator, rlocator (
locator-spec
, optional) – Used to determine the azimuthal and radial gridline positions. Passed to theLocator
constructor. Can be float, list of float, string, ormatplotlib.ticker.Locator
instance.thetalines, rlines – Aliases for
thetalocator
,rlocator
.thetalocator_kw, rlocator_kw (dict-like, optional) – The azimuthal and radial locator settings. Passed to
Locator
.thetaminorlocator, rminorlocator (optional) – As for
thetalocator
,rlocator
, but for the minor gridlines.thetaminorticks, rminorticks (optional) – Aliases for
thetaminorlocator
,rminorlocator
.thetaminorlocator_kw, rminorlocator_kw – As for
thetalocator_kw
,rlocator_kw
, but for the minor locator.rlabelpos (
float
, optional) – The azimuth at which radial coordinates are labeled.thetaformatter, rformatter (
formatter-spec
, optional) – Used to determine the azimuthal and radial label format. Passed to theFormatter
constructor. Can be string, list of string, ormatplotlib.ticker.Formatter
instance. Use[]
,'null'
, or'none'
for no labels.thetalabels, rlabels (optional) – Aliases for
thetaformatter
,rformatter
.thetaformatter_kw, rformatter_kw (dict-like, optional) – The azimuthal and radial label formatter settings. Passed to
Formatter
.color (
color-spec
, default:rc['meta.color']
='black'
) – Color for the axes edge. Propagates tolabelcolor
unless specified otherwise (similar toproplot.axes.CartesianAxes.format
).labelcolor, gridlabelcolor (
color-spec
, default:color
orrc['grid.labelcolor']
='black'
) – Color for the gridline labels.labelpad, gridlabelpad (
unit-spec
, default:rc['grid.labelpad']
=3.0
) – The padding between the axes edge and the radial and azimuthal labels. If float, units are points. If string, interpreted byunits
.labelsize, gridlabelsize (
unit-spec
orstr
, default:rc['grid.labelsize']
='medium'
) – Font size for the gridline labels. If float, units are points. If string, interpreted byunits
.labelweight, gridlabelweight (
str
, default:rc['grid.labelweight']
='normal'
) – Font weight for the gridline labels.round (
bool
, default:rc['geo.round']
=True
) – For polar cartopy axes only. Whether to bound polar projections with circles rather than squares. Note that outer gridline labels cannot be added to circle-bounded polar projections. When basemap is the backend this argument must be passed toProj
instead.extent (
{'globe', 'auto'}
, default:rc['geo.extent']
='globe'
) – For cartopy axes only. Whether to auto adjust the map bounds based on plotted content. If'globe'
then non-polar projections are fixed withset_global
, non-Gnomonic polar projections are bounded at the equator, and Gnomonic polar projections are bounded at 30 degrees latitude. If'auto'
nothing is done.lonlim, latlim (
2-tuple
offloat
, optional) – For cartopy axes only. The approximate longitude and latitude boundaries of the map, applied withset_extent
. When basemap is the backend this argument must be passed toProj
instead.boundinglat (
float
, optional) – For cartopy axes only. The edge latitude for the circle bounding North Pole and South Pole-centered projections. When basemap is the backend this argument must be passed toProj
instead.longrid, latgrid, grid (
bool
, default:rc.grid
=True
) – Whether to draw longitude and latitude gridlines. Use the keywordgrid
to toggle both at once.longridminor, latgridminor, gridminor (
bool
, default:rc.gridminor
=False
) – Whether to draw “minor” longitude and latitude lines. Use the keywordgridminor
to toggle both at once.latmax (
float
, default:80
) – The maximum absolute latitude for gridlines. Longitude gridlines are cut off poleward of this value (note this feature does not work in cartopy 0.18).nsteps (
int
, default:rc['grid.nsteps']
=250
) – For cartopy axes only. The number of interpolation steps used to draw gridlines.lonlines, latlines (optional) – Aliases for
lonlocator
,latlocator
.lonlocator, latlocator (
locator-spec
, optional) – Used to determine the longitude and latitude gridline locations. Passed to theLocator
constructor. Can be string, float, list of float, ormatplotlib.ticker.Locator
instance.For basemap or cartopy < 0.18, the defaults are
'deglon'
and'deglat'
, which correspond to theLongitudeLocator
andLatitudeLocator
locators (adapted from cartopy). For cartopy >= 0.18, the defaults are'dmslon'
and'dmslat'
, which uses the same locators withdms=True
. This selects gridlines at nice degree-minute-second intervals when the map extent is very small.lonlines_kw, latlines_kw (optional) – Aliases for
lonlocator_kw
,latlocator_kw
.lonlocator_kw, latlocator_kw (dict-like, optional) – Keyword arguments passed to the
matplotlib.ticker.Locator
class.lonminorlocator, latminorlocator, lonminorlines, latminorlines (optional) – As with
lonlocator
andlatlocator
but for the “minor” gridlines.lonminorlines_kw, latminorlines_kw (optional) – Aliases for
lonminorlocator_kw
,latminorlocator_kw
.lonminorlocator_kw, latminorlocator_kw (optional) – As with
lonlocator_kw
, andlatlocator_kw
but for the “minor” gridlines.lonlabels, latlabels, labels (
str
,bool
, or sequence,rc['grid.labels']
=False
) – Whether to add non-inline longitude and latitude gridline labels, and on which sides of the map. Use the keywordlabels
to set both at once. The argument must conform to one of the following options:A boolean.
True
indicates the bottom side for longitudes and the left side for latitudes, andFalse
disables all labels.A string or sequence of strings indicating the side names, e.g.
'top'
for longitudes or('left', 'right')
for latitudes.A string indicating the side names with single characters, e.g.
'bt'
for longitudes or'lr'
for latitudes.A string matching
'neither'
(no labels),'both'
(equivalent to'bt'
for longitudes and'lr'
for latitudes), or'all'
(equivalent to'lrbt'
, i.e. all sides).A boolean 2-tuple indicating whether to draw labels on the
(bottom, top)
sides for longitudes, and the(left, right)
sides for latitudes.A boolean 4-tuple indicating whether to draw labels on the
(left, right, bottom, top)
sides, as with the basemapdrawmeridians
anddrawparallels
labels
keyword.
loninline, latinline, inlinelabels (
bool
, default:rc['grid.inlinelabels']
=False
) – For cartopy axes only. Whether to add inline longitude and latitude gridline labels. Use the keywordinlinelabels
to set both at once.rotatelabels (
bool
, default:rc['grid.rotatelabels']
=False
) – For cartopy axes only. Whether to rotate non-inline gridline labels so that they automatically follow the map boundary curvature.labelpad (
unit-spec
, default:rc['grid.labelpad']
=3.0
) – For cartopy axes only. The padding between non-inline gridline labels and the map boundary. If float, units are points. If string, interpreted byunits
.dms (
bool
, default:rc['grid.dmslabels']
=True
) – For cartopy axes only. Whether the default locators and formatters should use “minutes” and “seconds” for gridline labels on small scales rather than decimal degrees. Setting this toFalse
is equivalent toax.format(lonlocator='deglon', latlocator='deglat')
andax.format(lonformatter='deglon', latformatter='deglat')
.lonformatter, latformatter (
formatter-spec
, optional) – Formatter used to style longitude and latitude gridline labels. Passed to theFormatter
constructor. Can be string, list of string, ormatplotlib.ticker.Formatter
instance.For basemap or cartopy < 0.18, the defaults are
'deglon'
and'deglat'
, which correspond toSimpleFormatter
presets with degree symbols and cardinal direction suffixes. For cartopy >= 0.18, the defaults are'dmslon'
and'dmslat'
, which uses cartopy’sLongitudeFormatter
andLatitudeFormatter
formatters withdms=True
. This formats gridlines that do not fall on whole degrees as “minutes” and “seconds” rather than decimal degrees. Usedms=False
to disable this.lonformatter_kw, latformatter_kw (dict-like, optional) – Keyword arguments passed to the
matplotlib.ticker.Formatter
class.land, ocean, coast, rivers, lakes, borders, innerborders (
bool
, optional) – Toggles various geographic features. These are actually therc.land
,rc.ocean
,rc.coast
,rc.rivers
,rc.lakes
,rc.borders
, andrc.innerborders
settings passed tocontext
. The style can be modified using additionalrc
settings.For example, to change
rc['land.color']
, useax.format(landcolor='green')
, and to changerc['land.zorder']
, useax.format(landzorder=4)
.reso (
{'lo', 'med', 'hi', 'x-hi', 'xx-hi'}
, optional) – For cartopy axes only. The resolution of geographic features. When basemap is the backend this must be passed toProj
instead.color (
color-spec
, default:rc['meta.color']
='black'
) – The color for the axes edge. Propagates tolabelcolor
unless specified otherwise (similar toproplot.axes.CartesianAxes.format
).gridcolor (
color-spec
, default:rc['grid.color']
='black'
) – The color for the gridline labels.labelcolor (
color-spec
, default:color
orrc['grid.labelcolor']
='black'
) – The color for the gridline labels (gridlabelcolor
is also allowed).labelsize (
unit-spec
orstr
, default:rc['grid.labelsize']
='medium'
) – The font size for the gridline labels (gridlabelsize
is also allowed). If float, units are points. If string, interpreted byunits
.labelweight (
str
, default:rc['grid.labelweight']
='normal'
) – The font weight for the gridline labels (gridlabelweight
is also allowed).rc_mode (
int
, optional) – The context mode passed tocontext
.rc_kw (dict-like, optional) – An alternative to passing extra keyword arguments. See below.
**kwargs – Keyword arguments that match the name of an
rc
setting are passed toproplot.config.Configurator.context
and used to update the axes. If the setting name has “dots” you can simply omit the dots. For example,abc='A.'
modifies therc.abc
setting,titleloc='left'
modifies therc['title.loc']
setting,gridminor=True
modifies therc.gridminor
setting, andgridbelow=True
modifies therc['grid.below']
setting. Many of the keyword arguments documented above are internally applied by retrieving settings passed tocontext
.