Merge pull request #6328 from benjamincongdon/ft-scatter-marker-rc

tacaswell · tacaswell · commit ad81e3f37a49 · 2016-04-28T22:14:17.000-04:00
Add default scatter marker option to rcParams
diff --git a/doc/users/whats_new/rcparams.rst b/doc/users/whats_new/rcparams.rst
@@ -16,6 +16,8 @@ Configuration (rcParams)
 +----------------------------+--------------------------------------------------+
 |`date.autoformatter.second` | format string for 'second' scale times           |
 +----------------------------+--------------------------------------------------+
+|`scatter.marker`            | default marker for scatter plot                  |
++----------------------------+--------------------------------------------------+
 |`svg.hashsalt`              | see note                                         |
 +----------------------------+--------------------------------------------------+
 
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -3732,7 +3732,7 @@ def dopatch(xs, ys, **kwargs):
                                         'facecolors', 'color'],
                          label_namer="y")
     @docstring.dedent_interpd
-    def scatter(self, x, y, s=None, c=None, marker='o', cmap=None, norm=None,
+    def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
                 vmin=None, vmax=None, alpha=None, linewidths=None,
                 verts=None, edgecolors=None,
                 **kwargs):
@@ -3903,6 +3903,10 @@ def scatter(self, x, y, s=None, c=None, marker='o', cmap=None, norm=None,
 
         scales = s   # Renamed for readability below.
 
+        # load default marker from rcParams
+        if marker is None:
+            marker = rcParams['scatter.marker']
+
         # to be API compatible
         if marker is None and not (verts is None):
             marker = (verts, 0)
diff --git a/lib/matplotlib/mpl-data/stylelib/classic.mplstyle b/lib/matplotlib/mpl-data/stylelib/classic.mplstyle
@@ -325,6 +325,9 @@ contour.corner_mask : True
 # errorbar props
 errorbar.capsize: 3
 
+# scatter props
+scatter.marker: o
+
 ### Boxplots
 boxplot.bootstrap: None
 boxplot.boxprops.color: b
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -3231,7 +3231,7 @@ def quiverkey(*args, **kw):
 # This function was autogenerated by boilerplate.py.  Do not edit as
 # changes will be lost
 @_autogen_docstring(Axes.scatter)
-def scatter(x, y, s=None, c=None, marker='o', cmap=None, norm=None, vmin=None,
+def scatter(x, y, s=None, c=None, marker=None, cmap=None, norm=None, vmin=None,
             vmax=None, alpha=None, linewidths=None, verts=None, edgecolors=None,
             hold=None, data=None, **kwargs):
     ax = gca()
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
@@ -1053,6 +1053,10 @@ def validate_hist_bins(s):
     'polaraxes.grid': [True, validate_bool],  # display polar grid or
                                                      # not
     'axes3d.grid': [True, validate_bool],  # display 3d grid
+
+    # scatter props
+    'scatter.marker': ['o', six.text_type],
+
     # TODO validate that these are valid datetime format strings
     'date.autoformatter.year': ['%Y', six.text_type],
     'date.autoformatter.month': ['%Y-%m', six.text_type],
diff --git a/matplotlibrc.template b/matplotlibrc.template
@@ -461,6 +461,9 @@ backend      : $TEMPLATE_BACKEND
                                   # If Numpy 1.11 or later is
                                   # installed, may also be `auto`
 
+### SCATTER PLOTS
+#scatter.marker : o               # The default marker type for scatter plots.
+
 ### Agg rendering
 ### Warning: experimental, 2008/10/10
 #agg.path.chunksize : 0           # 0 to disable; values in the range
