Merge pull request matplotlib#3083 from wavexx/suptitle

ENH : New rcParams to set pyplot.suptitle() defaults

Author: tacaswell

doc/users/whats_new/rcparams.rst

@@ -4,3 +4,10 @@ Added "legend.framealpha" key to rcParams
 Added a key and the corresponding logic to control the default transparency of
 legend frames. This feature was written into the docstring of axes.legend(),
 but not yet implemented.
+
+
+Added "figure.titlesize" and "figure.titleweight" keys to rcParams
+``````````````````````````````````````````````````````````````````
+
+Two new keys were added to rcParams to control the default font size and weight
+used by the figure title (as emitted by ``pyplot.suptitle()``).

lib/matplotlib/figure.py

@@ -518,12 +518,17 @@ def suptitle(self, t, **kwargs):
         """
         x = kwargs.pop('x', 0.5)
         y = kwargs.pop('y', 0.98)
+
         if ('horizontalalignment' not in kwargs) and ('ha' not in kwargs):
             kwargs['horizontalalignment'] = 'center'
-
         if ('verticalalignment' not in kwargs) and ('va' not in kwargs):
             kwargs['verticalalignment'] = 'top'
 
+        if 'fontsize' not in kwargs:
+            kwargs['fontsize'] = rcParams['figure.titlesize']
+        if 'fontweight' not in kwargs:
+            kwargs['fontweight'] = rcParams['figure.titleweight']
+
         sup = self.text(x, y, t, **kwargs)
         if self._suptitle is not None:
             self._suptitle.set_text(t)

lib/matplotlib/rcsetup.py

@@ -692,6 +692,10 @@ def __call__(self, s):
 
 
     ## figure props
+    # figure title
+    'figure.titlesize':   ['medium', validate_fontsize],
+    'figure.titleweight': ['normal', six.text_type],
+
     # figure size in inches: width by height
     'figure.figsize':    [[8.0, 6.0], validate_nseq_float(2)],
     'figure.dpi':        [80, validate_float],   # DPI

matplotlibrc.template

@@ -326,6 +326,8 @@ backend      : %(backend)s
 
 ### FIGURE
 # See http://matplotlib.org/api/figure_api.html#matplotlib.figure.Figure
+#figure.titlesize : medium     # size of the figure title
+#figure.titleweight : normal   # weight of the figure title
 #figure.figsize   : 8, 6    # figure size in inches
 #figure.dpi       : 80      # figure dots per inch
 #figure.facecolor : 0.75    # figure facecolor; 0.75 is scalar gray