From 66cbdf60046f6f1b6911988dce1073f33361181a Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Tue, 3 Jan 2017 17:05:05 +0100
Subject: [PATCH 01/35] add minimal errorbar3d method to Axes3D

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 106 +++++++++++++++++++++++++++++
 1 file changed, 106 insertions(+)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index cfd645c880a3..be97ba20ba29 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2770,6 +2770,112 @@ def permutation_matrices(n):
 
         return polygons
 
+    def errorbar3d(self, x, y, z, zerr=None, yerr=None, xerr=None,
+                   ecolor=None,
+                   # FIXME: doesn't work
+                   elinewidth=None,
+
+                   # TODO: sneak these in
+                   #capsize=None, fmt='',
+                   #barsabove=False, lolims=False, uplims=False,
+                   #xlolims=False, xuplims=False, errorevery=1, capthick=None,
+
+                   **kwargs):
+        # TODO: minimal example
+        # TODO: double-check the docstring
+        """
+        Draws error bars on an Axis3D instance.
+
+        Parameters
+        ----------
+        x : scalar
+        y : scalar
+        z : scalar
+
+        xerr/yerr/zerr : scalar or array-like, shape(n,1) or shape(2,n).
+            If a scalar number, len(N) array-like object, or an Nx1
+            array-like object, errorbars are drawn at +/-value relative
+            to the data. Default is None.
+
+            If a sequence of shape 2xN, errorbars are drawn at -row1
+            and +row2 relative to the data.
+
+        ecolor : mpl color, optional, default: None
+            A matplotlib color arg which gives the color the errorbar lines;
+            if None, use the color of the line connecting the markers.
+
+        elinewidth : scalar, optional, default: None
+            The linewidth of the errorbar lines. If None, use the linewidth.
+
+        Keyword arguments are passed to
+        :func:`~mpl_toolkits.mplot3d.art3d.Line3DCollection`
+        """
+        had_data = self.has_data()
+
+        if not cbook.iterable(x):
+            x = [x]
+        if not cbook.iterable(y):
+            y = [y]
+        if not cbook.iterable(z):
+            z = [z]
+
+        ecolors = []
+        if ecolor is None:
+            ecolor = [self._get_patches_for_fill.get_next_color()]
+
+        # FIXME: doesn't work
+        if len(ecolor) == len(x):
+            for c in ecolor:
+                ecolors.extend([c] * 6)
+        else:
+            # a single color specified, or face colors specified explicitly
+            ecolors = list(mcolors.to_rgba_array(ecolor))
+            if len(ecolors) < len(x):
+                ecolors *= (6 * len(x))
+
+        # FIXME: doesn't work
+        elinewidth = kwargs.get('elinewidth', None)
+
+        def unpack_errs(data, err):
+            lefts = [coord - dcoord for coord, dcoord in zip(data, err)]
+            rights = [coord + dcoord for coord, dcoord in zip(data, err)]
+            return lefts, rights
+
+        lines, coorderrs = [], []
+        for data, err, shift in zip([x, y, z],
+                                    [xerr, yerr, zerr],
+                                    range(3)):
+            if err is None:
+                continue
+
+            if not cbook.iterable(err):
+                err = [err] * len(data)
+
+            # TODO: placeholder for future work on limits functionality
+            nolims = np.ones_like(err, dtype=bool)
+
+            if nolims.any():
+                rolling_mask=np.roll([1.,0.,0.], shift)
+                if err is not None:
+                    err = np.atleast_1d(err)
+                coorderr = [unpack_errs(coord, err*rolling_mask[i])
+                          for i, coord in enumerate([x, y, z])]
+                line = art3d.Line3DCollection(segments=np.array(coorderr).T,
+                                              linewidths=elinewidth,
+                                              colors=ecolors, **kwargs)
+                self.add_collection(line)
+                lines.append(line)
+                coorderrs.append(coorderr)
+
+        coorderrs = np.array(coorderrs)
+        minx, maxx = (coorderrs[:,0,:,:].min(), coorderrs[:,1,:,:].max())
+        miny, maxy = (coorderrs[:,1,:,:].min(), coorderrs[:,1,:,:].max())
+        minz, maxz = (coorderrs[:,2,:,:].min(), coorderrs[:,2,:,:].max())
+        self.auto_scale_xyz((minx, maxx), (miny, maxy), (minz, maxz), had_data)
+
+        # TODO: return one list instead of three maybe?
+        return lines
+
 
 docstring.interpd.update(Axes3D=artist.kwdoc(Axes3D))
 docstring.dedent_interpd(Axes3D.__init__)

From d8e4d578f001cbea2990cf3ed49a42bee86370d4 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Tue, 3 Jan 2017 17:26:04 +0100
Subject: [PATCH 02/35] for now it's wiser to rely on LineCollection styling

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 32 +-----------------------------
 1 file changed, 1 insertion(+), 31 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index be97ba20ba29..7c847c4707b6 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2771,17 +2771,12 @@ def permutation_matrices(n):
         return polygons
 
     def errorbar3d(self, x, y, z, zerr=None, yerr=None, xerr=None,
-                   ecolor=None,
-                   # FIXME: doesn't work
-                   elinewidth=None,
-
                    # TODO: sneak these in
                    #capsize=None, fmt='',
                    #barsabove=False, lolims=False, uplims=False,
                    #xlolims=False, xuplims=False, errorevery=1, capthick=None,
 
                    **kwargs):
-        # TODO: minimal example
         # TODO: double-check the docstring
         """
         Draws error bars on an Axis3D instance.
@@ -2800,13 +2795,6 @@ def errorbar3d(self, x, y, z, zerr=None, yerr=None, xerr=None,
             If a sequence of shape 2xN, errorbars are drawn at -row1
             and +row2 relative to the data.
 
-        ecolor : mpl color, optional, default: None
-            A matplotlib color arg which gives the color the errorbar lines;
-            if None, use the color of the line connecting the markers.
-
-        elinewidth : scalar, optional, default: None
-            The linewidth of the errorbar lines. If None, use the linewidth.
-
         Keyword arguments are passed to
         :func:`~mpl_toolkits.mplot3d.art3d.Line3DCollection`
         """
@@ -2819,23 +2807,6 @@ def errorbar3d(self, x, y, z, zerr=None, yerr=None, xerr=None,
         if not cbook.iterable(z):
             z = [z]
 
-        ecolors = []
-        if ecolor is None:
-            ecolor = [self._get_patches_for_fill.get_next_color()]
-
-        # FIXME: doesn't work
-        if len(ecolor) == len(x):
-            for c in ecolor:
-                ecolors.extend([c] * 6)
-        else:
-            # a single color specified, or face colors specified explicitly
-            ecolors = list(mcolors.to_rgba_array(ecolor))
-            if len(ecolors) < len(x):
-                ecolors *= (6 * len(x))
-
-        # FIXME: doesn't work
-        elinewidth = kwargs.get('elinewidth', None)
-
         def unpack_errs(data, err):
             lefts = [coord - dcoord for coord, dcoord in zip(data, err)]
             rights = [coord + dcoord for coord, dcoord in zip(data, err)]
@@ -2861,8 +2832,7 @@ def unpack_errs(data, err):
                 coorderr = [unpack_errs(coord, err*rolling_mask[i])
                           for i, coord in enumerate([x, y, z])]
                 line = art3d.Line3DCollection(segments=np.array(coorderr).T,
-                                              linewidths=elinewidth,
-                                              colors=ecolors, **kwargs)
+                                              **kwargs)
                 self.add_collection(line)
                 lines.append(line)
                 coorderrs.append(coorderr)

From 2d32dfe9f7f4ac572ac335066d309a56fb1090d2 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Tue, 3 Jan 2017 17:32:25 +0100
Subject: [PATCH 03/35] type in autorange

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 7c847c4707b6..6043ffd4c100 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2838,7 +2838,7 @@ def unpack_errs(data, err):
                 coorderrs.append(coorderr)
 
         coorderrs = np.array(coorderrs)
-        minx, maxx = (coorderrs[:,0,:,:].min(), coorderrs[:,1,:,:].max())
+        minx, maxx = (coorderrs[:,0,:,:].min(), coorderrs[:,0,:,:].max())
         miny, maxy = (coorderrs[:,1,:,:].min(), coorderrs[:,1,:,:].max())
         minz, maxz = (coorderrs[:,2,:,:].min(), coorderrs[:,2,:,:].max())
         self.auto_scale_xyz((minx, maxx), (miny, maxy), (minz, maxz), had_data)

From 8e661932e6951a889a509e08729d8534df819fd8 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Wed, 4 Jan 2017 13:51:59 +0100
Subject: [PATCH 04/35] fix for auto-scaling NaN values

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 6043ffd4c100..59ab931ff445 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2807,6 +2807,7 @@ def errorbar3d(self, x, y, z, zerr=None, yerr=None, xerr=None,
         if not cbook.iterable(z):
             z = [z]
 
+        # TODO: currently, only a scalar number or len(N) objects are ok...
         def unpack_errs(data, err):
             lefts = [coord - dcoord for coord, dcoord in zip(data, err)]
             rights = [coord + dcoord for coord, dcoord in zip(data, err)]
@@ -2825,6 +2826,11 @@ def unpack_errs(data, err):
             # TODO: placeholder for future work on limits functionality
             nolims = np.ones_like(err, dtype=bool)
 
+            # NOTE: care needs to be taken here - using numpy is fine,
+            #       as long as the actual data plotted stays as lists.
+            #       This is due to unit preservation issues
+            #       (c.f. 2d errorbar case).
+            # FIXME: the above NOTE is violated below...
             if nolims.any():
                 rolling_mask=np.roll([1.,0.,0.], shift)
                 if err is not None:
@@ -2838,9 +2844,15 @@ def unpack_errs(data, err):
                 coorderrs.append(coorderr)
 
         coorderrs = np.array(coorderrs)
-        minx, maxx = (coorderrs[:,0,:,:].min(), coorderrs[:,0,:,:].max())
-        miny, maxy = (coorderrs[:,1,:,:].min(), coorderrs[:,1,:,:].max())
-        minz, maxz = (coorderrs[:,2,:,:].min(), coorderrs[:,2,:,:].max())
+        def digout_minmax(err_arr, coord_label):
+            """ For brevity """
+            key = {'x': 0, 'y': 1, 'z': 2}
+            return (np.nanmin(err_arr[:, key[coord_label], :, :]),
+                    np.nanmax(err_arr[:, key[coord_label], :, :]) )
+
+        minx, maxx = digout_minmax(coorderrs, 'x')
+        miny, maxy = digout_minmax(coorderrs, 'y')
+        minz, maxz = digout_minmax(coorderrs, 'z')
         self.auto_scale_xyz((minx, maxx), (miny, maxy), (minz, maxz), had_data)
 
         # TODO: return one list instead of three maybe?

From d3779428cbf2c93925065434349ba2cce8fda9f1 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Thu, 5 Jan 2017 17:25:06 +0100
Subject: [PATCH 05/35] add caplines

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 156 +++++++++++++++++++++++------
 1 file changed, 124 insertions(+), 32 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 59ab931ff445..545c7459e1c5 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2772,11 +2772,18 @@ def permutation_matrices(n):
 
     def errorbar3d(self, x, y, z, zerr=None, yerr=None, xerr=None,
                    # TODO: sneak these in
-                   #capsize=None, fmt='',
-                   #barsabove=False, lolims=False, uplims=False,
-                   #xlolims=False, xuplims=False, errorevery=1, capthick=None,
+                   #fmt='',
+                   #barsabove=False,
+
+                   errorevery=1,
+                   capsize=None, capthick=None,
+                   xlolims=False, xuplims=False,
+                   ylolims=False, yuplims=False,
+                   zlolims=False, zuplims=False,
 
                    **kwargs):
+        # TODO: write up a jupyter notebook using this as a template:
+        # http://matplotlib.org/examples/pylab_examples/errorbar_limits.html
         # TODO: double-check the docstring
         """
         Draws error bars on an Axis3D instance.
@@ -2795,6 +2802,25 @@ def errorbar3d(self, x, y, z, zerr=None, yerr=None, xerr=None,
             If a sequence of shape 2xN, errorbars are drawn at -row1
             and +row2 relative to the data.
 
+        capsize : scalar, optional, default: None
+            The length of the error bar caps in points; if None, it will
+            take the value from ``errorbar.capsize``
+            :data:`rcParam<matplotlib.rcParams>`.
+
+        capthick : scalar, optional, default: None
+            An alias kwarg to markeredgewidth (a.k.a. - mew). This
+            setting is a more sensible name for the property that
+            controls the thickness of the error bar cap in points. For
+            backwards compatibility, if mew or markeredgewidth are given,
+            then they will over-ride capthick. This may change in future
+            releases.
+
+        errorevery : positive integer, optional, default:1
+            subsamples the errorbars. e.g., if errorevery=5, errorbars for
+            every 5-th datapoint will be plotted. The data plot itself still
+            shows all data points.
+
+
         Keyword arguments are passed to
         :func:`~mpl_toolkits.mplot3d.art3d.Line3DCollection`
         """
@@ -2807,56 +2833,122 @@ def errorbar3d(self, x, y, z, zerr=None, yerr=None, xerr=None,
         if not cbook.iterable(z):
             z = [z]
 
+        everymask = np.arange(len(x)) % errorevery == 0
+
+        # TODO: fully adhere to the styling rules in 2d-errorbar later on...
+        eb_cap_style = {}
+        if capsize is None:
+            capsize = kwargs.pop('capsize', rcParams["errorbar.capsize"])
+        if capsize > 0:
+            eb_cap_style['markersize'] = 2. * capsize
+        if capthick is not None:
+            eb_cap_style['markeredgewidth'] = capthick
+
+        def _bool_asarray_helper(d, expected):
+            if not cbook.iterable(d):
+                return np.asarray([d] * expected, bool)
+            else:
+                return np.asarray(d, bool)
+
+        def _mask_lists(xs, ys, zs, mask=None):
+            """ Applies a mask to three lists. """
+            xs = [l for l, m in zip(xs, mask) if m]
+            ys = [l for l, m in zip(ys, mask) if m]
+            zs = [l for l, m in zip(zs, mask) if m]
+            return xs, ys, zs
+
+        def _debug_floatlists(*args):
+            for l in args:
+                s = ("["+', '.join(['%.2f']*len(l))+"]") % tuple(l)
+                print(s)
+            print('\n')
+
         # TODO: currently, only a scalar number or len(N) objects are ok...
-        def unpack_errs(data, err):
-            lefts = [coord - dcoord for coord, dcoord in zip(data, err)]
-            rights = [coord + dcoord for coord, dcoord in zip(data, err)]
-            return lefts, rights
-
-        lines, coorderrs = [], []
-        for data, err, shift in zip([x, y, z],
-                                    [xerr, yerr, zerr],
-                                    range(3)):
+        def _unpack_errs(data, err, lomask, himask):
+            lows =  [d - e if m else d for d, e, m in zip(data, err, lomask)]
+            highs = [d + e if m else d for d, e, m in zip(data, err, himask)]
+            return lows, highs
+
+        # TODO: things to init are barcaps and low-, high-limits
+        errlines, caplines  = [], []
+        coorderrs = [] # list of endpoint coordinates, used for auto-scaling
+
+        for data, err, shift, lolims, uplims in zip([x, y, z],
+                                    [xerr, yerr, zerr], range(3),
+                                    [xlolims, ylolims, zlolims],
+                                    [xuplims, yuplims, zuplims]):
             if err is None:
                 continue
 
             if not cbook.iterable(err):
                 err = [err] * len(data)
+            lolims = _bool_asarray_helper(lolims, len(x))
+            uplims = _bool_asarray_helper(uplims, len(x))
 
-            # TODO: placeholder for future work on limits functionality
-            nolims = np.ones_like(err, dtype=bool)
+            nolims = ~(lolims | uplims)
 
             # NOTE: care needs to be taken here - using numpy is fine,
             #       as long as the actual data plotted stays as lists.
             #       This is due to unit preservation issues
-            #       (c.f. 2d errorbar case).
-            # FIXME: the above NOTE is violated below...
+            #       (c.f. the 2d errorbar case).
+            rolling_mask = np.roll([1.,0.,0.], shift)
+            # TODO: why is this here?
+            if err is not None:
+                err = np.atleast_1d(err)
+
+            # a nested list structure that expands to (xl,xh),(yl,yh),(zl,zh),
+            # where x/y/z and l/h correspond to dimensions and low/high
+            # positions of errorbars in a dimension we're looping over
+            coorderr = [_unpack_errs(coord, err*rolling_mask[i], ~lolims,
+                        ~uplims) for i, coord in enumerate([x, y, z])]
+
             if nolims.any():
-                rolling_mask=np.roll([1.,0.,0.], shift)
-                if err is not None:
-                    err = np.atleast_1d(err)
-                coorderr = [unpack_errs(coord, err*rolling_mask[i])
-                          for i, coord in enumerate([x, y, z])]
-                line = art3d.Line3DCollection(segments=np.array(coorderr).T,
-                                              **kwargs)
-                self.add_collection(line)
-                lines.append(line)
-                coorderrs.append(coorderr)
+                if capsize > 0:
+                    (xl, xh), (yl, yh), (zl, zh) = coorderr
+                    lo_caps_xyz = _mask_lists(xl, yl, zl, nolims & everymask)
+                    hi_caps_xyz = _mask_lists(xh, yh, zh, nolims & everymask)
+                    #_debug_floatlists(*lo_caps_xyz)
+                    #_debug_floatlists(*hi_caps_xyz)
+
+                    # NOTE on the caps in 3D plots:
+                    # Using markers in interactive 3D plots is confusing to
+                    # say the least, as the cap lines don't stay aligned with
+                    # the coordinate axes!
+                    # Nevertheless, let's stick to it for now for consistency.
+                    # Setting '_' for z-caps and '|' for x- and y-caps:
+                    capmarker = {0: '|', 1: '|', 2: '_'}
+                    cap_lo = art3d.Line3D(*lo_caps_xyz, ls='',
+                                          marker=capmarker[shift],
+                                          **eb_cap_style)
+                    cap_hi = art3d.Line3D(*hi_caps_xyz, ls='',
+                                          marker=capmarker[shift],
+                                          **eb_cap_style)
+                    self.add_line(cap_lo)
+                    self.add_line(cap_hi)
+                    caplines.append(cap_lo)
+                    caplines.append(cap_hi)
+
+            errline = art3d.Line3DCollection(np.array(coorderr).T, **kwargs)
+            self.add_collection(errline)
+            errlines.append(errline)
+            coorderrs.append(coorderr)
 
         coorderrs = np.array(coorderrs)
-        def digout_minmax(err_arr, coord_label):
-            """ For brevity """
+        def _digout_minmax(err_arr, coord_label):
             key = {'x': 0, 'y': 1, 'z': 2}
             return (np.nanmin(err_arr[:, key[coord_label], :, :]),
                     np.nanmax(err_arr[:, key[coord_label], :, :]) )
 
-        minx, maxx = digout_minmax(coorderrs, 'x')
-        miny, maxy = digout_minmax(coorderrs, 'y')
-        minz, maxz = digout_minmax(coorderrs, 'z')
+        minx, maxx = _digout_minmax(coorderrs, 'x')
+        miny, maxy = _digout_minmax(coorderrs, 'y')
+        minz, maxz = _digout_minmax(coorderrs, 'z')
         self.auto_scale_xyz((minx, maxx), (miny, maxy), (minz, maxz), had_data)
 
         # TODO: return one list instead of three maybe?
-        return lines
+        # TODO: make a container of sorts? There's going to be a whole bunch
+        #       of artist objects bundled together here, with all the lines,
+        #       caps, and upper/lower limit arrow indicators...
+        return errlines
 
 
 docstring.interpd.update(Axes3D=artist.kwdoc(Axes3D))

From 9b1de1fcab3c02d6f3e49ee0bb932ce8535752fd Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Thu, 5 Jan 2017 17:46:22 +0100
Subject: [PATCH 06/35] add barsabove option; refactor plotting kwargs

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 51 ++++++++++++++++++------------
 1 file changed, 30 insertions(+), 21 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 545c7459e1c5..b37ee8617526 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2770,21 +2770,19 @@ def permutation_matrices(n):
 
         return polygons
 
-    def errorbar3d(self, x, y, z, zerr=None, yerr=None, xerr=None,
-                   # TODO: sneak these in
-                   #fmt='',
-                   #barsabove=False,
-
-                   errorevery=1,
-                   capsize=None, capthick=None,
-                   xlolims=False, xuplims=False,
-                   ylolims=False, yuplims=False,
-                   zlolims=False, zuplims=False,
-
-                   **kwargs):
-        # TODO: write up a jupyter notebook using this as a template:
+    # NOTE: is it ok to redefine Axes.errorbar method?
+    #       some methods seem to append '3d' to the end instead?
+    def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None,
+                 # TODO: sneak this kwarg in:
+                 #fmt='',
+                 barsabove=False, errorevery=1,
+                 capsize=None, capthick=None, xlolims=False, xuplims=False,
+                 ylolims=False, yuplims=False, zlolims=False, zuplims=False,
+                 **kwargs):
+        # TODO: write up a proof of concept analogous to this one here:
         # http://matplotlib.org/examples/pylab_examples/errorbar_limits.html
-        # TODO: double-check the docstring
+        # TODO: triple-check the docstring: some data forms are probably not
+        #       going to work despite being allowed in the docstring :C
         """
         Draws error bars on an Axis3D instance.
 
@@ -2815,13 +2813,16 @@ def errorbar3d(self, x, y, z, zerr=None, yerr=None, xerr=None,
             then they will over-ride capthick. This may change in future
             releases.
 
+        barsabove : bool, optional, default: False
+            if True , will plot the errorbars above the plot
+            symbols. Default is below.
+
         errorevery : positive integer, optional, default:1
             subsamples the errorbars. e.g., if errorevery=5, errorbars for
             every 5-th datapoint will be plotted. The data plot itself still
             shows all data points.
 
-
-        Keyword arguments are passed to
+        Additional keyword arguments for styling errorbar lines are passed to
         :func:`~mpl_toolkits.mplot3d.art3d.Line3DCollection`
         """
         had_data = self.has_data()
@@ -2836,6 +2837,13 @@ def errorbar3d(self, x, y, z, zerr=None, yerr=None, xerr=None,
         everymask = np.arange(len(x)) % errorevery == 0
 
         # TODO: fully adhere to the styling rules in 2d-errorbar later on...
+        plot_line_style = {}
+        plot_line_style.update(**kwargs)
+        if barsabove:
+            plot_line_style['zorder'] = kwargs['zorder'] - .1
+        else:
+            plot_line_style['zorder'] = kwargs['zorder'] + .1
+
         eb_cap_style = {}
         if capsize is None:
             capsize = kwargs.pop('capsize', rcParams["errorbar.capsize"])
@@ -2873,7 +2881,7 @@ def _unpack_errs(data, err, lomask, himask):
         errlines, caplines  = [], []
         coorderrs = [] # list of endpoint coordinates, used for auto-scaling
 
-        for data, err, shift, lolims, uplims in zip([x, y, z],
+        for data, err, i_xyz, lolims, uplims in zip([x, y, z],
                                     [xerr, yerr, zerr], range(3),
                                     [xlolims, ylolims, zlolims],
                                     [xuplims, yuplims, zuplims]):
@@ -2891,7 +2899,7 @@ def _unpack_errs(data, err, lomask, himask):
             #       as long as the actual data plotted stays as lists.
             #       This is due to unit preservation issues
             #       (c.f. the 2d errorbar case).
-            rolling_mask = np.roll([1.,0.,0.], shift)
+            rolling_mask = np.roll([1.,0.,0.], i_xyz)
             # TODO: why is this here?
             if err is not None:
                 err = np.atleast_1d(err)
@@ -2918,17 +2926,18 @@ def _unpack_errs(data, err, lomask, himask):
                     # Setting '_' for z-caps and '|' for x- and y-caps:
                     capmarker = {0: '|', 1: '|', 2: '_'}
                     cap_lo = art3d.Line3D(*lo_caps_xyz, ls='',
-                                          marker=capmarker[shift],
+                                          marker=capmarker[i_xyz],
                                           **eb_cap_style)
                     cap_hi = art3d.Line3D(*hi_caps_xyz, ls='',
-                                          marker=capmarker[shift],
+                                          marker=capmarker[i_xyz],
                                           **eb_cap_style)
                     self.add_line(cap_lo)
                     self.add_line(cap_hi)
                     caplines.append(cap_lo)
                     caplines.append(cap_hi)
 
-            errline = art3d.Line3DCollection(np.array(coorderr).T, **kwargs)
+            errline = art3d.Line3DCollection(np.array(coorderr).T,
+                                             **plot_line_style)
             self.add_collection(errline)
             errlines.append(errline)
             coorderrs.append(coorderr)

From c7fc68a76d4356425e98b82a234eeec078a06cb3 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Thu, 5 Jan 2017 17:59:19 +0100
Subject: [PATCH 07/35] fix for missing zorder in kwargs

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index b37ee8617526..08c9eb5c1794 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2839,6 +2839,8 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None,
         # TODO: fully adhere to the styling rules in 2d-errorbar later on...
         plot_line_style = {}
         plot_line_style.update(**kwargs)
+        if 'zorder' not in kwargs.keys():
+            kwargs['zorder'] = 2
         if barsabove:
             plot_line_style['zorder'] = kwargs['zorder'] - .1
         else:

From ef5699cd10e7ed0afa9cb395ed3078bc9ee99c35 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Mon, 6 Feb 2017 14:11:54 +0100
Subject: [PATCH 08/35] add upper/lower limits

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 50 +++++++++++++++++++++++++++---
 1 file changed, 46 insertions(+), 4 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 08c9eb5c1794..91395373a1e2 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2770,7 +2770,7 @@ def permutation_matrices(n):
 
         return polygons
 
-    # NOTE: is it ok to redefine Axes.errorbar method?
+    # TODO: is it ok to redefine Axes.errorbar method?
     #       some methods seem to append '3d' to the end instead?
     def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None,
                  # TODO: sneak this kwarg in:
@@ -2778,6 +2778,7 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None,
                  barsabove=False, errorevery=1,
                  capsize=None, capthick=None, xlolims=False, xuplims=False,
                  ylolims=False, yuplims=False, zlolims=False, zuplims=False,
+                 debug_kwargs = {},
                  **kwargs):
         # TODO: write up a proof of concept analogous to this one here:
         # http://matplotlib.org/examples/pylab_examples/errorbar_limits.html
@@ -2867,7 +2868,16 @@ def _mask_lists(xs, ys, zs, mask=None):
             zs = [l for l, m in zip(zs, mask) if m]
             return xs, ys, zs
 
-        def _debug_floatlists(*args):
+        def _debug_floatlists(*args, **kwargs):
+            if 'crash' in kwargs:
+                crash = kwargs.pop('crash')
+                if crash:
+                    raise RuntimeError('you asked for it!')
+            if 'set_trace' in kwargs:
+                set_trace = kwargs.pop('set_trace')
+                if set_trace:
+                    import pdb
+                    pdb.set_trace()
             for l in args:
                 s = ("["+', '.join(['%.2f']*len(l))+"]") % tuple(l)
                 print(s)
@@ -2911,10 +2921,21 @@ def _unpack_errs(data, err, lomask, himask):
             # positions of errorbars in a dimension we're looping over
             coorderr = [_unpack_errs(coord, err*rolling_mask[i], ~lolims,
                         ~uplims) for i, coord in enumerate([x, y, z])]
+            (xl, xh), (yl, yh), (zl, zh) = coorderr
+
+            # define the markers used for errorbar caps and limits below
+            # the dicitonary key is the current ticking value of `i_xyz`
+            capmarker = {0: '|', 1: '|', 2: '_'}
+            limmarker = {0: {'lower': art3d.lines.CARETRIGHT,
+                             'upper': art3d.lines.CARETLEFT},
+                         1: {'lower': art3d.lines.CARETRIGHT,
+                             'upper': art3d.lines.CARETLEFT},
+                         2: {'lower': art3d.lines.CARETUP,
+                             'upper': art3d.lines.CARETDOWN},
+                         }
 
             if nolims.any():
                 if capsize > 0:
-                    (xl, xh), (yl, yh), (zl, zh) = coorderr
                     lo_caps_xyz = _mask_lists(xl, yl, zl, nolims & everymask)
                     hi_caps_xyz = _mask_lists(xh, yh, zh, nolims & everymask)
                     #_debug_floatlists(*lo_caps_xyz)
@@ -2926,7 +2947,6 @@ def _unpack_errs(data, err, lomask, himask):
                     # the coordinate axes!
                     # Nevertheless, let's stick to it for now for consistency.
                     # Setting '_' for z-caps and '|' for x- and y-caps:
-                    capmarker = {0: '|', 1: '|', 2: '_'}
                     cap_lo = art3d.Line3D(*lo_caps_xyz, ls='',
                                           marker=capmarker[i_xyz],
                                           **eb_cap_style)
@@ -2938,6 +2958,28 @@ def _unpack_errs(data, err, lomask, himask):
                     caplines.append(cap_lo)
                     caplines.append(cap_hi)
 
+            if (lolims | uplims).any():
+                # FIXME: using markers for limits isn't the best idea: for
+                #        example, 180 deg rotation around z-axis would flip
+                #        the markers around... However, this solution is
+                #        spiritually close to that of 2d errorbar function
+                limits = [_unpack_errs(coord, err*rolling_mask[i], uplims,
+                          lolims) for i, coord in enumerate([x, y, z])]
+                (xlo, xup), (ylo, yup), (zlo, zup) = limits
+
+                lolims_xyz = _mask_lists(xup, yup, zup, lolims & everymask)
+                uplims_xyz = _mask_lists(xlo, ylo, zlo, uplims & everymask)
+                _debug_floatlists(*lolims_xyz, **debug_kwargs)
+
+                lims_lo = art3d.Line3D(*lolims_xyz, ls='',
+                                       marker=limmarker[i_xyz]['lower'],
+                                       **eb_cap_style)
+                lims_up = art3d.Line3D(*uplims_xyz, ls='',
+                                       marker=limmarker[i_xyz]['upper'],
+                                       **eb_cap_style)
+                self.add_line(lims_lo)
+                self.add_line(lims_up)
+
             errline = art3d.Line3DCollection(np.array(coorderr).T,
                                              **plot_line_style)
             self.add_collection(errline)

From d4f67c21444a72a80ca96509555df6306c8e1d3e Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Mon, 6 Feb 2017 15:47:18 +0100
Subject: [PATCH 09/35] add extended formatting from the 2d case; clean-up

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 109 ++++++++++++++++++++---------
 1 file changed, 75 insertions(+), 34 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 91395373a1e2..b17333aa719b 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -28,6 +28,8 @@
 from matplotlib.axes._base import _axis_method_wrapper
 from matplotlib.transforms import Bbox
 from matplotlib.tri.triangulation import Triangulation
+from matplotlib.colors import Normalize, LightSource
+from matplotlib.axes._base import _process_plot_format
 
 from . import art3d
 from . import proj3d
@@ -2770,20 +2772,12 @@ def permutation_matrices(n):
 
         return polygons
 
-    # TODO: is it ok to redefine Axes.errorbar method?
-    #       some methods seem to append '3d' to the end instead?
-    def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None,
-                 # TODO: sneak this kwarg in:
-                 #fmt='',
-                 barsabove=False, errorevery=1,
+    def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
+                 barsabove=False, errorevery=1, ecolor=None, elinewidth=None,
                  capsize=None, capthick=None, xlolims=False, xuplims=False,
                  ylolims=False, yuplims=False, zlolims=False, zuplims=False,
                  debug_kwargs = {},
                  **kwargs):
-        # TODO: write up a proof of concept analogous to this one here:
-        # http://matplotlib.org/examples/pylab_examples/errorbar_limits.html
-        # TODO: triple-check the docstring: some data forms are probably not
-        #       going to work despite being allowed in the docstring :C
         """
         Draws error bars on an Axis3D instance.
 
@@ -2801,6 +2795,20 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None,
             If a sequence of shape 2xN, errorbars are drawn at -row1
             and +row2 relative to the data.
 
+        fmt : plot format string, optional, default: None
+            The plot format symbol. If fmt is 'none' (case-insensitive),
+            only the errorbars are plotted.  This is used for adding
+            errorbars to a bar plot, for example.  Default is '',
+            an empty plot format string; properties are
+            then identical to the defaults for :meth:`plot`.
+
+        ecolor : mpl color, optional, default: None
+            A matplotlib color arg which gives the color the errorbar lines;
+            if None, use the color of the line connecting the markers.
+
+        elinewidth : scalar, optional, default: None
+            The linewidth of the errorbar lines. If None, use the linewidth.
+
         capsize : scalar, optional, default: None
             The length of the error bar caps in points; if None, it will
             take the value from ``errorbar.capsize``
@@ -2835,10 +2843,52 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None,
         if not cbook.iterable(z):
             z = [z]
 
+        if fmt is None:
+            fmt = 'none'
+            msg = ('Use of None object as fmt keyword argument to ' +
+                   'suppress plotting of data values is deprecated ' +
+                   'since 1.4; use the string "none" instead.')
+            warnings.warn(msg)
+
+        plot_line = (fmt.lower() != 'none')
+        label = kwargs.pop("label", None)
+
+        fmt_style_kwargs = {k: v for k, v in
+                            zip(('linestyle', 'marker', 'color'),
+                                _process_plot_format(fmt)) if v is not None}
+
+        if ('color' in kwargs or 'color' in fmt_style_kwargs or
+                ecolor is not None):
+            base_style = {}
+            if 'color' in kwargs:
+                base_style['color'] = kwargs.pop('color')
+        else:
+            base_style = six.next(self._get_lines.prop_cycler)
+
+        base_style.update(fmt_style_kwargs)
+        if 'color' not in base_style:
+            base_style['color'] = 'C0'
+        if ecolor is None:
+            ecolor = base_style['color']
+
+        # make the style dict for the line collections (the bars)
+        eb_lines_style = dict(base_style)
+        eb_lines_style.pop('marker', None)
+        eb_lines_style.pop('linestyle', None)
+        eb_lines_style['color'] = ecolor
+
+        if elinewidth:
+            eb_lines_style['linewidth'] = elinewidth
+        elif 'linewidth' in kwargs:
+            eb_lines_style['linewidth'] = kwargs['linewidth']
+
+        for key in ('transform', 'alpha', 'zorder', 'rasterized'):
+            if key in kwargs:
+                eb_lines_style[key] = kwargs[key]
+
         everymask = np.arange(len(x)) % errorevery == 0
 
-        # TODO: fully adhere to the styling rules in 2d-errorbar later on...
-        plot_line_style = {}
+        plot_line_style = dict(base_style)
         plot_line_style.update(**kwargs)
         if 'zorder' not in kwargs.keys():
             kwargs['zorder'] = 2
@@ -2847,7 +2897,12 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None,
         else:
             plot_line_style['zorder'] = kwargs['zorder'] + .1
 
-        eb_cap_style = {}
+        # set up cap style dictionary
+        eb_cap_style = dict(base_style)
+        # eject any marker information from format string
+        eb_cap_style.pop('marker', None)
+        eb_cap_style.pop('ls', None)
+        eb_cap_style['linestyle'] = 'none'
         if capsize is None:
             capsize = kwargs.pop('capsize', rcParams["errorbar.capsize"])
         if capsize > 0:
@@ -2855,6 +2910,10 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None,
         if capthick is not None:
             eb_cap_style['markeredgewidth'] = capthick
 
+        if plot_line:
+            data_line = art3d.Line3D(x, y, z, **plot_line_style)
+            self.add_line(data_line)
+
         def _bool_asarray_helper(d, expected):
             if not cbook.iterable(d):
                 return np.asarray([d] * expected, bool)
@@ -2868,21 +2927,6 @@ def _mask_lists(xs, ys, zs, mask=None):
             zs = [l for l, m in zip(zs, mask) if m]
             return xs, ys, zs
 
-        def _debug_floatlists(*args, **kwargs):
-            if 'crash' in kwargs:
-                crash = kwargs.pop('crash')
-                if crash:
-                    raise RuntimeError('you asked for it!')
-            if 'set_trace' in kwargs:
-                set_trace = kwargs.pop('set_trace')
-                if set_trace:
-                    import pdb
-                    pdb.set_trace()
-            for l in args:
-                s = ("["+', '.join(['%.2f']*len(l))+"]") % tuple(l)
-                print(s)
-            print('\n')
-
         # TODO: currently, only a scalar number or len(N) objects are ok...
         def _unpack_errs(data, err, lomask, himask):
             lows =  [d - e if m else d for d, e, m in zip(data, err, lomask)]
@@ -2931,15 +2975,12 @@ def _unpack_errs(data, err, lomask, himask):
                          1: {'lower': art3d.lines.CARETRIGHT,
                              'upper': art3d.lines.CARETLEFT},
                          2: {'lower': art3d.lines.CARETUP,
-                             'upper': art3d.lines.CARETDOWN},
-                         }
+                             'upper': art3d.lines.CARETDOWN}}
 
             if nolims.any():
                 if capsize > 0:
                     lo_caps_xyz = _mask_lists(xl, yl, zl, nolims & everymask)
                     hi_caps_xyz = _mask_lists(xh, yh, zh, nolims & everymask)
-                    #_debug_floatlists(*lo_caps_xyz)
-                    #_debug_floatlists(*hi_caps_xyz)
 
                     # NOTE on the caps in 3D plots:
                     # Using markers in interactive 3D plots is confusing to
@@ -2969,7 +3010,6 @@ def _unpack_errs(data, err, lomask, himask):
 
                 lolims_xyz = _mask_lists(xup, yup, zup, lolims & everymask)
                 uplims_xyz = _mask_lists(xlo, ylo, zlo, uplims & everymask)
-                _debug_floatlists(*lolims_xyz, **debug_kwargs)
 
                 lims_lo = art3d.Line3D(*lolims_xyz, ls='',
                                        marker=limmarker[i_xyz]['lower'],
@@ -2981,7 +3021,8 @@ def _unpack_errs(data, err, lomask, himask):
                 self.add_line(lims_up)
 
             errline = art3d.Line3DCollection(np.array(coorderr).T,
-                                             **plot_line_style)
+                                             label = label,
+                                             **eb_lines_style)
             self.add_collection(errline)
             errlines.append(errline)
             coorderrs.append(coorderr)

From 3b3e5d46e6ecd6260f8966b18914aba300a13fc5 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Mon, 6 Feb 2017 17:05:30 +0100
Subject: [PATCH 10/35] pep8 edits

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index b17333aa719b..28448f05749b 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2776,7 +2776,6 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
                  barsabove=False, errorevery=1, ecolor=None, elinewidth=None,
                  capsize=None, capthick=None, xlolims=False, xuplims=False,
                  ylolims=False, yuplims=False, zlolims=False, zuplims=False,
-                 debug_kwargs = {},
                  **kwargs):
         """
         Draws error bars on an Axis3D instance.
@@ -2929,13 +2928,14 @@ def _mask_lists(xs, ys, zs, mask=None):
 
         # TODO: currently, only a scalar number or len(N) objects are ok...
         def _unpack_errs(data, err, lomask, himask):
-            lows =  [d - e if m else d for d, e, m in zip(data, err, lomask)]
+            lows = [d - e if m else d for d, e, m in zip(data, err, lomask)]
             highs = [d + e if m else d for d, e, m in zip(data, err, himask)]
             return lows, highs
 
         # TODO: things to init are barcaps and low-, high-limits
-        errlines, caplines  = [], []
-        coorderrs = [] # list of endpoint coordinates, used for auto-scaling
+        errlines, caplines = [], []
+        # List of endpoint coordinates, used for auto-scaling
+        coorderrs = []
 
         for data, err, i_xyz, lolims, uplims in zip([x, y, z],
                                     [xerr, yerr, zerr], range(3),
@@ -3021,17 +3021,18 @@ def _unpack_errs(data, err, lomask, himask):
                 self.add_line(lims_up)
 
             errline = art3d.Line3DCollection(np.array(coorderr).T,
-                                             label = label,
+                                             label=label,
                                              **eb_lines_style)
             self.add_collection(errline)
             errlines.append(errline)
             coorderrs.append(coorderr)
 
         coorderrs = np.array(coorderrs)
+
         def _digout_minmax(err_arr, coord_label):
             key = {'x': 0, 'y': 1, 'z': 2}
             return (np.nanmin(err_arr[:, key[coord_label], :, :]),
-                    np.nanmax(err_arr[:, key[coord_label], :, :]) )
+                    np.nanmax(err_arr[:, key[coord_label], :, :]))
 
         minx, maxx = _digout_minmax(coorderrs, 'x')
         miny, maxy = _digout_minmax(coorderrs, 'y')

From 6889a3dbf27b837f86aa0b54854a2068837c213a Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Tue, 7 Feb 2017 17:52:43 +0100
Subject: [PATCH 11/35] fix errorevery; return a container of sorts

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 28448f05749b..c1b99dc5f68b 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2932,8 +2932,7 @@ def _unpack_errs(data, err, lomask, himask):
             highs = [d + e if m else d for d, e, m in zip(data, err, himask)]
             return lows, highs
 
-        # TODO: things to init are barcaps and low-, high-limits
-        errlines, caplines = [], []
+        errlines, caplines, limmarks = [], [], []
         # List of endpoint coordinates, used for auto-scaling
         coorderrs = []
 
@@ -2963,8 +2962,9 @@ def _unpack_errs(data, err, lomask, himask):
             # a nested list structure that expands to (xl,xh),(yl,yh),(zl,zh),
             # where x/y/z and l/h correspond to dimensions and low/high
             # positions of errorbars in a dimension we're looping over
-            coorderr = [_unpack_errs(coord, err*rolling_mask[i], ~lolims,
-                        ~uplims) for i, coord in enumerate([x, y, z])]
+            coorderr = [_unpack_errs(coord, err*rolling_mask[i],
+                        ~lolims & everymask, ~uplims & everymask)
+                        for i, coord in enumerate([x, y, z])]
             (xl, xh), (yl, yh), (zl, zh) = coorderr
 
             # define the markers used for errorbar caps and limits below
@@ -3019,6 +3019,8 @@ def _unpack_errs(data, err, lomask, himask):
                                        **eb_cap_style)
                 self.add_line(lims_lo)
                 self.add_line(lims_up)
+                limmarks.append(lims_lo)
+                limmarks.append(lims_up)
 
             errline = art3d.Line3DCollection(np.array(coorderr).T,
                                              label=label,
@@ -3039,12 +3041,7 @@ def _digout_minmax(err_arr, coord_label):
         minz, maxz = _digout_minmax(coorderrs, 'z')
         self.auto_scale_xyz((minx, maxx), (miny, maxy), (minz, maxz), had_data)
 
-        # TODO: return one list instead of three maybe?
-        # TODO: make a container of sorts? There's going to be a whole bunch
-        #       of artist objects bundled together here, with all the lines,
-        #       caps, and upper/lower limit arrow indicators...
-        return errlines
-
+        return errlines, caplines, limmarks
 
 docstring.interpd.update(Axes3D=artist.kwdoc(Axes3D))
 docstring.dedent_interpd(Axes3D.__init__)

From 20f0caf04731ceb322635e83bf7a50fa8eb7d2ce Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Tue, 7 Feb 2017 18:17:45 +0100
Subject: [PATCH 12/35] allow offsets for errorevery

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 25 ++++++++++++++++++++-----
 1 file changed, 20 insertions(+), 5 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index c1b99dc5f68b..23ca9009ab2a 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2825,10 +2825,14 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             if True , will plot the errorbars above the plot
             symbols. Default is below.
 
-        errorevery : positive integer, optional, default:1
-            subsamples the errorbars. e.g., if errorevery=5, errorbars for
-            every 5-th datapoint will be plotted. The data plot itself still
-            shows all data points.
+        errorevery: positive integer or tuple of integers
+            draws error bars on a subset of the data. errorevery=skip draws
+            error bars on the points (x[::skip], y[::skip]).
+            errorevery=(skip,shift) draws error bars on the points
+            (x[skip%%shift::skip], y[shift%%skip::skip]). e.g. errorevery=(6,3)
+            adds error bars to the data at (x[3], x[9], x[15], x[21], ...).
+            Used to avoid overlapping error bars when two series share x-axis
+            values.
 
         Additional keyword arguments for styling errorbar lines are passed to
         :func:`~mpl_toolkits.mplot3d.art3d.Line3DCollection`
@@ -2885,7 +2889,18 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             if key in kwargs:
                 eb_lines_style[key] = kwargs[key]
 
-        everymask = np.arange(len(x)) % errorevery == 0
+        try:
+            errorevery, offset = errorevery
+        except TypeError:
+            offset = 0
+
+        int_msg = 'errorevery must be positive integer or tuple of integers'
+        if errorevery < 1 or int(errorevery) != errorevery:
+            raise ValueError(int_msg)
+        if int(offset) != offset:
+            raise ValueError(int_msg)
+
+        everymask = (np.arange(len(x)) - offset) % errorevery == 0
 
         plot_line_style = dict(base_style)
         plot_line_style.update(**kwargs)

From cd635933955c10b6b10b9f3d21832d3e73dc8466 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Tue, 7 Feb 2017 22:06:54 +0100
Subject: [PATCH 13/35] arrrr pep8 again

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 23ca9009ab2a..2573f752f019 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -3058,6 +3058,7 @@ def _digout_minmax(err_arr, coord_label):
 
         return errlines, caplines, limmarks
 
+
 docstring.interpd.update(Axes3D=artist.kwdoc(Axes3D))
 docstring.dedent_interpd(Axes3D.__init__)
 

From fb2d200cc335c437e855fe52c53fdfd1a9d3d48f Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Thu, 9 Feb 2017 17:29:50 +0100
Subject: [PATCH 14/35] docstring edits

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 2573f752f019..933501e393a2 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2825,14 +2825,21 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             if True , will plot the errorbars above the plot
             symbols. Default is below.
 
+        xlolims / ylolims / zlolims : bool, optional, default:None
+            These arguments can be used to indicate that a value gives
+            only lower limits. In that case a caret symbol is being
+            drawn to indicate this. lims-arguments may be of the same
+            type as *xerr* and *yerr*.
+
+        xuplims / yuplims / zuplims : bool, optional, default:None
+            Same as above, but for controlling the upper limits.
+
         errorevery: positive integer or tuple of integers
             draws error bars on a subset of the data. errorevery=skip draws
-            error bars on the points (x[::skip], y[::skip]).
+            error bars on the [::skip] intervals. If a tuple of integers,
             errorevery=(skip,shift) draws error bars on the points
-            (x[skip%%shift::skip], y[shift%%skip::skip]). e.g. errorevery=(6,3)
+            selected as [skip%%shift::skip]. e.g. errorevery=(6,3)
             adds error bars to the data at (x[3], x[9], x[15], x[21], ...).
-            Used to avoid overlapping error bars when two series share x-axis
-            values.
 
         Additional keyword arguments for styling errorbar lines are passed to
         :func:`~mpl_toolkits.mplot3d.art3d.Line3DCollection`

From 74f5209b2393624126a5ddbe1174a8f9f9f0f03e Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Thu, 9 Feb 2017 17:32:09 +0100
Subject: [PATCH 15/35] add example; update what's new section

---
 doc/users/whats_new/errorbars_3d.rst |  7 +++++++
 examples/mplot3d/errorbars_demo.py   | 31 ++++++++++++++++++++++++++++
 2 files changed, 38 insertions(+)
 create mode 100644 doc/users/whats_new/errorbars_3d.rst
 create mode 100644 examples/mplot3d/errorbars_demo.py

diff --git a/doc/users/whats_new/errorbars_3d.rst b/doc/users/whats_new/errorbars_3d.rst
new file mode 100644
index 000000000000..3286f4a37f07
--- /dev/null
+++ b/doc/users/whats_new/errorbars_3d.rst
@@ -0,0 +1,7 @@
+Errorbar method for mplot3d
+------------------------
+
+The errorbar function :meth:`matplotlib.axes._axes.Axes.errorbar` is ported
+into the `mplot3d` framework in its entirety. Supports features such as custom
+styling for error lines and cap marks, control over erorrbar spacing, upper and
+lower limit marks.
diff --git a/examples/mplot3d/errorbars_demo.py b/examples/mplot3d/errorbars_demo.py
new file mode 100644
index 000000000000..56e8a7ce4ff4
--- /dev/null
+++ b/examples/mplot3d/errorbars_demo.py
@@ -0,0 +1,31 @@
+'''
+An example of using errorbars in mplot3d
+'''
+
+from mpl_toolkits.mplot3d import Axes3D
+import matplotlib.pyplot as plt
+import numpy as np
+
+fig = plt.figure()
+ax = fig.gca(projection='3d')
+
+# setting up a parametric curve
+t = np.arange(0, 2*np.pi+.1, 0.01)
+x, y, z = np.sin(t), np.cos(3*t), np.sin(5*t)
+
+fig_zerr_kwargs = dict(zerr=0.2, capsize=2)
+fig_xerr_kwargs = dict(xerr=0.2, errorevery=(2,2))
+
+estep = 15
+zuplims = [True if (not i%estep and i//estep%3==0)
+                else False for i in range(t.size)]
+zlolims = [True if (not i%estep and i//estep%3==2)
+                else False for i in range(t.size)]
+
+ax.errorbar(x, y, z, 0.2, zuplims=zuplims, zlolims=zlolims, errorevery=estep)
+
+ax.set_xlabel("X label")
+ax.set_ylabel("Y label")
+ax.set_zlabel("Z label")
+
+plt.show()

From 82dec2b757e25de93cecb5d933bff0ee3d0b5fcb Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Thu, 9 Feb 2017 18:05:10 +0100
Subject: [PATCH 16/35] please just squash everything - I can't pep8 properly

---
 examples/mplot3d/errorbars_demo.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/examples/mplot3d/errorbars_demo.py b/examples/mplot3d/errorbars_demo.py
index 56e8a7ce4ff4..6dd6832c46f0 100644
--- a/examples/mplot3d/errorbars_demo.py
+++ b/examples/mplot3d/errorbars_demo.py
@@ -14,13 +14,13 @@
 x, y, z = np.sin(t), np.cos(3*t), np.sin(5*t)
 
 fig_zerr_kwargs = dict(zerr=0.2, capsize=2)
-fig_xerr_kwargs = dict(xerr=0.2, errorevery=(2,2))
+fig_xerr_kwargs = dict(xerr=0.2, errorevery=(2, 2))
 
 estep = 15
-zuplims = [True if (not i%estep and i//estep%3==0)
-                else False for i in range(t.size)]
-zlolims = [True if (not i%estep and i//estep%3==2)
-                else False for i in range(t.size)]
+zuplims = [True if (not i % estep and i // estep % 3 == 0)
+           else False for i in range(t.size)]
+zlolims = [True if (not i % estep and i // estep % 3 == 2)
+           else False for i in range(t.size)]
 
 ax.errorbar(x, y, z, 0.2, zuplims=zuplims, zlolims=zlolims, errorevery=estep)
 
@@ -29,3 +29,4 @@
 ax.set_zlabel("Z label")
 
 plt.show()
+

From c570c69a5cca312c44d0df5bb35c301c5fce99d2 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Thu, 9 Feb 2017 18:33:51 +0100
Subject: [PATCH 17/35] vim adds a newline behind the scenes already

---
 examples/mplot3d/errorbars_demo.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/examples/mplot3d/errorbars_demo.py b/examples/mplot3d/errorbars_demo.py
index 6dd6832c46f0..06ccf12035ef 100644
--- a/examples/mplot3d/errorbars_demo.py
+++ b/examples/mplot3d/errorbars_demo.py
@@ -29,4 +29,3 @@
 ax.set_zlabel("Z label")
 
 plt.show()
-

From c30c276a7a95fe83045410a4e434fd3d3c93f900 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Thu, 16 Apr 2020 15:00:45 +0200
Subject: [PATCH 18/35] rebase against current master + fix dropped
 deprecations

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 47 ++++++++++++++++--------------
 1 file changed, 25 insertions(+), 22 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 933501e393a2..7daadb81156b 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -12,6 +12,7 @@
 
 from collections import defaultdict
 from functools import reduce
+import logging
 import math
 import textwrap
 
@@ -25,16 +26,16 @@
 import matplotlib.docstring as docstring
 import matplotlib.scale as mscale
 from matplotlib.axes import Axes, rcParams
-from matplotlib.axes._base import _axis_method_wrapper
+from matplotlib.axes._base import _axis_method_wrapper, _process_plot_format
 from matplotlib.transforms import Bbox
 from matplotlib.tri.triangulation import Triangulation
-from matplotlib.colors import Normalize, LightSource
-from matplotlib.axes._base import _process_plot_format
 
 from . import art3d
 from . import proj3d
 from . import axis3d
 
+_log = logging.getLogger(__name__)
+
 
 @cbook.deprecated("3.2", alternative="Bbox.unit()")
 def unit_bbox():
@@ -2846,11 +2847,11 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
         """
         had_data = self.has_data()
 
-        if not cbook.iterable(x):
+        if not np.iterable(x):
             x = [x]
-        if not cbook.iterable(y):
+        if not np.iterable(y):
             y = [y]
-        if not cbook.iterable(z):
+        if not np.iterable(z):
             z = [z]
 
         if fmt is None:
@@ -2858,7 +2859,7 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             msg = ('Use of None object as fmt keyword argument to ' +
                    'suppress plotting of data values is deprecated ' +
                    'since 1.4; use the string "none" instead.')
-            warnings.warn(msg)
+            _log.warning(msg)
 
         plot_line = (fmt.lower() != 'none')
         label = kwargs.pop("label", None)
@@ -2873,7 +2874,7 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             if 'color' in kwargs:
                 base_style['color'] = kwargs.pop('color')
         else:
-            base_style = six.next(self._get_lines.prop_cycler)
+            base_style = next(self._get_lines.prop_cycler)
 
         base_style.update(fmt_style_kwargs)
         if 'color' not in base_style:
@@ -2936,10 +2937,10 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             self.add_line(data_line)
 
         def _bool_asarray_helper(d, expected):
-            if not cbook.iterable(d):
+            if not np.iterable(d):
                 return np.asarray([d] * expected, bool)
-            else:
-                return np.asarray(d, bool)
+
+            return np.asarray(d, bool)
 
         def _mask_lists(xs, ys, zs, mask=None):
             """ Applies a mask to three lists. """
@@ -2958,14 +2959,14 @@ def _unpack_errs(data, err, lomask, himask):
         # List of endpoint coordinates, used for auto-scaling
         coorderrs = []
 
-        for data, err, i_xyz, lolims, uplims in zip([x, y, z],
-                                    [xerr, yerr, zerr], range(3),
-                                    [xlolims, ylolims, zlolims],
-                                    [xuplims, yuplims, zuplims]):
+        for data, err, i_xyz, lolims, uplims in zip(
+                [x, y, z], [xerr, yerr, zerr], range(3),
+                [xlolims, ylolims, zlolims], [xuplims, yuplims, zuplims]):
+
             if err is None:
                 continue
 
-            if not cbook.iterable(err):
+            if not np.iterable(err):
                 err = [err] * len(data)
             lolims = _bool_asarray_helper(lolims, len(x))
             uplims = _bool_asarray_helper(uplims, len(x))
@@ -2976,7 +2977,7 @@ def _unpack_errs(data, err, lomask, himask):
             #       as long as the actual data plotted stays as lists.
             #       This is due to unit preservation issues
             #       (c.f. the 2d errorbar case).
-            rolling_mask = np.roll([1.,0.,0.], i_xyz)
+            rolling_mask = np.roll([1., 0., 0.], i_xyz)
             # TODO: why is this here?
             if err is not None:
                 err = np.atleast_1d(err)
@@ -2984,9 +2985,10 @@ def _unpack_errs(data, err, lomask, himask):
             # a nested list structure that expands to (xl,xh),(yl,yh),(zl,zh),
             # where x/y/z and l/h correspond to dimensions and low/high
             # positions of errorbars in a dimension we're looping over
-            coorderr = [_unpack_errs(coord, err*rolling_mask[i],
-                        ~lolims & everymask, ~uplims & everymask)
-                        for i, coord in enumerate([x, y, z])]
+            coorderr = [
+                _unpack_errs(coord, err * rolling_mask[i],
+                             ~lolims & everymask, ~uplims & everymask)
+                for i, coord in enumerate([x, y, z])]
             (xl, xh), (yl, yh), (zl, zh) = coorderr
 
             # define the markers used for errorbar caps and limits below
@@ -3026,8 +3028,9 @@ def _unpack_errs(data, err, lomask, himask):
                 #        example, 180 deg rotation around z-axis would flip
                 #        the markers around... However, this solution is
                 #        spiritually close to that of 2d errorbar function
-                limits = [_unpack_errs(coord, err*rolling_mask[i], uplims,
-                          lolims) for i, coord in enumerate([x, y, z])]
+                limits = [
+                    _unpack_errs(coord, err*rolling_mask[i], uplims, lolims)
+                    for i, coord in enumerate([x, y, z])]
                 (xlo, xup), (ylo, yup), (zlo, zup) = limits
 
                 lolims_xyz = _mask_lists(xup, yup, zup, lolims & everymask)

From f5ef8bd24e00a9051a45f5eb07db0ceb268fa5b7 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Fri, 17 Apr 2020 17:52:23 +0200
Subject: [PATCH 19/35] fix compatibility issues with 2d errorbar version (WIP)

* Integrate errorbar 2d changes since 2017
* Integrate the merged updated errorevery behavior
* Remove the deprecation warning for fmt=None
* Fix ecolor working for lines but not for caps
* Fix broken cycler + ecolor behavior
---
 doc/users/whats_new/errorbars_3d.rst |   2 +-
 lib/mpl_toolkits/mplot3d/axes3d.py   | 239 ++++++++++++++-------------
 2 files changed, 123 insertions(+), 118 deletions(-)

diff --git a/doc/users/whats_new/errorbars_3d.rst b/doc/users/whats_new/errorbars_3d.rst
index 3286f4a37f07..99820890bf1e 100644
--- a/doc/users/whats_new/errorbars_3d.rst
+++ b/doc/users/whats_new/errorbars_3d.rst
@@ -1,5 +1,5 @@
 Errorbar method for mplot3d
-------------------------
+---------------------------
 
 The errorbar function :meth:`matplotlib.axes._axes.Axes.errorbar` is ported
 into the `mplot3d` framework in its entirety. Supports features such as custom
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 7daadb81156b..dc1e329c78ff 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -12,7 +12,6 @@
 
 from collections import defaultdict
 from functools import reduce
-import logging
 import math
 import textwrap
 
@@ -34,8 +33,6 @@
 from . import proj3d
 from . import axis3d
 
-_log = logging.getLogger(__name__)
-
 
 @cbook.deprecated("3.2", alternative="Bbox.unit()")
 def unit_bbox():
@@ -2779,97 +2776,95 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
                  ylolims=False, yuplims=False, zlolims=False, zuplims=False,
                  **kwargs):
         """
-        Draws error bars on an Axis3D instance.
+        Plot lines and/or markers with errorbars around them.
+
+        *x*/*y*/*z* define the data locations, and *xerr*/*yerr*/*zerr* define
+        the errorbar sizes. By default, this draws the data markers/lines as
+        well the errorbars. Use fmt='none' to draw errorbars only.
 
         Parameters
         ----------
-        x : scalar
-        y : scalar
-        z : scalar
-
-        xerr/yerr/zerr : scalar or array-like, shape(n,1) or shape(2,n).
-            If a scalar number, len(N) array-like object, or an Nx1
-            array-like object, errorbars are drawn at +/-value relative
-            to the data. Default is None.
-
-            If a sequence of shape 2xN, errorbars are drawn at -row1
-            and +row2 relative to the data.
-
-        fmt : plot format string, optional, default: None
-            The plot format symbol. If fmt is 'none' (case-insensitive),
-            only the errorbars are plotted.  This is used for adding
-            errorbars to a bar plot, for example.  Default is '',
-            an empty plot format string; properties are
-            then identical to the defaults for :meth:`plot`.
-
-        ecolor : mpl color, optional, default: None
-            A matplotlib color arg which gives the color the errorbar lines;
-            if None, use the color of the line connecting the markers.
-
-        elinewidth : scalar, optional, default: None
-            The linewidth of the errorbar lines. If None, use the linewidth.
-
-        capsize : scalar, optional, default: None
-            The length of the error bar caps in points; if None, it will
-            take the value from ``errorbar.capsize``
-            :data:`rcParam<matplotlib.rcParams>`.
-
-        capthick : scalar, optional, default: None
-            An alias kwarg to markeredgewidth (a.k.a. - mew). This
-            setting is a more sensible name for the property that
+        x, y, z : scalar or array-like
+            The data positions.
+
+        xerr, yerr, zerr : scalar or array-like, optional
+            The errorbar sizes:
+            - scalar: Symmetric +/- values for all data points.
+            - shape(N,): Symmetric +/-values for each data point.
+            - shape(2, N): Separate - and + values for each bar. First row
+              contains the lower errors, the second row contains the upper
+              errors.
+            - *None*: No errorbar.
+
+        fmt : str, default: ''
+            The format for the data points / data lines. See `.plot` for
+            details.
+
+            Use 'none' (case insensitive) to plot errorbars without any data
+            markers.
+
+        ecolor : color, default: None
+            The color of the errorbar lines.  If None, use the color of the
+            line connecting the markers.
+
+        elinewidth : scalar, default: None
+            The linewidth of the errorbar lines. If None, the linewidth of
+            the current style is used.
+
+        capsize : scalar, default: :rc:`errorbar.capsize`
+            The length of the error bar caps in points.
+
+        capthick : scalar, default: None
+            An alias to the keyword argument *markeredgewidth* (a.k.a. *mew*).
+            This setting is a more sensible name for the property that
             controls the thickness of the error bar cap in points. For
-            backwards compatibility, if mew or markeredgewidth are given,
-            then they will over-ride capthick. This may change in future
+            backwards compatibility, if *mew* or *markeredgewidth* are given,
+            then they will over-ride *capthick*. This may change in future
             releases.
 
-        barsabove : bool, optional, default: False
-            if True , will plot the errorbars above the plot
+        barsabove : bool, default: False
+            If True, will plot the errorbars above the plot
             symbols. Default is below.
 
-        xlolims / ylolims / zlolims : bool, optional, default:None
+        xlolims, ylolims, zlolims : bool, default: False
             These arguments can be used to indicate that a value gives
             only lower limits. In that case a caret symbol is being
             drawn to indicate this. lims-arguments may be of the same
             type as *xerr* and *yerr*.
 
-        xuplims / yuplims / zuplims : bool, optional, default:None
+        xuplims, yuplims, zuplims : bool, default: False
             Same as above, but for controlling the upper limits.
 
-        errorevery: positive integer or tuple of integers
-            draws error bars on a subset of the data. errorevery=skip draws
-            error bars on the [::skip] intervals. If a tuple of integers,
-            errorevery=(skip,shift) draws error bars on the points
-            selected as [skip%%shift::skip]. e.g. errorevery=(6,3)
-            adds error bars to the data at (x[3], x[9], x[15], x[21], ...).
+        errorevery : int or (int, int), default: 1
+            draws error bars on a subset of the data. *errorevery* =N draws
+            error bars on the points (x[::N], y[::N]).
+            *errorevery* =(start, N) draws error bars on the points
+            (x[start::N], y[start::N]). e.g. errorevery=(6, 3)
+            adds error bars to the data at (x[6], x[9], x[12], x[15], ...).
+            Used to avoid overlapping error bars when two series share x-axis
+            values.
 
         Additional keyword arguments for styling errorbar lines are passed to
-        :func:`~mpl_toolkits.mplot3d.art3d.Line3DCollection`
+        `~mpl_toolkits.mplot3d.art3d.Line3DCollection`
         """
         had_data = self.has_data()
 
-        if not np.iterable(x):
-            x = [x]
-        if not np.iterable(y):
-            y = [y]
-        if not np.iterable(z):
-            z = [z]
-
-        if fmt is None:
-            fmt = 'none'
-            msg = ('Use of None object as fmt keyword argument to ' +
-                   'suppress plotting of data values is deprecated ' +
-                   'since 1.4; use the string "none" instead.')
-            _log.warning(msg)
-
         plot_line = (fmt.lower() != 'none')
         label = kwargs.pop("label", None)
 
-        fmt_style_kwargs = {k: v for k, v in
-                            zip(('linestyle', 'marker', 'color'),
-                                _process_plot_format(fmt)) if v is not None}
+        if fmt == '':
+            fmt_style_kwargs = {}
+        else:
+            fmt_style_kwargs = {k: v for k, v in
+                                zip(('linestyle', 'marker', 'color'),
+                                    _process_plot_format(fmt))
+                                if v is not None}
+
+        if fmt == 'none':
+            # Remove alpha=0 color that _process_plot_format returns
+            fmt_style_kwargs.pop('color')
 
-        if ('color' in kwargs or 'color' in fmt_style_kwargs or
-                ecolor is not None):
+        if ('color' in kwargs or 'color' in fmt_style_kwargs):
             base_style = {}
             if 'color' in kwargs:
                 base_style['color'] = kwargs.pop('color')
@@ -2882,9 +2877,28 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
         if ecolor is None:
             ecolor = base_style['color']
 
+        # make sure all the args are iterable; use lists not arrays to
+        # preserve units
+        x = x if np.iterable(x) else [x]
+        y = y if np.iterable(y) else [y]
+        z = z if np.iterable(z) else [z]
+
+        # make the style dict for the 'normal' plot line
+        if 'zorder' not in kwargs:
+            kwargs['zorder'] = 2
+        plot_line_style = {
+            **base_style,
+            **kwargs,
+            'zorder': (kwargs['zorder'] - .1 if barsabove else
+                       kwargs['zorder'] + .1),
+        }
+
         # make the style dict for the line collections (the bars)
         eb_lines_style = dict(base_style)
         eb_lines_style.pop('marker', None)
+        eb_lines_style.pop('markerfacecolor', None)
+        eb_lines_style.pop('markeredgewidth', None)
+        eb_lines_style.pop('markeredgecolor', None)
         eb_lines_style.pop('linestyle', None)
         eb_lines_style['color'] = ecolor
 
@@ -2897,29 +2911,7 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             if key in kwargs:
                 eb_lines_style[key] = kwargs[key]
 
-        try:
-            errorevery, offset = errorevery
-        except TypeError:
-            offset = 0
-
-        int_msg = 'errorevery must be positive integer or tuple of integers'
-        if errorevery < 1 or int(errorevery) != errorevery:
-            raise ValueError(int_msg)
-        if int(offset) != offset:
-            raise ValueError(int_msg)
-
-        everymask = (np.arange(len(x)) - offset) % errorevery == 0
-
-        plot_line_style = dict(base_style)
-        plot_line_style.update(**kwargs)
-        if 'zorder' not in kwargs.keys():
-            kwargs['zorder'] = 2
-        if barsabove:
-            plot_line_style['zorder'] = kwargs['zorder'] - .1
-        else:
-            plot_line_style['zorder'] = kwargs['zorder'] + .1
-
-        # set up cap style dictionary
+        # make the style dict for cap collections (the "hats")
         eb_cap_style = dict(base_style)
         # eject any marker information from format string
         eb_cap_style.pop('marker', None)
@@ -2931,16 +2923,25 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             eb_cap_style['markersize'] = 2. * capsize
         if capthick is not None:
             eb_cap_style['markeredgewidth'] = capthick
+        eb_cap_style['color'] = ecolor
 
         if plot_line:
             data_line = art3d.Line3D(x, y, z, **plot_line_style)
             self.add_line(data_line)
 
-        def _bool_asarray_helper(d, expected):
-            if not np.iterable(d):
-                return np.asarray([d] * expected, bool)
+        try:
+            offset, errorevery = errorevery
+        except TypeError:
+            offset = 0
+
+        if errorevery < 1 or int(errorevery) != errorevery:
+            raise ValueError(
+                'errorevery must be positive integer or tuple of integers')
+        if int(offset) != offset:
+            raise ValueError("errorevery's starting index must be an integer")
 
-            return np.asarray(d, bool)
+        everymask = np.zeros(len(x), bool)
+        everymask[offset::errorevery] = True
 
         def _mask_lists(xs, ys, zs, mask=None):
             """ Applies a mask to three lists. """
@@ -2949,8 +2950,8 @@ def _mask_lists(xs, ys, zs, mask=None):
             zs = [l for l, m in zip(zs, mask) if m]
             return xs, ys, zs
 
-        # TODO: currently, only a scalar number or len(N) objects are ok...
-        def _unpack_errs(data, err, lomask, himask):
+        # TODO: errors can be only a scalar number or len(N) array-like
+        def _unpack_errs(err, data, lomask, himask):
             lows = [d - e if m else d for d, e, m in zip(data, err, lomask)]
             highs = [d + e if m else d for d, e, m in zip(data, err, himask)]
             return lows, highs
@@ -2959,6 +2960,17 @@ def _unpack_errs(data, err, lomask, himask):
         # List of endpoint coordinates, used for auto-scaling
         coorderrs = []
 
+        # define the markers used for errorbar caps and limits below
+        # the dictionary key is the current ticking value of `i_xyz`
+        capmarker = {0: '|', 1: '|', 2: '_'}
+        limmarker = {0: {'lower': art3d.lines.CARETRIGHT,
+                         'upper': art3d.lines.CARETLEFT},
+                     1: {'lower': art3d.lines.CARETRIGHT,
+                         'upper': art3d.lines.CARETLEFT},
+                     2: {'lower': art3d.lines.CARETUP,
+                         'upper': art3d.lines.CARETDOWN}}
+
+        # i_xyz determines which coordinate is currently being looped over
         for data, err, i_xyz, lolims, uplims in zip(
                 [x, y, z], [xerr, yerr, zerr], range(3),
                 [xlolims, ylolims, zlolims], [xuplims, yuplims, zuplims]):
@@ -2968,8 +2980,13 @@ def _unpack_errs(data, err, lomask, himask):
 
             if not np.iterable(err):
                 err = [err] * len(data)
-            lolims = _bool_asarray_helper(lolims, len(x))
-            uplims = _bool_asarray_helper(uplims, len(x))
+
+            # FIXME: err data is not supposed to be transformed into arrays!
+            err = np.atleast_1d(err)
+
+            # arrays fine here, they are booleans and hence not units
+            lolims = np.broadcast_to(lolims, len(data)).astype(bool)
+            uplims = np.broadcast_to(uplims, len(data)).astype(bool)
 
             nolims = ~(lolims | uplims)
 
@@ -2977,30 +2994,17 @@ def _unpack_errs(data, err, lomask, himask):
             #       as long as the actual data plotted stays as lists.
             #       This is due to unit preservation issues
             #       (c.f. the 2d errorbar case).
-            rolling_mask = np.roll([1., 0., 0.], i_xyz)
-            # TODO: why is this here?
-            if err is not None:
-                err = np.atleast_1d(err)
+            rolling_mask = np.roll([1, 0, 0], i_xyz)
 
             # a nested list structure that expands to (xl,xh),(yl,yh),(zl,zh),
             # where x/y/z and l/h correspond to dimensions and low/high
             # positions of errorbars in a dimension we're looping over
             coorderr = [
-                _unpack_errs(coord, err * rolling_mask[i],
+                _unpack_errs(err * rolling_mask[i], coord,
                              ~lolims & everymask, ~uplims & everymask)
                 for i, coord in enumerate([x, y, z])]
             (xl, xh), (yl, yh), (zl, zh) = coorderr
 
-            # define the markers used for errorbar caps and limits below
-            # the dicitonary key is the current ticking value of `i_xyz`
-            capmarker = {0: '|', 1: '|', 2: '_'}
-            limmarker = {0: {'lower': art3d.lines.CARETRIGHT,
-                             'upper': art3d.lines.CARETLEFT},
-                         1: {'lower': art3d.lines.CARETRIGHT,
-                             'upper': art3d.lines.CARETLEFT},
-                         2: {'lower': art3d.lines.CARETUP,
-                             'upper': art3d.lines.CARETDOWN}}
-
             if nolims.any():
                 if capsize > 0:
                     lo_caps_xyz = _mask_lists(xl, yl, zl, nolims & everymask)
@@ -3029,7 +3033,7 @@ def _unpack_errs(data, err, lomask, himask):
                 #        the markers around... However, this solution is
                 #        spiritually close to that of 2d errorbar function
                 limits = [
-                    _unpack_errs(coord, err*rolling_mask[i], uplims, lolims)
+                    _unpack_errs(err*rolling_mask[i], coord, uplims, lolims)
                     for i, coord in enumerate([x, y, z])]
                 (xlo, xup), (ylo, yup), (zlo, zup) = limits
 
@@ -3056,6 +3060,7 @@ def _unpack_errs(data, err, lomask, himask):
 
         coorderrs = np.array(coorderrs)
 
+        # TODO: errors can be only a scalar number or len(N) array-like
         def _digout_minmax(err_arr, coord_label):
             key = {'x': 0, 'y': 1, 'z': 2}
             return (np.nanmin(err_arr[:, key[coord_label], :, :]),

From c3fa54282c7132c793b15da2583c3e23c0ff9d98 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Wed, 22 Apr 2020 16:24:12 +0200
Subject: [PATCH 20/35] fix flake8 warnings, mirror naming/docstring style of
 other examples

---
 examples/mplot3d/{errorbars_demo.py => errorbar3d.py} | 11 +++++++----
 lib/mpl_toolkits/mplot3d/axes3d.py                    |  2 +-
 2 files changed, 8 insertions(+), 5 deletions(-)
 rename examples/mplot3d/{errorbars_demo.py => errorbar3d.py} (85%)

diff --git a/examples/mplot3d/errorbars_demo.py b/examples/mplot3d/errorbar3d.py
similarity index 85%
rename from examples/mplot3d/errorbars_demo.py
rename to examples/mplot3d/errorbar3d.py
index 06ccf12035ef..7ef14209ac22 100644
--- a/examples/mplot3d/errorbars_demo.py
+++ b/examples/mplot3d/errorbar3d.py
@@ -1,8 +1,11 @@
-'''
-An example of using errorbars in mplot3d
-'''
+"""
+============
+3D errorbars
+============
+
+An example of using errorbars with upper and lower limits in mplot3d.
+"""
 
-from mpl_toolkits.mplot3d import Axes3D
 import matplotlib.pyplot as plt
 import numpy as np
 
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index dc1e329c78ff..26d0e7735497 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2944,7 +2944,7 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
         everymask[offset::errorevery] = True
 
         def _mask_lists(xs, ys, zs, mask=None):
-            """ Applies a mask to three lists. """
+            """Applies a mask to three lists."""
             xs = [l for l, m in zip(xs, mask) if m]
             ys = [l for l, m in zip(ys, mask) if m]
             zs = [l for l, m in zip(zs, mask) if m]

From b86260ad09ffc57aa62505cb3d94c4f8b3ef3755 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Thu, 23 Apr 2020 17:30:04 +0200
Subject: [PATCH 21/35] fix failing sphinx docs

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 26d0e7735497..0cd7692f7e3c 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2789,6 +2789,7 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
 
         xerr, yerr, zerr : scalar or array-like, optional
             The errorbar sizes:
+
             - scalar: Symmetric +/- values for all data points.
             - shape(N,): Symmetric +/-values for each data point.
             - shape(2, N): Separate - and + values for each bar. First row
@@ -2844,8 +2845,27 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             Used to avoid overlapping error bars when two series share x-axis
             values.
 
-        Additional keyword arguments for styling errorbar lines are passed to
-        `~mpl_toolkits.mplot3d.art3d.Line3DCollection`
+        Returns
+        -------
+        errlines : list
+            List of `~mpl_toolkits.mplot3d.art3d.Line3DCollection` instances
+            each containing an errorbar line.
+        caplines : list
+            List of `~mpl_toolkits.mplot3d.art3d.Line3D` instances each
+            containing a capline object.
+        limmarks : list
+            List of `~mpl_toolkits.mplot3d.art3d.Line3D` instances each
+            containing a marker with an upper or lower limit.
+
+        Other Parameters
+        ----------------
+        **kwargs
+            All other keyword arguments for styling errorbar lines are passed
+            `~mpl_toolkits.mplot3d.art3d.Line3DCollection`.
+
+        Examples
+        --------
+        .. plot:: gallery/mplot3d/errorbar3d.py
         """
         had_data = self.has_data()
 

From 45cbc81078b2def5ddbf4382bf25239a8298e012 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Fri, 24 Apr 2020 10:50:37 +0200
Subject: [PATCH 22/35] add an image comparison unit test for 3d errorbars

---
 examples/mplot3d/errorbar3d.py                |   3 ---
 .../test_mplot3d/errorbar3d.png               | Bin 0 -> 61584 bytes
 lib/mpl_toolkits/tests/test_mplot3d.py        |  18 ++++++++++++++++++
 3 files changed, 18 insertions(+), 3 deletions(-)
 create mode 100644 lib/mpl_toolkits/tests/baseline_images/test_mplot3d/errorbar3d.png

diff --git a/examples/mplot3d/errorbar3d.py b/examples/mplot3d/errorbar3d.py
index 7ef14209ac22..ea92c3b75a79 100644
--- a/examples/mplot3d/errorbar3d.py
+++ b/examples/mplot3d/errorbar3d.py
@@ -16,9 +16,6 @@
 t = np.arange(0, 2*np.pi+.1, 0.01)
 x, y, z = np.sin(t), np.cos(3*t), np.sin(5*t)
 
-fig_zerr_kwargs = dict(zerr=0.2, capsize=2)
-fig_xerr_kwargs = dict(xerr=0.2, errorevery=(2, 2))
-
 estep = 15
 zuplims = [True if (not i % estep and i // estep % 3 == 0)
            else False for i in range(t.size)]
diff --git a/lib/mpl_toolkits/tests/baseline_images/test_mplot3d/errorbar3d.png b/lib/mpl_toolkits/tests/baseline_images/test_mplot3d/errorbar3d.png
new file mode 100644
index 0000000000000000000000000000000000000000..a96324f60302496eb09c45af2e2dce85bdc77e4c
GIT binary patch
literal 61584
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

literal 0
HcmV?d00001

diff --git a/lib/mpl_toolkits/tests/test_mplot3d.py b/lib/mpl_toolkits/tests/test_mplot3d.py
index 25bc6356a25e..639c7f1ecc1d 100644
--- a/lib/mpl_toolkits/tests/test_mplot3d.py
+++ b/lib/mpl_toolkits/tests/test_mplot3d.py
@@ -916,3 +916,21 @@ def test_minor_ticks():
     ax.set_yticklabels(["third"], minor=True)
     ax.set_zticks([0.50], minor=True)
     ax.set_zticklabels(["half"], minor=True)
+
+
+@mpl3d_image_comparison(['errorbar3d.png'], tol=0.03)
+def test_errorbar3d():
+    t = np.arange(0, 2*np.pi+.1, 0.01)
+    x, y, z = np.sin(t), np.cos(3*t), np.sin(5*t)
+
+    fig = plt.figure()
+    ax = fig.gca(projection='3d')
+
+    estep = 15
+    zuplims = [True if (not i % estep and i // estep % 3 == 0)
+               else False for i in range(t.size)]
+    zlolims = [True if (not i % estep and i // estep % 3 == 2)
+               else False for i in range(t.size)]
+
+    ax.errorbar(x, y, z, 0.2, zuplims=zuplims, zlolims=zlolims,
+                errorevery=estep)

From 42c1d2715ed3e9846cec7a2a68120522a2d25db5 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Thu, 30 Apr 2020 17:13:31 +0200
Subject: [PATCH 23/35] errline gets drawn when both limits are set (compat.
 reasons)

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 52 ++++++++++++++++--------------
 1 file changed, 28 insertions(+), 24 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 0cd7692f7e3c..531f5154dfcf 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2972,12 +2972,20 @@ def _mask_lists(xs, ys, zs, mask=None):
 
         # TODO: errors can be only a scalar number or len(N) array-like
         def _unpack_errs(err, data, lomask, himask):
-            lows = [d - e if m else d for d, e, m in zip(data, err, lomask)]
-            highs = [d + e if m else d for d, e, m in zip(data, err, himask)]
+            # for compatibility with the 2d errorbar function, when both upper
+            # and lower limits specified, we need to draw the markers / line -
+            # whether or not using both limits makes any sense (it doesn't)
+            _lomask = lomask | (lomask == himask)
+            _himask = himask | (lomask == himask)
+
+            lows = [d - e if m else d for d, e, m in zip(data, err, _lomask)]
+            highs = [d + e if m else d for d, e, m in zip(data, err, _himask)]
             return lows, highs
 
+        # collect drawn items while looping over the three coordinates
         errlines, caplines, limmarks = [], [], []
-        # List of endpoint coordinates, used for auto-scaling
+
+        # list of endpoint coordinates, used for auto-scaling
         coorderrs = []
 
         # define the markers used for errorbar caps and limits below
@@ -3025,27 +3033,23 @@ def _unpack_errs(err, data, lomask, himask):
                 for i, coord in enumerate([x, y, z])]
             (xl, xh), (yl, yh), (zl, zh) = coorderr
 
-            if nolims.any():
-                if capsize > 0:
-                    lo_caps_xyz = _mask_lists(xl, yl, zl, nolims & everymask)
-                    hi_caps_xyz = _mask_lists(xh, yh, zh, nolims & everymask)
-
-                    # NOTE on the caps in 3D plots:
-                    # Using markers in interactive 3D plots is confusing to
-                    # say the least, as the cap lines don't stay aligned with
-                    # the coordinate axes!
-                    # Nevertheless, let's stick to it for now for consistency.
-                    # Setting '_' for z-caps and '|' for x- and y-caps:
-                    cap_lo = art3d.Line3D(*lo_caps_xyz, ls='',
-                                          marker=capmarker[i_xyz],
-                                          **eb_cap_style)
-                    cap_hi = art3d.Line3D(*hi_caps_xyz, ls='',
-                                          marker=capmarker[i_xyz],
-                                          **eb_cap_style)
-                    self.add_line(cap_lo)
-                    self.add_line(cap_hi)
-                    caplines.append(cap_lo)
-                    caplines.append(cap_hi)
+            # draws capmarkers - flat caps othogonal to the error bars
+            if nolims.any() and capsize > 0:
+                lo_caps_xyz = _mask_lists(xl, yl, zl, nolims & everymask)
+                hi_caps_xyz = _mask_lists(xh, yh, zh, nolims & everymask)
+
+                # setting '_' for z-caps and '|' for x- and y-caps;
+                # these markers will rotate as the viewing angle changes
+                cap_lo = art3d.Line3D(*lo_caps_xyz, ls='',
+                                      marker=capmarker[i_xyz],
+                                      **eb_cap_style)
+                cap_hi = art3d.Line3D(*hi_caps_xyz, ls='',
+                                      marker=capmarker[i_xyz],
+                                      **eb_cap_style)
+                self.add_line(cap_lo)
+                self.add_line(cap_hi)
+                caplines.append(cap_lo)
+                caplines.append(cap_hi)
 
             if (lolims | uplims).any():
                 # FIXME: using markers for limits isn't the best idea: for

From 5969893dd494427174d6663af8197e5a44fb03ff Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Fri, 1 May 2020 11:11:02 +0200
Subject: [PATCH 24/35] refactor to use art3d.get_dir_vector instead of np.roll

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 35 ++++++++++++++----------------
 1 file changed, 16 insertions(+), 19 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 531f5154dfcf..b4a877e9f4d6 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2989,7 +2989,7 @@ def _unpack_errs(err, data, lomask, himask):
         coorderrs = []
 
         # define the markers used for errorbar caps and limits below
-        # the dictionary key is the current ticking value of `i_xyz`
+        # the dictionary key is mapped by the `i_xyz` helper dictionary
         capmarker = {0: '|', 1: '|', 2: '_'}
         limmarker = {0: {'lower': art3d.lines.CARETRIGHT,
                          'upper': art3d.lines.CARETLEFT},
@@ -2997,12 +2997,16 @@ def _unpack_errs(err, data, lomask, himask):
                          'upper': art3d.lines.CARETLEFT},
                      2: {'lower': art3d.lines.CARETUP,
                          'upper': art3d.lines.CARETDOWN}}
+        i_xyz = {'x': 0, 'y': 1, 'z': 2}
 
-        # i_xyz determines which coordinate is currently being looped over
-        for data, err, i_xyz, lolims, uplims in zip(
-                [x, y, z], [xerr, yerr, zerr], range(3),
+        # loop over x-, y-, and z-direction and draw relevant elements
+        for zdir, data, err, lolims, uplims in zip(
+                ['x', 'y', 'z'], [x, y, z], [xerr, yerr, zerr],
                 [xlolims, ylolims, zlolims], [xuplims, yuplims, zuplims]):
 
+            dir_vector = art3d.get_dir_vector(zdir)
+            i_zdir = i_xyz[zdir]
+
             if err is None:
                 continue
 
@@ -3018,17 +3022,11 @@ def _unpack_errs(err, data, lomask, himask):
 
             nolims = ~(lolims | uplims)
 
-            # NOTE: care needs to be taken here - using numpy is fine,
-            #       as long as the actual data plotted stays as lists.
-            #       This is due to unit preservation issues
-            #       (c.f. the 2d errorbar case).
-            rolling_mask = np.roll([1, 0, 0], i_xyz)
-
             # a nested list structure that expands to (xl,xh),(yl,yh),(zl,zh),
             # where x/y/z and l/h correspond to dimensions and low/high
             # positions of errorbars in a dimension we're looping over
             coorderr = [
-                _unpack_errs(err * rolling_mask[i], coord,
+                _unpack_errs(err * dir_vector[i], coord,
                              ~lolims & everymask, ~uplims & everymask)
                 for i, coord in enumerate([x, y, z])]
             (xl, xh), (yl, yh), (zl, zh) = coorderr
@@ -3041,10 +3039,10 @@ def _unpack_errs(err, data, lomask, himask):
                 # setting '_' for z-caps and '|' for x- and y-caps;
                 # these markers will rotate as the viewing angle changes
                 cap_lo = art3d.Line3D(*lo_caps_xyz, ls='',
-                                      marker=capmarker[i_xyz],
+                                      marker=capmarker[i_zdir],
                                       **eb_cap_style)
                 cap_hi = art3d.Line3D(*hi_caps_xyz, ls='',
-                                      marker=capmarker[i_xyz],
+                                      marker=capmarker[i_zdir],
                                       **eb_cap_style)
                 self.add_line(cap_lo)
                 self.add_line(cap_hi)
@@ -3057,7 +3055,7 @@ def _unpack_errs(err, data, lomask, himask):
                 #        the markers around... However, this solution is
                 #        spiritually close to that of 2d errorbar function
                 limits = [
-                    _unpack_errs(err*rolling_mask[i], coord, uplims, lolims)
+                    _unpack_errs(err*dir_vector[i], coord, uplims, lolims)
                     for i, coord in enumerate([x, y, z])]
                 (xlo, xup), (ylo, yup), (zlo, zup) = limits
 
@@ -3065,10 +3063,10 @@ def _unpack_errs(err, data, lomask, himask):
                 uplims_xyz = _mask_lists(xlo, ylo, zlo, uplims & everymask)
 
                 lims_lo = art3d.Line3D(*lolims_xyz, ls='',
-                                       marker=limmarker[i_xyz]['lower'],
+                                       marker=limmarker[i_zdir]['lower'],
                                        **eb_cap_style)
                 lims_up = art3d.Line3D(*uplims_xyz, ls='',
-                                       marker=limmarker[i_xyz]['upper'],
+                                       marker=limmarker[i_zdir]['upper'],
                                        **eb_cap_style)
                 self.add_line(lims_lo)
                 self.add_line(lims_up)
@@ -3086,9 +3084,8 @@ def _unpack_errs(err, data, lomask, himask):
 
         # TODO: errors can be only a scalar number or len(N) array-like
         def _digout_minmax(err_arr, coord_label):
-            key = {'x': 0, 'y': 1, 'z': 2}
-            return (np.nanmin(err_arr[:, key[coord_label], :, :]),
-                    np.nanmax(err_arr[:, key[coord_label], :, :]))
+            return (np.nanmin(err_arr[:, i_xyz[coord_label], :, :]),
+                    np.nanmax(err_arr[:, i_xyz[coord_label], :, :]))
 
         minx, maxx = _digout_minmax(coorderrs, 'x')
         miny, maxy = _digout_minmax(coorderrs, 'y')

From 26a422640e6b99a01ad53dd687e8abfcf579e3a5 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Wed, 6 May 2020 15:42:49 +0200
Subject: [PATCH 25/35] adapt 2d errorbar containers for legend handling

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index b4a877e9f4d6..df7cadd82213 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -24,6 +24,7 @@
 import matplotlib.colors as mcolors
 import matplotlib.docstring as docstring
 import matplotlib.scale as mscale
+import matplotlib.container as mcontainer
 from matplotlib.axes import Axes, rcParams
 from matplotlib.axes._base import _axis_method_wrapper, _process_plot_format
 from matplotlib.transforms import Bbox
@@ -2891,6 +2892,7 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
         else:
             base_style = next(self._get_lines.prop_cycler)
 
+        base_style['label'] = '_nolegend_'
         base_style.update(fmt_style_kwargs)
         if 'color' not in base_style:
             base_style['color'] = 'C0'
@@ -3074,7 +3076,6 @@ def _unpack_errs(err, data, lomask, himask):
                 limmarks.append(lims_up)
 
             errline = art3d.Line3DCollection(np.array(coorderr).T,
-                                             label=label,
                                              **eb_lines_style)
             self.add_collection(errline)
             errlines.append(errline)
@@ -3092,6 +3093,14 @@ def _digout_minmax(err_arr, coord_label):
         minz, maxz = _digout_minmax(coorderrs, 'z')
         self.auto_scale_xyz((minx, maxx), (miny, maxy), (minz, maxz), had_data)
 
+        # Adapting errorbar containers for 3d case - assuming z-axis points "up"
+        errorbar_container = mcontainer.ErrorbarContainer(
+            (data_line, tuple(caplines), tuple(errlines)),
+            has_xerr=(xerr is not None or yerr is not None),
+            has_yerr=(zerr is not None),
+            label=label)
+        self.containers.append(errorbar_container)
+
         return errlines, caplines, limmarks
 
 

From c8f11614b42f6d75da43f30975341b9111563f60 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Wed, 6 May 2020 19:02:56 +0200
Subject: [PATCH 26/35] need to consider everymask for altering upper=lower
 limits

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index df7cadd82213..a172a61d3546 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2977,8 +2977,8 @@ def _unpack_errs(err, data, lomask, himask):
             # for compatibility with the 2d errorbar function, when both upper
             # and lower limits specified, we need to draw the markers / line -
             # whether or not using both limits makes any sense (it doesn't)
-            _lomask = lomask | (lomask == himask)
-            _himask = himask | (lomask == himask)
+            _lomask = lomask | ((lomask == himask) & everymask)
+            _himask = himask | ((lomask == himask) & everymask)
 
             lows = [d - e if m else d for d, e, m in zip(data, err, _lomask)]
             highs = [d + e if m else d for d, e, m in zip(data, err, _himask)]
@@ -3093,7 +3093,7 @@ def _digout_minmax(err_arr, coord_label):
         minz, maxz = _digout_minmax(coorderrs, 'z')
         self.auto_scale_xyz((minx, maxx), (miny, maxy), (minz, maxz), had_data)
 
-        # Adapting errorbar containers for 3d case - assuming z-axis points "up"
+        # Adapting errorbar containers for 3d case, assuming z-axis points "up"
         errorbar_container = mcontainer.ErrorbarContainer(
             (data_line, tuple(caplines), tuple(errlines)),
             has_xerr=(xerr is not None or yerr is not None),

From e18713a3ee3518db4c753e7427bb386062390c72 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Wed, 13 May 2020 15:51:29 +0200
Subject: [PATCH 27/35] switch to plt.quiver for drawling arrows

---
 lib/mpl_toolkits/mplot3d/axes3d.py            |  46 ++++++++----------
 .../test_mplot3d/errorbar3d.png               | Bin 61584 -> 58166 bytes
 .../test_mplot3d/errorbar3d_errorevery.png    | Bin 0 -> 60878 bytes
 lib/mpl_toolkits/tests/test_mplot3d.py        |  21 +++++++-
 4 files changed, 39 insertions(+), 28 deletions(-)
 create mode 100644 lib/mpl_toolkits/tests/baseline_images/test_mplot3d/errorbar3d_errorevery.png

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index a172a61d3546..f959a18605b7 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2775,7 +2775,7 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
                  barsabove=False, errorevery=1, ecolor=None, elinewidth=None,
                  capsize=None, capthick=None, xlolims=False, xuplims=False,
                  ylolims=False, yuplims=False, zlolims=False, zuplims=False,
-                 **kwargs):
+                 arrow_length_ratio=.4, **kwargs):
         """
         Plot lines and/or markers with errorbars around them.
 
@@ -2846,6 +2846,10 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             Used to avoid overlapping error bars when two series share x-axis
             values.
 
+        arrow_length_ratio : float, default: 0.4
+            Passed to :meth:`quiver`, the ratio of the arrow head with respect
+            to the quiver.
+
         Returns
         -------
         errlines : list
@@ -2993,12 +2997,6 @@ def _unpack_errs(err, data, lomask, himask):
         # define the markers used for errorbar caps and limits below
         # the dictionary key is mapped by the `i_xyz` helper dictionary
         capmarker = {0: '|', 1: '|', 2: '_'}
-        limmarker = {0: {'lower': art3d.lines.CARETRIGHT,
-                         'upper': art3d.lines.CARETLEFT},
-                     1: {'lower': art3d.lines.CARETRIGHT,
-                         'upper': art3d.lines.CARETLEFT},
-                     2: {'lower': art3d.lines.CARETUP,
-                         'upper': art3d.lines.CARETDOWN}}
         i_xyz = {'x': 0, 'y': 1, 'z': 2}
 
         # loop over x-, y-, and z-direction and draw relevant elements
@@ -3015,7 +3013,6 @@ def _unpack_errs(err, data, lomask, himask):
             if not np.iterable(err):
                 err = [err] * len(data)
 
-            # FIXME: err data is not supposed to be transformed into arrays!
             err = np.atleast_1d(err)
 
             # arrays fine here, they are booleans and hence not units
@@ -3052,28 +3049,25 @@ def _unpack_errs(err, data, lomask, himask):
                 caplines.append(cap_hi)
 
             if (lolims | uplims).any():
-                # FIXME: using markers for limits isn't the best idea: for
-                #        example, 180 deg rotation around z-axis would flip
-                #        the markers around... However, this solution is
-                #        spiritually close to that of 2d errorbar function
                 limits = [
                     _unpack_errs(err*dir_vector[i], coord, uplims, lolims)
                     for i, coord in enumerate([x, y, z])]
-                (xlo, xup), (ylo, yup), (zlo, zup) = limits
 
-                lolims_xyz = _mask_lists(xup, yup, zup, lolims & everymask)
-                uplims_xyz = _mask_lists(xlo, ylo, zlo, uplims & everymask)
-
-                lims_lo = art3d.Line3D(*lolims_xyz, ls='',
-                                       marker=limmarker[i_zdir]['lower'],
-                                       **eb_cap_style)
-                lims_up = art3d.Line3D(*uplims_xyz, ls='',
-                                       marker=limmarker[i_zdir]['upper'],
-                                       **eb_cap_style)
-                self.add_line(lims_lo)
-                self.add_line(lims_up)
-                limmarks.append(lims_lo)
-                limmarks.append(lims_up)
+                (xlo, xup), (ylo, yup), (zlo, zup) = limits
+                lomask = lolims & everymask
+                upmask = uplims & everymask
+                lolims_xyz = _mask_lists(xlo, ylo, zlo, upmask)
+                uplims_xyz = _mask_lists(xup, yup, zup, lomask)
+                lo_xyz = _mask_lists(x, y, z, upmask)
+                up_xyz = _mask_lists(x, y, z, lomask)
+
+                x0, y0, z0 = np.vstack([np.c_[lo_xyz],
+                                        np.c_[up_xyz]]).T
+                dx, dy, dz = np.vstack([np.c_[lolims_xyz] - np.c_[lo_xyz],
+                                        np.c_[uplims_xyz] - np.c_[up_xyz]]).T
+                self.quiver(x0, y0, z0, dx, dy, dz,
+                            arrow_length_ratio=arrow_length_ratio,
+                            **eb_lines_style)
 
             errline = art3d.Line3DCollection(np.array(coorderr).T,
                                              **eb_lines_style)
diff --git a/lib/mpl_toolkits/tests/baseline_images/test_mplot3d/errorbar3d.png b/lib/mpl_toolkits/tests/baseline_images/test_mplot3d/errorbar3d.png
index a96324f60302496eb09c45af2e2dce85bdc77e4c..47c22afa12e8adb40a25c9e62e4b9b06fab829c2 100644
GIT binary patch
literal 58166
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
G3i>Y`3~hA)

literal 61584
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

diff --git a/lib/mpl_toolkits/tests/baseline_images/test_mplot3d/errorbar3d_errorevery.png b/lib/mpl_toolkits/tests/baseline_images/test_mplot3d/errorbar3d_errorevery.png
new file mode 100644
index 0000000000000000000000000000000000000000..7d6bd85e43eff4e8abb1d69e217fc4f6e60d3334
GIT binary patch
literal 60878
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

literal 0
HcmV?d00001

diff --git a/lib/mpl_toolkits/tests/test_mplot3d.py b/lib/mpl_toolkits/tests/test_mplot3d.py
index 639c7f1ecc1d..449d179f9b02 100644
--- a/lib/mpl_toolkits/tests/test_mplot3d.py
+++ b/lib/mpl_toolkits/tests/test_mplot3d.py
@@ -918,8 +918,9 @@ def test_minor_ticks():
     ax.set_zticklabels(["half"], minor=True)
 
 
-@mpl3d_image_comparison(['errorbar3d.png'], tol=0.03)
-def test_errorbar3d():
+@mpl3d_image_comparison(['errorbar3d_errorevery.png'], tol=0.03)
+def test_errorbar3d_errorevery():
+    """Tests errorevery functionality for 3d errorbars."""
     t = np.arange(0, 2*np.pi+.1, 0.01)
     x, y, z = np.sin(t), np.cos(3*t), np.sin(5*t)
 
@@ -934,3 +935,19 @@ def test_errorbar3d():
 
     ax.errorbar(x, y, z, 0.2, zuplims=zuplims, zlolims=zlolims,
                 errorevery=estep)
+
+
+@mpl3d_image_comparison(['errorbar3d.png'], tol=0.03)
+def test_errorbar3d():
+    """Tests limits, color styling, and legend for 3d errorbars."""
+    fig = plt.figure()
+    ax = fig.gca(projection='3d')
+
+    d = [1, 2, 3, 4, 5]
+    e = [.5, .5, .5, .5, .5]
+    ax.errorbar(x=d, y=d, z=d, xerr=e, yerr=e, zerr=e, capsize=3,
+                zuplims=[False, True, False, True, True],
+                zlolims=[True, False, False, True, False],
+                yuplims=True,
+                ecolor='purple', label='Error lines')
+    ax.legend()

From 159b6b5d35d4bb22be88148676381d999ad884aa Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Wed, 13 May 2020 16:38:29 +0200
Subject: [PATCH 28/35] refactor numpy array handling

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index f959a18605b7..3f0b19910d05 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2984,8 +2984,9 @@ def _unpack_errs(err, data, lomask, himask):
             _lomask = lomask | ((lomask == himask) & everymask)
             _himask = himask | ((lomask == himask) & everymask)
 
-            lows = [d - e if m else d for d, e, m in zip(data, err, _lomask)]
-            highs = [d + e if m else d for d, e, m in zip(data, err, _himask)]
+            lows = np.where(_lomask, data - err, data)
+            highs = np.where(_himask, data + err, data)
+
             return lows, highs
 
         # collect drawn items while looping over the three coordinates
@@ -3061,10 +3062,11 @@ def _unpack_errs(err, data, lomask, himask):
                 lo_xyz = _mask_lists(x, y, z, upmask)
                 up_xyz = _mask_lists(x, y, z, lomask)
 
-                x0, y0, z0 = np.vstack([np.c_[lo_xyz],
-                                        np.c_[up_xyz]]).T
-                dx, dy, dz = np.vstack([np.c_[lolims_xyz] - np.c_[lo_xyz],
-                                        np.c_[uplims_xyz] - np.c_[up_xyz]]).T
+                x0, y0, z0 = x0, y0, z0 = np.concatenate([lo_xyz, up_xyz],
+                                                         axis=-1)
+                dx, dy, dz = np.concatenate([
+                    np.array(lolims_xyz) - np.array(lo_xyz),
+                    np.array(uplims_xyz) - np.array(up_xyz)], axis=-1)
                 self.quiver(x0, y0, z0, dx, dy, dz,
                             arrow_length_ratio=arrow_length_ratio,
                             **eb_lines_style)

From 5db6976812a2ac7ed204b70ac18c818246bfeec7 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Wed, 13 May 2020 17:28:28 +0200
Subject: [PATCH 29/35] allow for (2, N)-shaped errorbar input + small numpy
 refactors

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 29 +++++++++++++++--------------
 1 file changed, 15 insertions(+), 14 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 3f0b19910d05..1c5807dd02f2 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2976,16 +2976,21 @@ def _mask_lists(xs, ys, zs, mask=None):
             zs = [l for l, m in zip(zs, mask) if m]
             return xs, ys, zs
 
-        # TODO: errors can be only a scalar number or len(N) array-like
         def _unpack_errs(err, data, lomask, himask):
+            # For separate +/- error values we need to unpack err
+            if len(err.shape) == 2:
+                low_err, high_err = err
+            else:
+                low_err, high_err = err, err
+
             # for compatibility with the 2d errorbar function, when both upper
             # and lower limits specified, we need to draw the markers / line -
             # whether or not using both limits makes any sense (it doesn't)
             _lomask = lomask | ((lomask == himask) & everymask)
             _himask = himask | ((lomask == himask) & everymask)
 
-            lows = np.where(_lomask, data - err, data)
-            highs = np.where(_himask, data + err, data)
+            lows = np.where(_lomask, data - low_err, data)
+            highs = np.where(_himask, data + high_err, data)
 
             return lows, highs
 
@@ -3057,16 +3062,13 @@ def _unpack_errs(err, data, lomask, himask):
                 (xlo, xup), (ylo, yup), (zlo, zup) = limits
                 lomask = lolims & everymask
                 upmask = uplims & everymask
-                lolims_xyz = _mask_lists(xlo, ylo, zlo, upmask)
-                uplims_xyz = _mask_lists(xup, yup, zup, lomask)
-                lo_xyz = _mask_lists(x, y, z, upmask)
-                up_xyz = _mask_lists(x, y, z, lomask)
-
-                x0, y0, z0 = x0, y0, z0 = np.concatenate([lo_xyz, up_xyz],
-                                                         axis=-1)
-                dx, dy, dz = np.concatenate([
-                    np.array(lolims_xyz) - np.array(lo_xyz),
-                    np.array(uplims_xyz) - np.array(up_xyz)], axis=-1)
+                lolims_xyz = np.array(_mask_lists(xlo, ylo, zlo, upmask))
+                uplims_xyz = np.array(_mask_lists(xup, yup, zup, lomask))
+                lo_xyz = np.array(_mask_lists(x, y, z, upmask))
+                up_xyz = np.array(_mask_lists(x, y, z, lomask))
+                x0, y0, z0 = np.concatenate([lo_xyz, up_xyz], axis=-1)
+                dx, dy, dz = np.concatenate([lolims_xyz - lo_xyz,
+                                             uplims_xyz - up_xyz], axis=-1)
                 self.quiver(x0, y0, z0, dx, dy, dz,
                             arrow_length_ratio=arrow_length_ratio,
                             **eb_lines_style)
@@ -3079,7 +3081,6 @@ def _unpack_errs(err, data, lomask, himask):
 
         coorderrs = np.array(coorderrs)
 
-        # TODO: errors can be only a scalar number or len(N) array-like
         def _digout_minmax(err_arr, coord_label):
             return (np.nanmin(err_arr[:, i_xyz[coord_label], :, :]),
                     np.nanmax(err_arr[:, i_xyz[coord_label], :, :]))

From 3c7c0de7524d7264b02dcd303a6c6a00cb06572c Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Thu, 14 May 2020 11:21:45 +0200
Subject: [PATCH 30/35] add numpy refactor as per PR suggestion

Co-authored-by: Eric Wieser <wieser.eric@gmail.com>
---
 lib/mpl_toolkits/mplot3d/axes3d.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 1c5807dd02f2..ff9d8bb235b6 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2986,8 +2986,9 @@ def _unpack_errs(err, data, lomask, himask):
             # for compatibility with the 2d errorbar function, when both upper
             # and lower limits specified, we need to draw the markers / line -
             # whether or not using both limits makes any sense (it doesn't)
-            _lomask = lomask | ((lomask == himask) & everymask)
-            _himask = himask | ((lomask == himask) & everymask)
+            common_mask = (lomask == himask) & everymask
+            _lomask = lomask | common_mask
+            _himask = himask | common_mask
 
             lows = np.where(_lomask, data - low_err, data)
             highs = np.where(_himask, data + high_err, data)

From 3a99be8630f37b57c004b7e4da37006b34dd84bf Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Wed, 20 May 2020 20:11:51 +0200
Subject: [PATCH 31/35] add numpy refactror for errorbar3d example

Co-authored-by: Eric Wieser <wieser.eric@gmail.com>
---
 examples/mplot3d/errorbar3d.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/examples/mplot3d/errorbar3d.py b/examples/mplot3d/errorbar3d.py
index ea92c3b75a79..7d8599d9cf2a 100644
--- a/examples/mplot3d/errorbar3d.py
+++ b/examples/mplot3d/errorbar3d.py
@@ -17,10 +17,9 @@
 x, y, z = np.sin(t), np.cos(3*t), np.sin(5*t)
 
 estep = 15
-zuplims = [True if (not i % estep and i // estep % 3 == 0)
-           else False for i in range(t.size)]
-zlolims = [True if (not i % estep and i // estep % 3 == 2)
-           else False for i in range(t.size)]
+i = np.arange(t.size)
+zuplims = (i % estep == 0) & (i // estep % 3 == 0)
+zlolims = (i % estep == 0) & (i // estep % 3 == 2)
 
 ax.errorbar(x, y, z, 0.2, zuplims=zuplims, zlolims=zlolims, errorevery=estep)
 

From 1a6f58a731893cc53d334213529c71c5169a3663 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Wed, 20 May 2020 20:14:37 +0200
Subject: [PATCH 32/35] add numpy refactor for errorbar3d unit test

---
 lib/mpl_toolkits/tests/test_mplot3d.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/lib/mpl_toolkits/tests/test_mplot3d.py b/lib/mpl_toolkits/tests/test_mplot3d.py
index 449d179f9b02..b0c52e050bc5 100644
--- a/lib/mpl_toolkits/tests/test_mplot3d.py
+++ b/lib/mpl_toolkits/tests/test_mplot3d.py
@@ -928,10 +928,9 @@ def test_errorbar3d_errorevery():
     ax = fig.gca(projection='3d')
 
     estep = 15
-    zuplims = [True if (not i % estep and i // estep % 3 == 0)
-               else False for i in range(t.size)]
-    zlolims = [True if (not i % estep and i // estep % 3 == 2)
-               else False for i in range(t.size)]
+    i = np.arange(t.size)
+    zuplims = (i % estep == 0) & (i // estep % 3 == 0)
+    zlolims = (i % estep == 0) & (i // estep % 3 == 2)
 
     ax.errorbar(x, y, z, 0.2, zuplims=zuplims, zlolims=zlolims,
                 errorevery=estep)

From 0d8c3e34d3c658aa1630c37832c18e1f6333775e Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Thu, 18 Jun 2020 18:33:56 +0200
Subject: [PATCH 33/35] port most of the changes done in #15037 for 2d
 errorbars

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 46 +++++++++++++++++-------------
 1 file changed, 26 insertions(+), 20 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 55e94672b7b1..a00e9e284396 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -12,6 +12,7 @@
 
 from collections import defaultdict
 from functools import reduce
+from itertools import compress
 import math
 import textwrap
 
@@ -2972,10 +2973,14 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             symbols. Default is below.
 
         xlolims, ylolims, zlolims : bool, default: False
-            These arguments can be used to indicate that a value gives
-            only lower limits. In that case a caret symbol is being
-            drawn to indicate this. lims-arguments may be of the same
-            type as *xerr* and *yerr*.
+            These arguments can be used to indicate that a value gives only
+            lower limits. In that case a caret symbol is used to indicate
+            this. *lims*-arguments may be scalars, or array-likes of the same
+            length as the errors. To use limits with inverted axes,
+            `~.Axes.set_xlim` or `~.Axes.set_ylim` must be called before
+            :meth:`errorbar`. Note the tricky parameter names: setting e.g.
+            *ylolims* to True means that the y-value is a *lower* limit of the
+            True value, so, only an *upward*-pointing arrow will be drawn!
 
         xuplims, yuplims, zuplims : bool, default: False
             Same as above, but for controlling the upper limits.
@@ -3052,6 +3057,9 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
         y = y if np.iterable(y) else [y]
         z = z if np.iterable(z) else [z]
 
+        if not len(x) == len(y) == len(z):
+            raise ValueError("'x', 'y', and 'z' must have the same size")
+
         # make the style dict for the 'normal' plot line
         if 'zorder' not in kwargs:
             kwargs['zorder'] = 2
@@ -3112,14 +3120,12 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
         everymask = np.zeros(len(x), bool)
         everymask[offset::errorevery] = True
 
-        def _mask_lists(xs, ys, zs, mask=None):
-            """Applies a mask to three lists."""
-            xs = [l for l, m in zip(xs, mask) if m]
-            ys = [l for l, m in zip(ys, mask) if m]
-            zs = [l for l, m in zip(zs, mask) if m]
-            return xs, ys, zs
+        def _apply_mask(arrays, mask):
+            # Return, for each array in *arrays*, the elements for which *mask*
+            # is True, without using fancy indexing.
+            return [[*compress(array, mask)] for array in arrays]
 
-        def _unpack_errs(err, data, lomask, himask):
+        def _extract_errs(err, data, lomask, himask):
             # For separate +/- error values we need to unpack err
             if len(err.shape) == 2:
                 low_err, high_err = err
@@ -3175,15 +3181,15 @@ def _unpack_errs(err, data, lomask, himask):
             # where x/y/z and l/h correspond to dimensions and low/high
             # positions of errorbars in a dimension we're looping over
             coorderr = [
-                _unpack_errs(err * dir_vector[i], coord,
-                             ~lolims & everymask, ~uplims & everymask)
+                _extract_errs(err * dir_vector[i], coord,
+                              ~lolims & everymask, ~uplims & everymask)
                 for i, coord in enumerate([x, y, z])]
             (xl, xh), (yl, yh), (zl, zh) = coorderr
 
             # draws capmarkers - flat caps othogonal to the error bars
             if nolims.any() and capsize > 0:
-                lo_caps_xyz = _mask_lists(xl, yl, zl, nolims & everymask)
-                hi_caps_xyz = _mask_lists(xh, yh, zh, nolims & everymask)
+                lo_caps_xyz = _apply_mask([xl, yl, zl], nolims & everymask)
+                hi_caps_xyz = _apply_mask([xh, yh, zh], nolims & everymask)
 
                 # setting '_' for z-caps and '|' for x- and y-caps;
                 # these markers will rotate as the viewing angle changes
@@ -3200,16 +3206,16 @@ def _unpack_errs(err, data, lomask, himask):
 
             if (lolims | uplims).any():
                 limits = [
-                    _unpack_errs(err*dir_vector[i], coord, uplims, lolims)
+                    _extract_errs(err*dir_vector[i], coord, uplims, lolims)
                     for i, coord in enumerate([x, y, z])]
 
                 (xlo, xup), (ylo, yup), (zlo, zup) = limits
                 lomask = lolims & everymask
                 upmask = uplims & everymask
-                lolims_xyz = np.array(_mask_lists(xlo, ylo, zlo, upmask))
-                uplims_xyz = np.array(_mask_lists(xup, yup, zup, lomask))
-                lo_xyz = np.array(_mask_lists(x, y, z, upmask))
-                up_xyz = np.array(_mask_lists(x, y, z, lomask))
+                lolims_xyz = np.array(_apply_mask([xlo, ylo, zlo], upmask))
+                uplims_xyz = np.array(_apply_mask([xup, yup, zup], lomask))
+                lo_xyz = np.array(_apply_mask([x, y, z], upmask))
+                up_xyz = np.array(_apply_mask([x, y, z], lomask))
                 x0, y0, z0 = np.concatenate([lo_xyz, up_xyz], axis=-1)
                 dx, dy, dz = np.concatenate([lolims_xyz - lo_xyz,
                                              uplims_xyz - up_xyz], axis=-1)

From 93c9de562fcf55b021fb05698df16695f46fcca6 Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vlas145@gmail.com>
Date: Sun, 26 Jul 2020 12:45:17 +0200
Subject: [PATCH 34/35] Apply suggestions from code review

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 lib/mpl_toolkits/mplot3d/axes3d.py | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index a00e9e284396..9a54cc0e4ab8 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2929,10 +2929,10 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
 
         Parameters
         ----------
-        x, y, z : scalar or array-like
+        x, y, z : float or array-like
             The data positions.
 
-        xerr, yerr, zerr : scalar or array-like, optional
+        xerr, yerr, zerr : float or array-like, shape (N,) or (2, N), optional
             The errorbar sizes:
 
             - scalar: Symmetric +/- values for all data points.
@@ -2942,6 +2942,8 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
               errors.
             - *None*: No errorbar.
 
+            Note that all error arrays should have *positive* values.
+
         fmt : str, default: ''
             The format for the data points / data lines. See `.plot` for
             details.
@@ -2953,14 +2955,14 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             The color of the errorbar lines.  If None, use the color of the
             line connecting the markers.
 
-        elinewidth : scalar, default: None
+        elinewidth : float, default: None
             The linewidth of the errorbar lines. If None, the linewidth of
             the current style is used.
 
-        capsize : scalar, default: :rc:`errorbar.capsize`
+        capsize : float, default: :rc:`errorbar.capsize`
             The length of the error bar caps in points.
 
-        capthick : scalar, default: None
+        capthick : float, default: None
             An alias to the keyword argument *markeredgewidth* (a.k.a. *mew*).
             This setting is a more sensible name for the property that
             controls the thickness of the error bar cap in points. For
@@ -2987,9 +2989,9 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
 
         errorevery : int or (int, int), default: 1
             draws error bars on a subset of the data. *errorevery* =N draws
-            error bars on the points (x[::N], y[::N]).
+            error bars on the points (x[::N], y[::N], z[::N]).
             *errorevery* =(start, N) draws error bars on the points
-            (x[start::N], y[start::N]). e.g. errorevery=(6, 3)
+            (x[start::N], y[start::N], z[start::N]). e.g. errorevery=(6, 3)
             adds error bars to the data at (x[6], x[9], x[12], x[15], ...).
             Used to avoid overlapping error bars when two series share x-axis
             values.
@@ -3186,7 +3188,7 @@ def _extract_errs(err, data, lomask, himask):
                 for i, coord in enumerate([x, y, z])]
             (xl, xh), (yl, yh), (zl, zh) = coorderr
 
-            # draws capmarkers - flat caps othogonal to the error bars
+            # draws capmarkers - flat caps orthogonal to the error bars
             if nolims.any() and capsize > 0:
                 lo_caps_xyz = _apply_mask([xl, yl, zl], nolims & everymask)
                 hi_caps_xyz = _apply_mask([xh, yh, zh], nolims & everymask)

From 1c732042173565b72025d6306697e21a62667a0c Mon Sep 17 00:00:00 2001
From: Vlas Sokolov <vs@innospot.de>
Date: Wed, 29 Jul 2020 12:04:50 +0200
Subject: [PATCH 35/35] fix more pr comments

---
 lib/mpl_toolkits/mplot3d/axes3d.py     | 3 +--
 lib/mpl_toolkits/tests/test_mplot3d.py | 4 ++--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 9a54cc0e4ab8..8b50ff6300e2 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -3135,8 +3135,7 @@ def _extract_errs(err, data, lomask, himask):
                 low_err, high_err = err, err
 
             # for compatibility with the 2d errorbar function, when both upper
-            # and lower limits specified, we need to draw the markers / line -
-            # whether or not using both limits makes any sense (it doesn't)
+            # and lower limits specified, we need to draw the markers / line
             common_mask = (lomask == himask) & everymask
             _lomask = lomask | common_mask
             _himask = himask | common_mask
diff --git a/lib/mpl_toolkits/tests/test_mplot3d.py b/lib/mpl_toolkits/tests/test_mplot3d.py
index b7a96f305c20..a3643db6fc10 100644
--- a/lib/mpl_toolkits/tests/test_mplot3d.py
+++ b/lib/mpl_toolkits/tests/test_mplot3d.py
@@ -975,7 +975,7 @@ def test_minor_ticks():
     ax.set_zticklabels(["half"], minor=True)
 
 
-@mpl3d_image_comparison(['errorbar3d_errorevery.png'], tol=0.03)
+@mpl3d_image_comparison(['errorbar3d_errorevery.png'])
 def test_errorbar3d_errorevery():
     """Tests errorevery functionality for 3d errorbars."""
     t = np.arange(0, 2*np.pi+.1, 0.01)
@@ -993,7 +993,7 @@ def test_errorbar3d_errorevery():
                 errorevery=estep)
 
 
-@mpl3d_image_comparison(['errorbar3d.png'], tol=0.03)
+@mpl3d_image_comparison(['errorbar3d.png'])
 def test_errorbar3d():
     """Tests limits, color styling, and legend for 3d errorbars."""
     fig = plt.figure()