From 201dc2aa9e981490811490a2fb30f7c4fae0b502 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Sat, 10 Jun 2017 02:27:06 +0530
Subject: [PATCH 01/35] Initailize class 2D norm

---
 lib/matplotlib/colors.py            | 54 +++++++++++++++++++++++++++++
 lib/matplotlib/tests/test_colors.py | 43 +++++++++++++++++++++++
 2 files changed, 97 insertions(+)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 45fc27a0b353..31b9d1113c06 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -1349,6 +1349,60 @@ def __call__(self, value, clip=None):
     def inverse(self, value):
         return value
 
+class Norm2d:
+    """
+    Normalize a list of two values corresponding to two 1D normalizers
+    """
+    def __init__(self, norm_instances=None):
+        """
+        Parameters
+        ----------
+        norm_instances :
+            A list of length two having instances of 1D normalizers
+        """
+        if norm_instances is None:
+            self.norm_instances = [Normalize(), Normalize()]
+        else:
+            self.norm_instances = norm_instances
+
+    def __call__(self, values, clip=None):
+        """
+        Parameters
+        ----------
+        values : array-like
+            A list of two values to be normalized
+        clip : list of bools, None, optional
+            A list of two bools corresponding to value in values.
+            If clip is None then clip is set according to corresponding
+            normalizers.
+
+        Returns
+        -------
+        A list of two normalized values according to corresponding 1D
+        normalizers.
+        """
+        norm_one, norm_two = self.norm_instances
+
+        if clip is None:
+            clip = [norm_one.clip, norm_two.clip]
+
+        return [norm_one(values[0], clip=clip[0]),
+                norm_two(values[1], clip=clip[1])]
+
+    def inverse(self, values):
+        """
+        Parameters
+        ----------
+        values : array-like
+            A list of two values to be inverted
+
+        Returns
+        -------
+        A list of two unnormalized values
+        """
+        norm_one, norm_two = self.norm_instances
+
+        return [norm_one.inverse(values[0]), norm_two.inverse(values[1])]
 
 def rgb_to_hsv(arr):
     """
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index 721813e62f8f..d18bb64ff950 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -272,6 +272,49 @@ def _mask_tester(norm_instance, vals):
     masked_array[0] = np.ma.masked
     assert_array_equal(masked_array.mask, norm_instance(masked_array).mask)
 
+@pytest.mark.parametrize(
+    'norm_instances, values, expected, clip', [
+        (
+            None,
+            [[0.2, 0.4, 0.5], [5, 7, 9, 10]],
+            [[0, 0.666667, 1], [0, 0.4, 0.8, 1]],
+            None
+        ),
+        (
+            [mcolors.LogNorm(clip=True, vmax=5), mcolors.Normalize()],
+            [[1, 6], [5, 7, 9, 10]],
+            [[0, 1.0], [0, 0.4, 0.8, 1]],
+            None
+        ),
+        (
+            [mcolors.PowerNorm(2, vmin=0, vmax=8, clip=None),
+                mcolors.PowerNorm(2, vmin=2, vmax=8, clip=True)],
+            [np.array([-0.5, 0, 2, 4, 8], dtype=float),
+                np.array([-0.5, 0, 1, 8, 16], dtype=float)],
+            [[0, 0, 1/16, 1/4, 1], [0, 0, 0, 1, 1]],
+            None
+        ),
+        (
+            [mcolors.SymLogNorm(3, vmin=-30, vmax=5, linscale=1.2),
+                mcolors.PowerNorm(2, vmin=2, vmax=8, clip=False)],
+            [np.array([-30, -1, 2, 6], dtype=float),
+                np.array([-0.5, 0, 1, 8, 16], dtype=float)],
+            [[0., 0.53980074, 0.826991, 1.02758204], [0, 0, 0, 1, 1]],
+            [False, True]
+        )
+    ], ids=[
+            'norm_is_None',
+            'LogNorm_and_LinearNorm',
+            'PowerNorm_clip_None_and_True',
+            'SymLogNorm_and_PowerNorm_clip_in_call'
+    ]
+)
+def test_norm2d(norm_instances, values, expected, clip):
+    norm = mcolors.Norm2d(norm_instances=norm_instances)
+    ans1, ans2 = norm(values=values, clip=clip)
+    assert_array_almost_equal(ans1, expected[0])
+    assert_array_almost_equal(ans2, expected[1])
+
 
 @image_comparison(baseline_images=['levels_and_colors'],
                   extensions=['png'])

From 72175362833539a029cbc398f0d145f6695f8a9b Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Sat, 10 Jun 2017 04:20:13 +0530
Subject: [PATCH 02/35] Change name of class to BivariateNorm, take normalizer
 instances separately

---
 lib/matplotlib/colors.py            | 32 +++++++++++++++--------------
 lib/matplotlib/tests/test_colors.py | 18 ++++++++--------
 2 files changed, 27 insertions(+), 23 deletions(-)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 31b9d1113c06..da536abeef4b 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -1349,21 +1349,27 @@ def __call__(self, value, clip=None):
     def inverse(self, value):
         return value
 
-class Norm2d:
+class BivariateNorm:
     """
     Normalize a list of two values corresponding to two 1D normalizers
     """
-    def __init__(self, norm_instances=None):
+    def __init__(self, norm1=None, norm2=None):
         """
         Parameters
         ----------
-        norm_instances :
-            A list of length two having instances of 1D normalizers
+        norm1 :
+            An instance of 1D normalizers
+        norm2 :
+            An instance of 1D normalizers
         """
-        if norm_instances is None:
-            self.norm_instances = [Normalize(), Normalize()]
+        if norm1 is None:
+            self.norm1 = Normalize()
         else:
-            self.norm_instances = norm_instances
+            self.norm1 = norm1
+        if norm2 is None:
+            self.norm2 = Normalize()
+        else:
+            self.norm2 = norm2
 
     def __call__(self, values, clip=None):
         """
@@ -1381,13 +1387,11 @@ def __call__(self, values, clip=None):
         A list of two normalized values according to corresponding 1D
         normalizers.
         """
-        norm_one, norm_two = self.norm_instances
-
         if clip is None:
-            clip = [norm_one.clip, norm_two.clip]
+            clip = [self.norm1.clip, self.norm2.clip]
 
-        return [norm_one(values[0], clip=clip[0]),
-                norm_two(values[1], clip=clip[1])]
+        return [self.norm1(values[0], clip=clip[0]),
+                self.norm2(values[1], clip=clip[1])]
 
     def inverse(self, values):
         """
@@ -1400,9 +1404,7 @@ def inverse(self, values):
         -------
         A list of two unnormalized values
         """
-        norm_one, norm_two = self.norm_instances
-
-        return [norm_one.inverse(values[0]), norm_two.inverse(values[1])]
+        return [self.norm1.inverse(values[0]), self.norm.inverse(values[1])]
 
 def rgb_to_hsv(arr):
     """
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index d18bb64ff950..e93f7257c619 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -273,30 +273,32 @@ def _mask_tester(norm_instance, vals):
     assert_array_equal(masked_array.mask, norm_instance(masked_array).mask)
 
 @pytest.mark.parametrize(
-    'norm_instances, values, expected, clip', [
+    'norm1, norm2, values, expected, clip', [
         (
+            None,
             None,
             [[0.2, 0.4, 0.5], [5, 7, 9, 10]],
             [[0, 0.666667, 1], [0, 0.4, 0.8, 1]],
             None
         ),
         (
-            [mcolors.LogNorm(clip=True, vmax=5), mcolors.Normalize()],
+            mcolors.LogNorm(clip=True, vmax=5),
+            None,
             [[1, 6], [5, 7, 9, 10]],
             [[0, 1.0], [0, 0.4, 0.8, 1]],
             None
         ),
         (
-            [mcolors.PowerNorm(2, vmin=0, vmax=8, clip=None),
-                mcolors.PowerNorm(2, vmin=2, vmax=8, clip=True)],
+            mcolors.PowerNorm(2, vmin=0, vmax=8, clip=None),
+            mcolors.PowerNorm(2, vmin=2, vmax=8, clip=True),
             [np.array([-0.5, 0, 2, 4, 8], dtype=float),
                 np.array([-0.5, 0, 1, 8, 16], dtype=float)],
             [[0, 0, 1/16, 1/4, 1], [0, 0, 0, 1, 1]],
             None
         ),
         (
-            [mcolors.SymLogNorm(3, vmin=-30, vmax=5, linscale=1.2),
-                mcolors.PowerNorm(2, vmin=2, vmax=8, clip=False)],
+            mcolors.SymLogNorm(3, vmin=-30, vmax=5, linscale=1.2),
+            mcolors.PowerNorm(2, vmin=2, vmax=8, clip=False),
             [np.array([-30, -1, 2, 6], dtype=float),
                 np.array([-0.5, 0, 1, 8, 16], dtype=float)],
             [[0., 0.53980074, 0.826991, 1.02758204], [0, 0, 0, 1, 1]],
@@ -309,8 +311,8 @@ def _mask_tester(norm_instance, vals):
             'SymLogNorm_and_PowerNorm_clip_in_call'
     ]
 )
-def test_norm2d(norm_instances, values, expected, clip):
-    norm = mcolors.Norm2d(norm_instances=norm_instances)
+def test_BivariateNorm(norm1, norm2, values, expected, clip):
+    norm = mcolors.BivariateNorm(norm1=norm1, norm2=norm2)
     ans1, ans2 = norm(values=values, clip=clip)
     assert_array_almost_equal(ans1, expected[0])
     assert_array_almost_equal(ans2, expected[1])

From 01787306fe5fcfc9dd986c3186d55d066bb3b820 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Mon, 3 Jul 2017 15:45:27 +0530
Subject: [PATCH 03/35] Bivariate works with imshow, pcolor, pcolormesh,
 pcolorfast

---
 lib/matplotlib/axes/_axes.py | 96 ++++++++++++++++++++++++++++++++----
 lib/matplotlib/colors.py     | 31 +++++++++++-
 2 files changed, 115 insertions(+), 12 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index e2610703489d..19ad5a112b1c 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5141,12 +5141,30 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
         if not self._hold:
             self.cla()
 
-        if norm is not None and not isinstance(norm, mcolors.Normalize):
-            msg = "'norm' must be an instance of 'mcolors.Normalize'"
+        isNorm = isinstance(norm, (mcolors.Normalize, mcolors.BivariateNorm))
+        if norm is not None and not isNorm:
+            msg = "'norm' must be an instance of 'mcolors.Normalize' " \
+                  "or 'mcolors.BivariateNorm'"
             raise ValueError(msg)
+
         if aspect is None:
             aspect = rcParams['image.aspect']
         self.set_aspect(aspect)
+
+        temp = np.asarray(X)
+        if (temp.ndim == 3 and isinstance(norm, mcolors.BivariateNorm) or
+                isinstance(cmap, mcolors.BivariateColormap)):
+            if cmap is None:
+                cmap = mcolors.BivariateColormap()
+            if norm is None:
+                norm = mcolors.BivariateNorm()
+            temp = norm(temp)
+            temp[0] = temp[0] * (cmap.N-1)
+            temp[1] = temp[1] * (cmap.N-1)
+            temp = temp.astype(int)
+            X = temp[0] + cmap.N * temp[1]
+            norm = mcolors.NoNorm()
+
         im = mimage.AxesImage(self, cmap, norm, interpolation, origin, extent,
                               filternorm=filternorm, filterrad=filterrad,
                               resample=resample, **kwargs)
@@ -5173,7 +5191,6 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
 
     @staticmethod
     def _pcolorargs(funcname, *args, **kw):
-        # This takes one kwarg, allmatch.
         # If allmatch is True, then the incoming X, Y, C must
         # have matching dimensions, taking into account that
         # X and Y can be 1-D rather than 2-D.  This perfect
@@ -5186,9 +5203,25 @@ def _pcolorargs(funcname, *args, **kw):
         # is False.
 
         allmatch = kw.pop("allmatch", False)
+        norm = kw.pop("norm", None)
+        cmap = kw.pop("cmap", None)
 
         if len(args) == 1:
             C = np.asanyarray(args[0])
+
+            if (C.ndim == 3 and isinstance(norm, mcolors.BivariateNorm) or
+                    isinstance(cmap, mcolors.BivariateColormap)):
+                if cmap is None:
+                    cmap = mcolors.BivariateColormap()
+                if norm is None:
+                    norm = mcolors.BivariateNorm()
+                C = norm(C)
+                C[0] = C[0] * (cmap.N-1)
+                C[1] = C[1] * (cmap.N-1)
+                C = C.astype(int)
+                C = C[0] + cmap.N * C[1]
+                C = np.array(C)
+
             numRows, numCols = C.shape
             if allmatch:
                 X, Y = np.meshgrid(np.arange(numCols), np.arange(numRows))
@@ -5200,6 +5233,18 @@ def _pcolorargs(funcname, *args, **kw):
 
         if len(args) == 3:
             X, Y, C = [np.asanyarray(a) for a in args]
+            if (C.ndim == 3 and isinstance(norm, mcolors.BivariateNorm) or
+                    isinstance(cmap, mcolors.BivariateColormap)):
+                if cmap is None:
+                    cmap = mcolors.BivariateColormap()
+                if norm is None:
+                    norm = mcolors.BivariateNorm()
+                C = norm(C)
+                C[0] = C[0] * (cmap.N-1)
+                C[1] = C[1] * (cmap.N-1)
+                C = C.astype(int)
+                C = C[0] + cmap.N * C[1]
+                C = np.array(C)
             numRows, numCols = C.shape
         else:
             raise TypeError(
@@ -5382,9 +5427,14 @@ def pcolor(self, *args, **kwargs):
         vmin = kwargs.pop('vmin', None)
         vmax = kwargs.pop('vmax', None)
 
-        X, Y, C = self._pcolorargs('pcolor', *args, allmatch=False)
+        kw = {'norm': norm, 'cmap': cmap, 'allmatch': False}
+        X, Y, C = self._pcolorargs('pcolor', *args, **kw)
         Ny, Nx = X.shape
 
+        if (isinstance(norm, mcolors.BivariateNorm) or
+                isinstance(cmap, mcolors.BivariateColormap)):
+            norm = mcolors.NoNorm()
+
         # unit conversion allows e.g. datetime objects as axis values
         self._process_unit_info(xdata=X, ydata=Y, kwargs=kwargs)
         X = self.convert_xunits(X)
@@ -5450,9 +5500,13 @@ def pcolor(self, *args, **kwargs):
 
         collection.set_alpha(alpha)
         collection.set_array(C)
-        if norm is not None and not isinstance(norm, mcolors.Normalize):
-            msg = "'norm' must be an instance of 'mcolors.Normalize'"
+
+        isNorm = isinstance(norm, (mcolors.Normalize, mcolors.BivariateNorm))
+        if norm is not None and not isNorm:
+            msg = "'norm' must be an instance of 'mcolors.Normalize' " \
+                  "or 'mcolors.BivariateNorm'"
             raise ValueError(msg)
+
         collection.set_cmap(cmap)
         collection.set_norm(norm)
         collection.set_clim(vmin, vmax)
@@ -5582,9 +5636,14 @@ def pcolormesh(self, *args, **kwargs):
 
         allmatch = (shading == 'gouraud')
 
-        X, Y, C = self._pcolorargs('pcolormesh', *args, allmatch=allmatch)
+        kw = {'norm': norm, 'cmap': cmap, 'allmatch': allmatch}
+        X, Y, C = self._pcolorargs('pcolormesh', *args, **kw)
         Ny, Nx = X.shape
 
+        if (isinstance(norm, mcolors.BivariateNorm) or
+                isinstance(cmap, mcolors.BivariateColormap)):
+            norm = mcolors.NoNorm()
+
         # unit conversion allows e.g. datetime objects as axis values
         self._process_unit_info(xdata=X, ydata=Y, kwargs=kwargs)
         X = self.convert_xunits(X)
@@ -5723,11 +5782,28 @@ def pcolorfast(self, *args, **kwargs):
         cmap = kwargs.pop('cmap', None)
         vmin = kwargs.pop('vmin', None)
         vmax = kwargs.pop('vmax', None)
-        if norm is not None and not isinstance(norm, mcolors.Normalize):
-            msg = "'norm' must be an instance of 'mcolors.Normalize'"
+        isNorm = isinstance(norm, (mcolors.Normalize, mcolors.BivariateNorm))
+        if norm is not None and not isNorm:
+            msg = "'norm' must be an instance of 'mcolors.Normalize' " \
+                  "or 'mcolors.BivariateNorm'"
             raise ValueError(msg)
 
-        C = args[-1]
+        C = np.asarray(args[-1])
+
+        if (C.ndim == 3 and isinstance(norm, mcolors.BivariateNorm) or
+                isinstance(cmap, mcolors.BivariateColormap)):
+            if cmap is None:
+                cmap = mcolors.BivariateColormap()
+            if norm is None:
+                norm = mcolors.BivariateNorm()
+            C = norm(C)
+            C[0] = C[0] * (cmap.N-1)
+            C[1] = C[1] * (cmap.N-1)
+            C = C.astype(int)
+            C = C[0] + cmap.N * C[1]
+            C = np.array(C)
+            norm = mcolors.NoNorm()
+
         nr, nc = C.shape
         if len(args) == 1:
             style = "image"
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index da536abeef4b..5259c24a7bfc 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -858,6 +858,32 @@ def reversed(self, name=None):
         return ListedColormap(colors_r, name=name, N=self.N)
 
 
+class BivariateColormap(Colormap):
+    def __init__(self, name, N=256):
+        Colormap.__init__(self, name, N)
+
+    def _init(self):
+        red = np.linspace(0, 1, self.N)
+        green = np.linspace(0, 1, self.N)
+        red_mesh, green_mesh = np.meshgrid(red, green)
+        blue_mesh = np.zeros_like(red_mesh)
+        alpha_mesh = np.ones_like(red_mesh)
+        bivariate_cmap = np.dstack((red_mesh, green_mesh, blue_mesh, alpha_mesh))
+        self._lut = np.vstack(bivariate_cmap)
+        self._isinit = True
+        self.N = self.N * self.N
+        self._set_extremes()
+
+    def _resample(self, lutsize):
+        """
+        Return a new color map with *lutsize x lutsize* entries.
+        """
+        return BivariateColormap(self.name, lutsize)
+
+    def reversed(self, name=None):
+        raise NotImplementedError()
+
+
 class Normalize(object):
     """
     A class which, when called, can normalize data into
@@ -1390,8 +1416,8 @@ def __call__(self, values, clip=None):
         if clip is None:
             clip = [self.norm1.clip, self.norm2.clip]
 
-        return [self.norm1(values[0], clip=clip[0]),
-                self.norm2(values[1], clip=clip[1])]
+        return np.array([self.norm1(values[0], clip=clip[0]),
+                self.norm2(values[1], clip=clip[1])])
 
     def inverse(self, values):
         """
@@ -1406,6 +1432,7 @@ def inverse(self, values):
         """
         return [self.norm1.inverse(values[0]), self.norm.inverse(values[1])]
 
+
 def rgb_to_hsv(arr):
     """
     convert float rgb values (in the range [0, 1]), in a numpy array to hsv

From 575a244eca6fbffb67049c78ad09e69d8b2459e8 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Mon, 10 Jul 2017 01:55:10 +0530
Subject: [PATCH 04/35] add blank line between bivariate classes

---
 lib/matplotlib/colors.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 5259c24a7bfc..ee1f906af280 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -1375,6 +1375,7 @@ def __call__(self, value, clip=None):
     def inverse(self, value):
         return value
 
+
 class BivariateNorm:
     """
     Normalize a list of two values corresponding to two 1D normalizers

From 8425637d93d07603fd036dcb2d2409d17e49a83e Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Mon, 10 Jul 2017 03:51:33 +0530
Subject: [PATCH 05/35] Add support for bivariate in scatter

---
 lib/matplotlib/axes/_axes.py | 17 +++++++++++++++--
 lib/matplotlib/colors.py     |  2 +-
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 19ad5a112b1c..51e580007795 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3979,6 +3979,17 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
         else:
             try:
                 c_array = np.asanyarray(c, dtype=float)
+                if c_array.ndim > 1:
+                    if cmap is None:
+                        cmap = mcolors.BivariateColormap()
+                    if norm is None:
+                        norm = mcolors.BivariateNorm()
+                    c_array = norm(c_array)
+                    c_array[0] = c_array[0] * (cmap.N-1)
+                    c_array[1] = c_array[1] * (cmap.N-1)
+                    c_array = c_array.astype(int)
+                    c_array = c_array[0] + cmap.N * c_array[1]
+                    norm = mcolors.NoNorm()
                 if c_array.shape in xy_shape:
                     c = np.ma.ravel(c_array)
                 else:
@@ -4043,8 +4054,10 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
         collection.update(kwargs)
 
         if colors is None:
-            if norm is not None and not isinstance(norm, mcolors.Normalize):
-                msg = "'norm' must be an instance of 'mcolors.Normalize'"
+            isNorm = isinstance(norm, (mcolors.Normalize, mcolors.BivariateNorm))
+            if norm is not None and not isNorm:
+                msg = "'norm' must be an instance of 'mcolors.Normalize' " \
+                      "or 'mcolors.BivariateNorm'"
                 raise ValueError(msg)
             collection.set_array(np.asarray(c))
             collection.set_cmap(cmap)
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index ee1f906af280..f132abb6cb6c 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -859,7 +859,7 @@ def reversed(self, name=None):
 
 
 class BivariateColormap(Colormap):
-    def __init__(self, name, N=256):
+    def __init__(self, name='bivariate', N=256):
         Colormap.__init__(self, name, N)
 
     def _init(self):

From 4a5831dece20057d4264898915e5d6c8b7466543 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Tue, 11 Jul 2017 23:37:04 +0530
Subject: [PATCH 06/35] Fix missing norm2 in BivaraiteNorm

---
 lib/matplotlib/colors.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index f132abb6cb6c..f3c5a0f682bd 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -1431,7 +1431,8 @@ def inverse(self, values):
         -------
         A list of two unnormalized values
         """
-        return [self.norm1.inverse(values[0]), self.norm.inverse(values[1])]
+        return np.asarray([self.norm1.inverse(values[0]),
+                self.norm2.inverse(values[1])])
 
 
 def rgb_to_hsv(arr):

From 85df736206c6849a969a29a4f7848618cdcd5120 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Thu, 13 Jul 2017 00:06:59 +0530
Subject: [PATCH 07/35] Fixed bug in if condition bivariate mapping

---
 lib/matplotlib/axes/_axes.py | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 51e580007795..34fc461b924a 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5165,8 +5165,9 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
         self.set_aspect(aspect)
 
         temp = np.asarray(X)
-        if (temp.ndim == 3 and isinstance(norm, mcolors.BivariateNorm) or
-                isinstance(cmap, mcolors.BivariateColormap)):
+        isBivari = (isinstance(norm, mcolors.BivariateNorm) or
+                    isinstance(cmap, mcolors.BivariateColormap))
+        if (temp.ndim == 3 and isBivari):
             if cmap is None:
                 cmap = mcolors.BivariateColormap()
             if norm is None:
@@ -5222,8 +5223,9 @@ def _pcolorargs(funcname, *args, **kw):
         if len(args) == 1:
             C = np.asanyarray(args[0])
 
-            if (C.ndim == 3 and isinstance(norm, mcolors.BivariateNorm) or
-                    isinstance(cmap, mcolors.BivariateColormap)):
+            isBivari = (isinstance(norm, mcolors.BivariateNorm) or
+                        isinstance(cmap, mcolors.BivariateColormap))
+            if (C.ndim == 3 and isBivari):
                 if cmap is None:
                     cmap = mcolors.BivariateColormap()
                 if norm is None:
@@ -5246,8 +5248,9 @@ def _pcolorargs(funcname, *args, **kw):
 
         if len(args) == 3:
             X, Y, C = [np.asanyarray(a) for a in args]
-            if (C.ndim == 3 and isinstance(norm, mcolors.BivariateNorm) or
-                    isinstance(cmap, mcolors.BivariateColormap)):
+            isBivari = (isinstance(norm, mcolors.BivariateNorm) or
+                        isinstance(cmap, mcolors.BivariateColormap))
+            if (C.ndim == 3 and isBivari):
                 if cmap is None:
                     cmap = mcolors.BivariateColormap()
                 if norm is None:
@@ -5803,8 +5806,9 @@ def pcolorfast(self, *args, **kwargs):
 
         C = np.asarray(args[-1])
 
-        if (C.ndim == 3 and isinstance(norm, mcolors.BivariateNorm) or
-                isinstance(cmap, mcolors.BivariateColormap)):
+        isBivari = (isinstance(norm, mcolors.BivariateNorm) or
+                    isinstance(cmap, mcolors.BivariateColormap))
+        if (C.ndim == 3 and isBivari):
             if cmap is None:
                 cmap = mcolors.BivariateColormap()
             if norm is None:

From 8e1bc63720ad7fd856993a95f277256cd60fe6f4 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Thu, 13 Jul 2017 12:26:21 +0530
Subject: [PATCH 08/35] Add autoscale, autoscale_None, scaled methods for
 BivariateNorm

---
 lib/matplotlib/colors.py | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index f3c5a0f682bd..98b0ff87d180 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -1417,7 +1417,7 @@ def __call__(self, values, clip=None):
         if clip is None:
             clip = [self.norm1.clip, self.norm2.clip]
 
-        return np.array([self.norm1(values[0], clip=clip[0]),
+        return np.asarray([self.norm1(values[0], clip=clip[0]),
                 self.norm2(values[1], clip=clip[1])])
 
     def inverse(self, values):
@@ -1434,6 +1434,22 @@ def inverse(self, values):
         return np.asarray([self.norm1.inverse(values[0]),
                 self.norm2.inverse(values[1])])
 
+    def autoscale(self, A):
+        """
+        Set *vmin*, *vmax* to min, max of *A*.
+        """
+        self.norm1.autoscale(A[0])
+        self.norm2.autoscale(A[1])
+
+    def autoscale_None(self, A):
+        'autoscale only None-valued vmin or vmax'
+        self.norm1.autoscale_None(A[0])
+        self.norm2.autoscale_None(A[1])
+
+    def scaled(self):
+        'return true if vmin and vmax set for both normalizers'
+        return self.norm1.scaled() and self.norm2.scaled()
+
 
 def rgb_to_hsv(arr):
     """

From a9aace387a70d3986024fac172c27a7c7a596149 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Mon, 17 Jul 2017 01:38:00 +0530
Subject: [PATCH 09/35] trying to show ticks and labels on both x and y axis

---
 lib/matplotlib/cm.py       |   3 +-
 lib/matplotlib/colorbar.py | 560 ++++++++++++++++++++++++++++++++++++-
 2 files changed, 560 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/cm.py b/lib/matplotlib/cm.py
index bdf3e1575653..b9b59bbbdd1f 100644
--- a/lib/matplotlib/cm.py
+++ b/lib/matplotlib/cm.py
@@ -201,7 +201,8 @@ def __init__(self, norm=None, cmap=None):
         #: The Normalization instance of this ScalarMappable.
         self.norm = norm
         #: The Colormap instance of this ScalarMappable.
-        self.cmap = get_cmap(cmap)
+        # self.cmap = get_cmap(cmap)
+        self.cmap = cmap
         #: The last colorbar associated with this ScalarMappable. May be None.
         self.colorbar = None
         self.update_dict = {'array': False}
diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index 0fb4e3b47c17..a0d2b18c2191 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -900,7 +900,562 @@ def remove(self):
         fig.delaxes(self.ax)
 
 
-class Colorbar(ColorbarBase):
+class Colorsquare(ColorbarBase):
+    def __init__(self, ax, cmap=None,
+                 norm=None,
+                 alpha=None,
+                 values=None,
+                 boundaries=None,
+                 ticklocation='auto',
+                 extend='neither',
+                 spacing='uniform',  # uniform or proportional
+                 ticks=None,
+                 format=None,
+                 drawedges=False,
+                 filled=True,
+                 extendfrac=None,
+                 extendrect=False,
+                 xlabel='',
+                 ylabel='',
+                 ):
+        #: The axes that this colorbar lives in.
+        self.ax = ax
+        self._patch_ax()
+        if cmap is None:
+            cmap = colors.BivariateColormap()
+        if norm is None:
+            norm = colors.BivariateNorm()
+        self.alpha = alpha
+        cm.ScalarMappable.__init__(self, cmap=cmap, norm=norm)
+        self.values = values
+        self.boundaries = boundaries
+        self.extend = extend
+        self._inside = self._slice_dict[extend]
+        self.spacing = spacing
+        self.drawedges = drawedges
+        self.filled = filled
+        self.extendfrac = extendfrac
+        self.extendrect = extendrect
+        self.solids = None
+        self.lines = list()
+        self.outline = None
+        self.patch = None
+        self.dividers = None
+
+        self.set_label(xlabel, ylabel)
+        if cbook.iterable(ticks):
+            self.locator = ticker.FixedLocator(ticks, nbins=len(ticks))
+        else:
+            self.locator = ticks    # Handle default in _ticker()
+        if format is None:
+            if isinstance(self.norm, colors.LogNorm):
+                self.formatter = ticker.LogFormatterSciNotation()
+            elif isinstance(self.norm, colors.SymLogNorm):
+                self.formatter = ticker.LogFormatterSciNotation(
+                                        linthresh=self.norm.linthresh)
+            else:
+                self.formatter = ticker.ScalarFormatter()
+        elif isinstance(format, six.string_types):
+            self.formatter = ticker.FormatStrFormatter(format)
+        else:
+            self.formatter = format  # Assume it is a Formatter
+        # The rest is in a method so we can recalculate when clim changes.
+        self.config_axis()
+        self.draw_all()
+
+    def draw_all(self):
+        '''
+        Calculate any free parameters based on the current cmap and norm,
+        and do all the drawing.
+        '''
+
+        self._process_values()
+        self._find_range()
+        X, Y = self._mesh()
+        C = self._values[:, np.newaxis]
+        self._config_axes(X, Y)
+        if self.filled:
+            self._add_solids(X, Y, C)
+
+    def config_axis(self):
+        ax = self.ax
+
+        ax.yaxis.set_label_position('right')
+        ax.yaxis.set_ticks_position('right')
+
+        ax.xaxis.set_label_position('bottom')
+        ax.xaxis.set_ticks_position('bottom')
+
+        self._set_label()
+
+    def update_ticks(self):
+        """
+        Force the update of the ticks and ticklabels. This must be
+        called whenever the tick locator and/or tick formatter changes.
+        """
+        ax = self.ax
+        # xticks, yticks, xticklabels, yticklabels, offset_string = self._ticker()
+        yticks, yticklabels, offset_string = self._ticker()
+        xticks = []
+        xticklabels = ''
+        ax.yaxis.set_ticks(yticks)
+        ax.set_yticklabels(yticklabels)
+        ax.yaxis.get_major_formatter().set_offset_string(offset_string)
+        ax.xaxis.set_ticks(xticks)
+        ax.set_xticklabels(xticklabels)
+        ax.xaxis.get_major_formatter().set_offset_string(offset_string)
+
+    def set_ticks(self, xticks, yticks, update_ticks=True):
+        """
+        Set tick locations.
+
+        Parameters
+        ----------
+        ticks : {None, sequence, :class:`~matplotlib.ticker.Locator` instance}
+            If None, a default Locator will be used.
+
+        update_ticks : {True, False}, optional
+            If True, tick locations are updated immediately.  If False,
+            use :meth:`update_ticks` to manually update the ticks.
+
+        """
+        if cbook.iterable(xticks):
+            self.xlocator = ticker.FixedLocator(xticks, nbins=len(ticks))
+        else:
+            self.xlocator = xticks
+
+        if cbook.iterable(yticks):
+            self.ylocator = ticker.FixedLocator(yticks, nbins=len(ticks))
+        else:
+            self.ylocator = yticks
+
+        if update_ticks:
+            self.update_ticks()
+        self.stale = True
+
+    def get_ticks(self, minor=False):
+        """Return the x ticks as a list of locations"""
+        return self._tick_data_values
+
+    def set_ticklabels(self, ticklabels, update_ticks=True):
+        """
+        set tick labels. Tick labels are updated immediately unless
+        update_ticks is *False*. To manually update the ticks, call
+        *update_ticks* method explicitly.
+        """
+        if isinstance(self.locator, ticker.FixedLocator):
+            self.formatter = ticker.FixedFormatter(ticklabels)
+            if update_ticks:
+                self.update_ticks()
+        else:
+            warnings.warn("set_ticks() must have been called.")
+        self.stale = True
+
+    def _config_axes(self, X, Y):
+        '''
+        Make an axes patch and outline.
+        '''
+        ax = self.ax
+        ax.set_frame_on(False)
+        ax.set_navigate(False)
+        xy = self._outline(X, Y)
+        ax.update_datalim(xy)
+        ax.set_xlim(*ax.dataLim.intervalx)
+        ax.set_ylim(*ax.dataLim.intervaly)
+        if self.outline is not None:
+            self.outline.remove()
+        self.outline = mpatches.Polygon(
+            xy, edgecolor=mpl.rcParams['axes.edgecolor'],
+            facecolor='none',
+            linewidth=mpl.rcParams['axes.linewidth'],
+            closed=True,
+            zorder=2)
+        ax.add_artist(self.outline)
+        self.outline.set_clip_box(None)
+        self.outline.set_clip_path(None)
+        c = mpl.rcParams['axes.facecolor']
+        if self.patch is not None:
+            self.patch.remove()
+        self.patch = mpatches.Polygon(xy, edgecolor=c,
+                                      facecolor=c,
+                                      linewidth=0.01,
+                                      zorder=-1)
+        ax.add_artist(self.patch)
+
+        self.update_ticks()
+
+    def _set_label(self):
+        self.ax.set_ylabel(self._ylabel, **self._labelkw)
+        self.ax.set_xlabel(self._xlabel, **self._labelkw)
+        self.stale = True
+
+    def set_label(self, xlabel, ylabel, **kw):
+        '''
+        Label the long axis of the colorbar
+        '''
+        self._xlabel = '%s' % (xlabel, )
+        self._ylabel = '%s' % (ylabel, )
+        self._labelkw = kw
+        self._set_label()
+
+    def _outline(self, X, Y):
+        '''
+        Return *x*, *y* arrays of colorbar bounding polygon,
+        taking orientation into account.
+        '''
+        N = X.shape[0]
+        ii = [0, 1, N - 2, N - 1, 2 * N - 1, 2 * N - 2, N + 1, N, 0]
+        x = np.take(np.ravel(np.transpose(X)), ii)
+        y = np.take(np.ravel(np.transpose(Y)), ii)
+        x = x.reshape((len(x), 1))
+        y = y.reshape((len(y), 1))
+        # if self.orientation == 'horizontal':
+        #    return np.hstack((y, x))
+        return np.hstack((x, y))
+
+    def _edges(self, X, Y):
+        '''
+        Return the separator line segments; helper for _add_solids.
+        '''
+        pass
+
+    def _add_solids(self, X, Y, C):
+        '''
+        Draw the colors using :meth:`~matplotlib.axes.Axes.pcolormesh`;
+        optionally add separators.
+        '''
+        # if self.orientation == 'vertical':
+        args = (X, Y, C)
+        # else:
+        #    args = (np.transpose(Y), np.transpose(X), np.transpose(C))
+        kw = dict(cmap=self.cmap,
+                  norm=self.norm,
+                  alpha=self.alpha,
+                  edgecolors='None')
+        # Save, set, and restore hold state to keep pcolor from
+        # clearing the axes. Ordinarily this will not be needed,
+        # since the axes object should already have hold set.
+        _hold = self.ax._hold
+        self.ax._hold = True
+        col = self.ax.pcolormesh(*args, **kw)
+        self.ax._hold = _hold
+        #self.add_observer(col) # We should observe, not be observed...
+
+        if self.solids is not None:
+            self.solids.remove()
+        self.solids = col
+        if self.dividers is not None:
+            self.dividers.remove()
+            self.dividers = None
+        if self.drawedges:
+            linewidths = (0.5 * mpl.rcParams['axes.linewidth'],)
+            """
+            self.dividers = collections.LineCollection(self._edges(X, Y),
+                                    colors=(mpl.rcParams['axes.edgecolor'],),
+                                    linewidths=linewidths)
+            self.ax.add_collection(self.dividers)
+            """
+        elif len(self._y) >= self.n_rasterize:
+            self.solids.set_rasterized(True)
+
+    def add_lines(self, levels, colors, linewidths, erase=True):
+        '''
+        Draw lines on the colorbar.
+
+        *colors* and *linewidths* must be scalars or
+        sequences the same length as *levels*.
+
+        Set *erase* to False to add lines without first
+        removing any previously added lines.
+        '''
+        y = self._locate(levels)
+        igood = (y < 1.001) & (y > -0.001)
+        y = y[igood]
+        if cbook.iterable(colors):
+            colors = np.asarray(colors)[igood]
+        if cbook.iterable(linewidths):
+            linewidths = np.asarray(linewidths)[igood]
+        N = len(y)
+        x = np.array([0.0, 1.0])
+        X, Y = np.meshgrid(x, y)
+        if self.orientation == 'vertical':
+            xy = [list(zip(X[i], Y[i])) for i in xrange(N)]
+        else:
+            xy = [list(zip(Y[i], X[i])) for i in xrange(N)]
+        col = collections.LineCollection(xy, linewidths=linewidths)
+
+        if erase and self.lines:
+            for lc in self.lines:
+                lc.remove()
+            self.lines = []
+        self.lines.append(col)
+        col.set_color(colors)
+        self.ax.add_collection(col)
+        self.stale = True
+
+    def _ticker(self):
+        '''
+        Return the sequence of ticks (colorbar data locations),
+        ticklabels (strings), and the corresponding offset string.
+        '''
+        locator = self.locator
+        formatter = self.formatter
+        if locator is None:
+            if self.boundaries is None:
+                if isinstance(self.norm, colors.NoNorm):
+                    nv = len(self._values)
+                    base = 1 + int(nv / 10)
+                    locator = ticker.IndexLocator(base=base, offset=0)
+                elif isinstance(self.norm, colors.BoundaryNorm):
+                    b = self.norm.boundaries
+                    locator = ticker.FixedLocator(b, nbins=10)
+                elif isinstance(self.norm, colors.LogNorm):
+                    locator = ticker.LogLocator(subs='all')
+                elif isinstance(self.norm, colors.SymLogNorm):
+                    # The subs setting here should be replaced
+                    # by logic in the locator.
+                    locator = ticker.SymmetricalLogLocator(
+                                      subs=np.arange(1, 10),
+                                      linthresh=self.norm.linthresh,
+                                      base=10)
+                else:
+                    if mpl.rcParams['_internal.classic_mode']:
+                        locator = ticker.MaxNLocator()
+                    else:
+                        locator = ticker.AutoLocator()
+            else:
+                b = self._boundaries[self._inside]
+                locator = ticker.FixedLocator(b, nbins=10)
+        if isinstance(self.norm, colors.NoNorm) and self.boundaries is None:
+            intv = self._values[0], self._values[-1]
+        else:
+            intv = self.vmin, self.vmax
+        locator.create_dummy_axis(minpos=intv[0])
+        formatter.create_dummy_axis(minpos=intv[0])
+        locator.set_view_interval(*intv)
+        locator.set_data_interval(*intv)
+        formatter.set_view_interval(*intv)
+        formatter.set_data_interval(*intv)
+
+        b = np.array(locator())
+        if isinstance(locator, ticker.LogLocator):
+            eps = 1e-10
+            b = b[(b <= intv[1] * (1 + eps)) & (b >= intv[0] * (1 - eps))]
+        else:
+            eps = (intv[1] - intv[0]) * 1e-10
+            b = b[(b <= intv[1] + eps) & (b >= intv[0] - eps)]
+        self._tick_data_values = b
+        ticks = self._locate(b)
+        formatter.set_locs(b)
+        ticklabels = [formatter(t, i) for i, t in enumerate(b)]
+        offset_string = formatter.get_offset()
+        return ticks, ticklabels, offset_string
+
+    def _process_values(self, b=None):
+        '''
+        Set the :attr:`_boundaries` and :attr:`_values` attributes
+        based on the input boundaries and values.  Input boundaries
+        can be *self.boundaries* or the argument *b*.
+        '''
+        if b is None:
+            b = self.boundaries
+        if b is not None:
+            self._boundaries = np.asarray(b, dtype=float)
+            if self.values is None:
+                self._values = 0.5 * (self._boundaries[:-1]
+                                      + self._boundaries[1:])
+                if isinstance(self.norm, colors.NoNorm):
+                    self._values = (self._values + 0.00001).astype(np.int16)
+                return
+            self._values = np.array(self.values)
+            return
+        if self.values is not None:
+            self._values = np.array(self.values)
+            if self.boundaries is None:
+                b = np.zeros(len(self.values) + 1, 'd')
+                b[1:-1] = 0.5 * (self._values[:-1] - self._values[1:])
+                b[0] = 2.0 * b[1] - b[2]
+                b[-1] = 2.0 * b[-2] - b[-3]
+                self._boundaries = b
+                return
+            self._boundaries = np.array(self.boundaries)
+            return
+        # Neither boundaries nor values are specified;
+        # make reasonable ones based on cmap and norm.
+        if isinstance(self.norm, colors.NoNorm):
+            b = self._uniform_y(self.cmap.N + 1) * self.cmap.N - 0.5
+            v = np.zeros((len(b) - 1,), dtype=np.int16)
+            v[self._inside] = np.arange(self.cmap.N, dtype=np.int16)
+            if self._extend_lower():
+                v[0] = -1
+            if self._extend_upper():
+                v[-1] = self.cmap.N
+            self._boundaries = b
+            self._values = v
+            return
+        elif isinstance(self.norm, colors.BoundaryNorm):
+            b = list(self.norm.boundaries)
+            if self._extend_lower():
+                b = [b[0] - 1] + b
+            if self._extend_upper():
+                b = b + [b[-1] + 1]
+            b = np.array(b)
+            v = np.zeros((len(b) - 1,), dtype=float)
+            bi = self.norm.boundaries
+            v[self._inside] = 0.5 * (bi[:-1] + bi[1:])
+            if self._extend_lower():
+                v[0] = b[0] - 1
+            if self._extend_upper():
+                v[-1] = b[-1] + 1
+            self._boundaries = b
+            self._values = v
+            return
+        else:
+            if not self.norm.scaled():
+                self.norm.vmin = 0
+                self.norm.vmax = 1
+
+            self.norm.vmin, self.norm.vmax = mtransforms.nonsingular(
+                self.norm.vmin,
+                self.norm.vmax,
+                expander=0.1)
+
+            b = self.norm.inverse(self._uniform_y(self.cmap.N + 1))
+
+            if isinstance(self.norm, colors.LogNorm):
+                # If using a lognorm, ensure extensions don't go negative
+                if self._extend_lower():
+                    b[0] = 0.9 * b[0]
+                if self._extend_upper():
+                    b[-1] = 1.1 * b[-1]
+            else:
+                if self._extend_lower():
+                    b[0] = b[0] - 1
+                if self._extend_upper():
+                    b[-1] = b[-1] + 1
+        self._process_values(b)
+
+    def _find_range(self):
+        '''
+        Set :attr:`vmin` and :attr:`vmax` attributes to the first and
+        last boundary excluding extended end boundaries.
+        '''
+        b = self._boundaries[self._inside]
+        self.vmin = b[0]
+        self.vmax = b[-1]
+
+    def _central_N(self):
+        '''number of boundaries **before** extension of ends'''
+        nb = len(self._boundaries)
+        if self.extend == 'both':
+            nb -= 2
+        elif self.extend in ('min', 'max'):
+            nb -= 1
+        return nb
+
+    def _extended_N(self):
+        '''
+        Based on the colormap and extend variable, return the
+        number of boundaries.
+        '''
+        N = self.cmap.N + 1
+        if self.extend == 'both':
+            N += 2
+        elif self.extend in ('min', 'max'):
+            N += 1
+        return N
+
+    def _proportional_y(self):
+        '''
+        Return colorbar data coordinates for the boundaries of
+        a proportional colorbar.
+        '''
+        if isinstance(self.norm, colors.BoundaryNorm):
+            y = (self._boundaries - self._boundaries[0])
+            y = y / (self._boundaries[-1] - self._boundaries[0])
+        else:
+            y = self.norm(self._boundaries.copy())
+            y = np.ma.filled(y, np.nan)
+        if self.extend == 'min':
+            # Exclude leftmost interval of y.
+            clen = y[-1] - y[1]
+            automin = (y[2] - y[1]) / clen
+            automax = (y[-1] - y[-2]) / clen
+        elif self.extend == 'max':
+            # Exclude rightmost interval in y.
+            clen = y[-2] - y[0]
+            automin = (y[1] - y[0]) / clen
+            automax = (y[-2] - y[-3]) / clen
+        elif self.extend == 'both':
+            # Exclude leftmost and rightmost intervals in y.
+            clen = y[-2] - y[1]
+            automin = (y[2] - y[1]) / clen
+            automax = (y[-2] - y[-3]) / clen
+        if self.extend in ('both', 'min', 'max'):
+            extendlength = self._get_extension_lengths(self.extendfrac,
+                                                       automin, automax,
+                                                       default=0.05)
+        if self.extend in ('both', 'min'):
+            y[0] = 0. - extendlength[0]
+        if self.extend in ('both', 'max'):
+            y[-1] = 1. + extendlength[1]
+        yi = y[self._inside]
+        norm = colors.Normalize(yi[0], yi[-1])
+        y[self._inside] = np.ma.filled(norm(yi), np.nan)
+        return y
+
+    def _mesh(self):
+        '''
+        Return X,Y, the coordinate arrays for the colorbar pcolormesh.
+        These are suitable for a vertical colorbar; swapping and
+        transposition for a horizontal colorbar are done outside
+        this function.
+        '''
+        x = np.array([0.0, 1.0])
+        if self.spacing == 'uniform':
+            y = self._uniform_y(self._central_N())
+        else:
+            y = self._proportional_y()
+        self._y = y
+        X, Y = np.meshgrid(x, y)
+        if self._extend_lower() and not self.extendrect:
+            X[0, :] = 0.5
+        if self._extend_upper() and not self.extendrect:
+            X[-1, :] = 0.5
+        return X, Y
+
+    def _locate(self, x):
+        '''
+        Given a set of color data values, return their
+        corresponding colorbar data coordinates.
+        '''
+        if isinstance(self.norm, (colors.NoNorm, colors.BoundaryNorm)):
+            b = self._boundaries
+            xn = x
+        else:
+            # Do calculations using normalized coordinates so
+            # as to make the interpolation more accurate.
+            b = self.norm(self._boundaries, clip=False).filled()
+            xn = self.norm(x, clip=False).filled()
+
+        # The rest is linear interpolation with extrapolation at ends.
+        ii = np.searchsorted(b, xn)
+        i0 = ii - 1
+        itop = (ii == len(b))
+        ibot = (ii == 0)
+        i0[itop] -= 1
+        ii[itop] -= 1
+        i0[ibot] += 1
+        ii[ibot] += 1
+
+        db = np.take(b, ii) - np.take(b, i0)
+        y = self._y
+        dy = np.take(y, ii) - np.take(y, i0)
+        z = np.take(y, i0) + (xn - np.take(b, i0)) * dy / db
+        return z
+
+
+class Colorbar(Colorsquare):
     """
     This class connects a :class:`ColorbarBase` to a
     :class:`~matplotlib.cm.ScalarMappable` such as a
@@ -940,7 +1495,7 @@ def __init__(self, ax, mappable, **kw):
             if isinstance(mappable, martist.Artist):
                 kw['alpha'] = mappable.get_alpha()
 
-            ColorbarBase.__init__(self, ax, **kw)
+            Colorsquare.__init__(self, ax, **kw)
 
     def on_mappable_changed(self, mappable):
         """
@@ -1362,6 +1917,7 @@ def colorbar_factory(cax, mappable, **kwargs):
             and any([hatch is not None for hatch in mappable.hatches])):
         cb = ColorbarPatch(cax, mappable, **kwargs)
     else:
+        temp = kwargs.pop('orientation', 'vert')
         cb = Colorbar(cax, mappable, **kwargs)
 
     cid = mappable.callbacksSM.connect('changed', cb.on_mappable_changed)

From 55a7a689f5b10a64ea8d7ff0e6db15e19e37c3a5 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Mon, 17 Jul 2017 12:47:55 +0530
Subject: [PATCH 10/35] commented outline code, changed gridspace to show
 sqaure colorbar

---
 lib/matplotlib/colorbar.py | 31 +++++++++++++++++--------------
 1 file changed, 17 insertions(+), 14 deletions(-)

diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index a0d2b18c2191..62445db3363f 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -1020,12 +1020,12 @@ def set_ticks(self, xticks, yticks, update_ticks=True):
 
         """
         if cbook.iterable(xticks):
-            self.xlocator = ticker.FixedLocator(xticks, nbins=len(ticks))
+            self.xlocator = ticker.FixedLocator(xticks, nbins=len(xticks))
         else:
             self.xlocator = xticks
 
         if cbook.iterable(yticks):
-            self.ylocator = ticker.FixedLocator(yticks, nbins=len(ticks))
+            self.ylocator = ticker.FixedLocator(yticks, nbins=len(yticks))
         else:
             self.ylocator = yticks
 
@@ -1037,14 +1037,15 @@ def get_ticks(self, minor=False):
         """Return the x ticks as a list of locations"""
         return self._tick_data_values
 
-    def set_ticklabels(self, ticklabels, update_ticks=True):
+    def set_ticklabels(self, xticklabels, yticklabels, update_ticks=True):
         """
         set tick labels. Tick labels are updated immediately unless
         update_ticks is *False*. To manually update the ticks, call
         *update_ticks* method explicitly.
         """
         if isinstance(self.locator, ticker.FixedLocator):
-            self.formatter = ticker.FixedFormatter(ticklabels)
+            self.xformatter = ticker.FixedFormatter(xticklabels)
+            self.yformatter = ticker.FixedFormatter(yticklabels)
             if update_ticks:
                 self.update_ticks()
         else:
@@ -1056,14 +1057,15 @@ def _config_axes(self, X, Y):
         Make an axes patch and outline.
         '''
         ax = self.ax
-        ax.set_frame_on(False)
+        # ax.set_frame_on(False)
         ax.set_navigate(False)
-        xy = self._outline(X, Y)
-        ax.update_datalim(xy)
-        ax.set_xlim(*ax.dataLim.intervalx)
-        ax.set_ylim(*ax.dataLim.intervaly)
-        if self.outline is not None:
-            self.outline.remove()
+        # xy = self._outline(X, Y)
+        # ax.update_datalim(xy)
+        # ax.set_xlim(*ax.dataLim.intervalx)
+        # ax.set_ylim(*ax.dataLim.intervaly)
+        # if self.outline is not None:
+        #    self.outline.remove()
+        """
         self.outline = mpatches.Polygon(
             xy, edgecolor=mpl.rcParams['axes.edgecolor'],
             facecolor='none',
@@ -1073,6 +1075,7 @@ def _config_axes(self, X, Y):
         ax.add_artist(self.outline)
         self.outline.set_clip_box(None)
         self.outline.set_clip_path(None)
+
         c = mpl.rcParams['axes.facecolor']
         if self.patch is not None:
             self.patch.remove()
@@ -1081,7 +1084,7 @@ def _config_axes(self, X, Y):
                                       linewidth=0.01,
                                       zorder=-1)
         ax.add_artist(self.patch)
-
+        """
         self.update_ticks()
 
     def _set_label(self):
@@ -1768,9 +1771,9 @@ def make_axes_gridspec(parent, **kw):
     orientation = kw.setdefault('orientation', 'vertical')
     kw['ticklocation'] = 'auto'
 
-    fraction = kw.pop('fraction', 0.15)
+    fraction = kw.pop('fraction', 0.35)
     shrink = kw.pop('shrink', 1.0)
-    aspect = kw.pop('aspect', 20)
+    aspect = kw.pop('aspect', 1)
 
     x1 = 1.0 - fraction
 

From c2eb617702bca52cc15875ab640628a3eb5b2417 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Mon, 17 Jul 2017 15:06:46 +0530
Subject: [PATCH 11/35] 2d colorbar printing now

---
 lib/matplotlib/colorbar.py | 24 +++++-------------------
 1 file changed, 5 insertions(+), 19 deletions(-)

diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index 62445db3363f..74c0bae946f3 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -972,7 +972,8 @@ def draw_all(self):
         self._process_values()
         self._find_range()
         X, Y = self._mesh()
-        C = self._values[:, np.newaxis]
+        C = np.array(X * 256 * 256  + Y * 256, dtype='int64')
+        # C = self._values[:, np.newaxis]
         self._config_axes(X, Y)
         if self.filled:
             self._add_solids(X, Y, C)
@@ -1101,21 +1102,6 @@ def set_label(self, xlabel, ylabel, **kw):
         self._labelkw = kw
         self._set_label()
 
-    def _outline(self, X, Y):
-        '''
-        Return *x*, *y* arrays of colorbar bounding polygon,
-        taking orientation into account.
-        '''
-        N = X.shape[0]
-        ii = [0, 1, N - 2, N - 1, 2 * N - 1, 2 * N - 2, N + 1, N, 0]
-        x = np.take(np.ravel(np.transpose(X)), ii)
-        y = np.take(np.ravel(np.transpose(Y)), ii)
-        x = x.reshape((len(x), 1))
-        y = y.reshape((len(y), 1))
-        # if self.orientation == 'horizontal':
-        #    return np.hstack((y, x))
-        return np.hstack((x, y))
-
     def _edges(self, X, Y):
         '''
         Return the separator line segments; helper for _add_solids.
@@ -1414,11 +1400,11 @@ def _mesh(self):
         transposition for a horizontal colorbar are done outside
         this function.
         '''
-        x = np.array([0.0, 1.0])
         if self.spacing == 'uniform':
-            y = self._uniform_y(self._central_N())
+            x = y = self._uniform_y(self._central_N())
         else:
-            y = self._proportional_y()
+            x = y = self._proportional_y()
+        self._x = x
         self._y = y
         X, Y = np.meshgrid(x, y)
         if self._extend_lower() and not self.extendrect:

From daef75126ed28ea738e33615b36c12ab62c096a0 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Sun, 23 Jul 2017 03:14:48 +0530
Subject: [PATCH 12/35] Add code for Colorsquare

---
 lib/matplotlib/colorbar.py | 591 ++++++++++++++++---------------------
 1 file changed, 262 insertions(+), 329 deletions(-)

diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index 74c0bae946f3..dd567e439e46 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -900,21 +900,21 @@ def remove(self):
         fig.delaxes(self.ax)
 
 
-class Colorsquare(ColorbarBase):
+class ColorsquareBase(cm.ScalarMappable):
+    n_rasterize = 50  # rasterize solids if number of colors >= n_rasterize
     def __init__(self, ax, cmap=None,
                  norm=None,
                  alpha=None,
-                 values=None,
-                 boundaries=None,
-                 ticklocation='auto',
-                 extend='neither',
-                 spacing='uniform',  # uniform or proportional
-                 ticks=None,
-                 format=None,
+                 xvalues=None,
+                 yvalues=None,
+                 xboundaries=None,
+                 yboundaries=None,
+                 xticks=None,
+                 yticks=None,
+                 xformat=None,
+                 yformat=None,
                  drawedges=False,
                  filled=True,
-                 extendfrac=None,
-                 extendrect=False,
                  xlabel='',
                  ylabel='',
                  ):
@@ -927,59 +927,78 @@ def __init__(self, ax, cmap=None,
             norm = colors.BivariateNorm()
         self.alpha = alpha
         cm.ScalarMappable.__init__(self, cmap=cmap, norm=norm)
-        self.values = values
-        self.boundaries = boundaries
-        self.extend = extend
-        self._inside = self._slice_dict[extend]
-        self.spacing = spacing
+        self.xvalues = xvalues
+        self.yvalues = yvalues
+        self.xboundaries = xboundaries
+        self.yboundaries = yboundaries
+        self._inside = slice(0, None)
         self.drawedges = drawedges
         self.filled = filled
-        self.extendfrac = extendfrac
-        self.extendrect = extendrect
         self.solids = None
         self.lines = list()
-        self.outline = None
-        self.patch = None
         self.dividers = None
-
         self.set_label(xlabel, ylabel)
-        if cbook.iterable(ticks):
-            self.locator = ticker.FixedLocator(ticks, nbins=len(ticks))
+
+        if cbook.iterable(xticks):
+            self.xlocator = ticker.FixedLocator(xticks, nbins=len(xticks))
         else:
-            self.locator = ticks    # Handle default in _ticker()
-        if format is None:
-            if isinstance(self.norm, colors.LogNorm):
-                self.formatter = ticker.LogFormatterSciNotation()
-            elif isinstance(self.norm, colors.SymLogNorm):
-                self.formatter = ticker.LogFormatterSciNotation(
-                                        linthresh=self.norm.linthresh)
+            self.xlocator = xticks    # Handle default in _ticker()
+
+        if cbook.iterable(yticks):
+            self.ylocator = ticker.FixedLocator(yticks, nbins=len(yticks))
+        else:
+            self.ylocator = yticks
+
+        if xformat is None:
+            if isinstance(self.norm.norm1, colors.LogNorm):
+                self.xformatter = ticker.LogFormatterSciNotation()
+            elif isinstance(self.norm.norm1, colors.SymLogNorm):
+                self.xformatter = ticker.LogFormatterSciNotation(
+                                        linthresh=self.norm.norm1.linthresh)
             else:
-                self.formatter = ticker.ScalarFormatter()
-        elif isinstance(format, six.string_types):
-            self.formatter = ticker.FormatStrFormatter(format)
+                self.xformatter = ticker.ScalarFormatter()
+        elif isinstance(xformat, six.string_types):
+            self.xformatter = ticker.FormatStrFormatter(xformat)
         else:
-            self.formatter = format  # Assume it is a Formatter
+            self.xformatter = xformat  # Assume it is a Formatter
+
+        if yformat is None:
+            if isinstance(self.norm.norm2, colors.LogNorm):
+                self.yformatter = ticker.LogFormatterSciNotation()
+            elif isinstance(self.norm.norm2, colors.SymLogNorm):
+                self.yformatter = ticker.LogFormatterSciNotation(
+                                        linthresh=self.norm.norm2.linthresh)
+            else:
+                self.yformatter = ticker.ScalarFormatter()
+        elif isinstance(yformat, six.string_types):
+            self.yformatter = ticker.FormatStrFormatter(yformat)
+        else:
+            self.yformatter = yformat  # Assume it is a Formatter
+
         # The rest is in a method so we can recalculate when clim changes.
         self.config_axis()
         self.draw_all()
 
-    def draw_all(self):
-        '''
-        Calculate any free parameters based on the current cmap and norm,
-        and do all the drawing.
-        '''
+    def _patch_ax(self):
+        # bind some methods to the axes to warn users
+        # against using those methods.
+        self.ax.set_xticks = _set_ticks_on_axis_warn
+        self.ax.set_yticks = _set_ticks_on_axis_warn
 
-        self._process_values()
-        self._find_range()
+    def draw_all(self):
+        normx = self.norm.norm1
+        normy = self.norm.norm2
+        self._xvalues, self._xboundaries = self._process_values(norm=normx)
+        self._yvalues, self._yboundaries = self._process_values(norm=normy)
         X, Y = self._mesh()
-        C = np.array(X * 256 * 256  + Y * 256, dtype='int64')
-        # C = self._values[:, np.newaxis]
-        self._config_axes(X, Y)
+        CX, CY = np.meshgrid(self._xvalues, self._yvalues)
+        self.update_ticks()
         if self.filled:
-            self._add_solids(X, Y, C)
+            self._add_solids(X, Y, [CX, CY])
 
     def config_axis(self):
         ax = self.ax
+        ax.set_navigate(False)
 
         ax.yaxis.set_label_position('right')
         ax.yaxis.set_ticks_position('right')
@@ -995,31 +1014,18 @@ def update_ticks(self):
         called whenever the tick locator and/or tick formatter changes.
         """
         ax = self.ax
-        # xticks, yticks, xticklabels, yticklabels, offset_string = self._ticker()
-        yticks, yticklabels, offset_string = self._ticker()
-        xticks = []
-        xticklabels = ''
-        ax.yaxis.set_ticks(yticks)
-        ax.set_yticklabels(yticklabels)
-        ax.yaxis.get_major_formatter().set_offset_string(offset_string)
+        xticks, xticklabels, xoffset_string = self._ticker(self.norm.norm1)
+        yticks, yticklabels, yoffset_string = self._ticker(self.norm.norm2)
+
         ax.xaxis.set_ticks(xticks)
         ax.set_xticklabels(xticklabels)
-        ax.xaxis.get_major_formatter().set_offset_string(offset_string)
-
-    def set_ticks(self, xticks, yticks, update_ticks=True):
-        """
-        Set tick locations.
-
-        Parameters
-        ----------
-        ticks : {None, sequence, :class:`~matplotlib.ticker.Locator` instance}
-            If None, a default Locator will be used.
+        ax.xaxis.get_major_formatter().set_offset_string(xoffset_string)
 
-        update_ticks : {True, False}, optional
-            If True, tick locations are updated immediately.  If False,
-            use :meth:`update_ticks` to manually update the ticks.
+        ax.yaxis.set_ticks(yticks)
+        ax.set_yticklabels(yticklabels)
+        ax.yaxis.get_major_formatter().set_offset_string(yoffset_string)
 
-        """
+    def set_ticks(self, xticks, yticks, update_ticks=True):
         if cbook.iterable(xticks):
             self.xlocator = ticker.FixedLocator(xticks, nbins=len(xticks))
         else:
@@ -1034,59 +1040,28 @@ def set_ticks(self, xticks, yticks, update_ticks=True):
             self.update_ticks()
         self.stale = True
 
-    def get_ticks(self, minor=False):
-        """Return the x ticks as a list of locations"""
-        return self._tick_data_values
-
-    def set_ticklabels(self, xticklabels, yticklabels, update_ticks=True):
+    def set_ticklabels(self, xticklabels=None, yticklabels=None,
+                       update_ticks=True):
         """
         set tick labels. Tick labels are updated immediately unless
         update_ticks is *False*. To manually update the ticks, call
         *update_ticks* method explicitly.
         """
-        if isinstance(self.locator, ticker.FixedLocator):
-            self.xformatter = ticker.FixedFormatter(xticklabels)
-            self.yformatter = ticker.FixedFormatter(yticklabels)
+        if xticklabels is not None or yticklabels is not None:
+            if isinstance(self.xlocator, ticker.FixedLocator):
+                self.xformatter = ticker.FixedFormatter(xticklabels)
+
+            if isinstance(self.ylocator, ticker.FixedLocator):
+                self.yformatter = ticker.FixedFormatter(yticklabels)
+
             if update_ticks:
                 self.update_ticks()
-        else:
-            warnings.warn("set_ticks() must have been called.")
-        self.stale = True
 
-    def _config_axes(self, X, Y):
-        '''
-        Make an axes patch and outline.
-        '''
-        ax = self.ax
-        # ax.set_frame_on(False)
-        ax.set_navigate(False)
-        # xy = self._outline(X, Y)
-        # ax.update_datalim(xy)
-        # ax.set_xlim(*ax.dataLim.intervalx)
-        # ax.set_ylim(*ax.dataLim.intervaly)
-        # if self.outline is not None:
-        #    self.outline.remove()
-        """
-        self.outline = mpatches.Polygon(
-            xy, edgecolor=mpl.rcParams['axes.edgecolor'],
-            facecolor='none',
-            linewidth=mpl.rcParams['axes.linewidth'],
-            closed=True,
-            zorder=2)
-        ax.add_artist(self.outline)
-        self.outline.set_clip_box(None)
-        self.outline.set_clip_path(None)
+            self.stale = True
+            return
 
-        c = mpl.rcParams['axes.facecolor']
-        if self.patch is not None:
-            self.patch.remove()
-        self.patch = mpatches.Polygon(xy, edgecolor=c,
-                                      facecolor=c,
-                                      linewidth=0.01,
-                                      zorder=-1)
-        ax.add_artist(self.patch)
-        """
-        self.update_ticks()
+        warnings.warn("set_ticks() must have been called.")
+        self.stale = True
 
     def _set_label(self):
         self.ax.set_ylabel(self._ylabel, **self._labelkw)
@@ -1095,7 +1070,7 @@ def _set_label(self):
 
     def set_label(self, xlabel, ylabel, **kw):
         '''
-        Label the long axis of the colorbar
+        Label the axes of the colorbar
         '''
         self._xlabel = '%s' % (xlabel, )
         self._ylabel = '%s' % (ylabel, )
@@ -1106,17 +1081,16 @@ def _edges(self, X, Y):
         '''
         Return the separator line segments; helper for _add_solids.
         '''
-        pass
+        N = X.shape[0].
+        return [list(zip(X[i], Y[i])) for i in xrange(1, N - 1)]
+        + [list(zip(Y[i], X[i])) for i in xrange(1, N - 1)]
 
     def _add_solids(self, X, Y, C):
         '''
         Draw the colors using :meth:`~matplotlib.axes.Axes.pcolormesh`;
         optionally add separators.
         '''
-        # if self.orientation == 'vertical':
         args = (X, Y, C)
-        # else:
-        #    args = (np.transpose(Y), np.transpose(X), np.transpose(C))
         kw = dict(cmap=self.cmap,
                   norm=self.norm,
                   alpha=self.alpha,
@@ -1128,7 +1102,6 @@ def _add_solids(self, X, Y, C):
         self.ax._hold = True
         col = self.ax.pcolormesh(*args, **kw)
         self.ax._hold = _hold
-        #self.add_observer(col) # We should observe, not be observed...
 
         if self.solids is not None:
             self.solids.remove()
@@ -1138,74 +1111,49 @@ def _add_solids(self, X, Y, C):
             self.dividers = None
         if self.drawedges:
             linewidths = (0.5 * mpl.rcParams['axes.linewidth'],)
-            """
             self.dividers = collections.LineCollection(self._edges(X, Y),
                                     colors=(mpl.rcParams['axes.edgecolor'],),
                                     linewidths=linewidths)
             self.ax.add_collection(self.dividers)
-            """
-        elif len(self._y) >= self.n_rasterize:
+        elif(len(self._y) >= self.n_rasterize
+             or len(self._x) >= self.n_rasterize):
             self.solids.set_rasterized(True)
 
-    def add_lines(self, levels, colors, linewidths, erase=True):
-        '''
-        Draw lines on the colorbar.
-
-        *colors* and *linewidths* must be scalars or
-        sequences the same length as *levels*.
-
-        Set *erase* to False to add lines without first
-        removing any previously added lines.
-        '''
-        y = self._locate(levels)
-        igood = (y < 1.001) & (y > -0.001)
-        y = y[igood]
-        if cbook.iterable(colors):
-            colors = np.asarray(colors)[igood]
-        if cbook.iterable(linewidths):
-            linewidths = np.asarray(linewidths)[igood]
-        N = len(y)
-        x = np.array([0.0, 1.0])
-        X, Y = np.meshgrid(x, y)
-        if self.orientation == 'vertical':
-            xy = [list(zip(X[i], Y[i])) for i in xrange(N)]
-        else:
-            xy = [list(zip(Y[i], X[i])) for i in xrange(N)]
-        col = collections.LineCollection(xy, linewidths=linewidths)
-
-        if erase and self.lines:
-            for lc in self.lines:
-                lc.remove()
-            self.lines = []
-        self.lines.append(col)
-        col.set_color(colors)
-        self.ax.add_collection(col)
-        self.stale = True
-
-    def _ticker(self):
+    def _ticker(self, norm):
         '''
         Return the sequence of ticks (colorbar data locations),
         ticklabels (strings), and the corresponding offset string.
         '''
-        locator = self.locator
-        formatter = self.formatter
+        if norm is self.norm.norm1:
+            _values = self._xvalues
+            _boundaries = self._xboundaries
+            boundaries = self.xboundaries
+            locator = self.xlocator
+            formatter = self.xformatter
+        else:
+            _values = self._yvalues
+            _boundaries = self._yboundaries
+            boundaries = self.yboundaries
+            locator = self.ylocator
+            formatter = self.yformatter
+
         if locator is None:
-            if self.boundaries is None:
-                if isinstance(self.norm, colors.NoNorm):
-                    nv = len(self._values)
+            if boundaries is None:
+                if isinstance(norm, colors.NoNorm):
+                    nv = len(_values)
                     base = 1 + int(nv / 10)
                     locator = ticker.IndexLocator(base=base, offset=0)
-                elif isinstance(self.norm, colors.BoundaryNorm):
-                    b = self.norm.boundaries
+                elif isinstance(norm, colors.BoundaryNorm):
+                    b = norm.boundaries
                     locator = ticker.FixedLocator(b, nbins=10)
-                elif isinstance(self.norm, colors.LogNorm):
+                elif isinstance(norm, colors.LogNorm):
                     locator = ticker.LogLocator(subs='all')
-                elif isinstance(self.norm, colors.SymLogNorm):
+                elif isinstance(norm, colors.SymLogNorm):
                     # The subs setting here should be replaced
                     # by logic in the locator.
                     locator = ticker.SymmetricalLogLocator(
                                       subs=np.arange(1, 10),
-                                      linthresh=self.norm.linthresh,
+                                      linthresh=norm.linthresh,
                                       base=10)
                 else:
                     if mpl.rcParams['_internal.classic_mode']:
@@ -1213,12 +1161,13 @@ def _ticker(self):
                     else:
                         locator = ticker.AutoLocator()
             else:
-                b = self._boundaries[self._inside]
+                b = _boundaries[self._inside]
                 locator = ticker.FixedLocator(b, nbins=10)
-        if isinstance(self.norm, colors.NoNorm) and self.boundaries is None:
-            intv = self._values[0], self._values[-1]
+        if isinstance(norm, colors.NoNorm) and boundaries is None:
+            intv = _values[0], _values[-1]
         else:
-            intv = self.vmin, self.vmax
+            b = _boundaries[self._inside]
+            intv = b[0], b[-1]
         locator.create_dummy_axis(minpos=intv[0])
         formatter.create_dummy_axis(minpos=intv[0])
         locator.set_view_interval(*intv)
@@ -1233,199 +1182,96 @@ def _ticker(self):
         else:
             eps = (intv[1] - intv[0]) * 1e-10
             b = b[(b <= intv[1] + eps) & (b >= intv[0] - eps)]
-        self._tick_data_values = b
-        ticks = self._locate(b)
+        # self._tick_data_values = b
+        ticks = self._locate(b, norm)
         formatter.set_locs(b)
         ticklabels = [formatter(t, i) for i, t in enumerate(b)]
         offset_string = formatter.get_offset()
         return ticks, ticklabels, offset_string
 
-    def _process_values(self, b=None):
-        '''
-        Set the :attr:`_boundaries` and :attr:`_values` attributes
-        based on the input boundaries and values.  Input boundaries
-        can be *self.boundaries* or the argument *b*.
-        '''
+    def _process_values(self, b=None, norm=None):
+        if norm is self.norm.norm1:
+            boundaries = self.xboundaries
+            values = self.xvalues
+        else:
+            boundaries = self.yboundaries
+            values = self.yvalues
         if b is None:
-            b = self.boundaries
+            b = boundaries
         if b is not None:
-            self._boundaries = np.asarray(b, dtype=float)
-            if self.values is None:
-                self._values = 0.5 * (self._boundaries[:-1]
-                                      + self._boundaries[1:])
-                if isinstance(self.norm, colors.NoNorm):
-                    self._values = (self._values + 0.00001).astype(np.int16)
-                return
-            self._values = np.array(self.values)
-            return
-        if self.values is not None:
-            self._values = np.array(self.values)
-            if self.boundaries is None:
-                b = np.zeros(len(self.values) + 1, 'd')
-                b[1:-1] = 0.5 * (self._values[:-1] - self._values[1:])
+            b = np.asarray(b, dtype=float)
+            if values is None:
+                v = 0.5 * (b[:-1] + b[1:])
+                if isinstance(norm, colors.NoNorm):
+                    v = (v + 0.00001).astype(np.int16)
+                return v, b
+            v = np.array(self.values)
+            return v, b
+        if values is not None:
+            v = np.array(values)
+            if boundaries is None:
+                b = np.zeros(len(values) + 1, 'd')
+                b[1:-1] = 0.5 * (v[:-1] - v[1:])
                 b[0] = 2.0 * b[1] - b[2]
                 b[-1] = 2.0 * b[-2] - b[-3]
-                self._boundaries = b
-                return
-            self._boundaries = np.array(self.boundaries)
-            return
+                return v, b
+            b = np.array(boundaries)
+            return v, b
         # Neither boundaries nor values are specified;
         # make reasonable ones based on cmap and norm.
-        if isinstance(self.norm, colors.NoNorm):
-            b = self._uniform_y(self.cmap.N + 1) * self.cmap.N - 0.5
+        N = self.cmap.N
+        if isinstance(norm, colors.NoNorm):
+            b = np.linspace(0, 1, np.sqrt(N) + 1) * np.sqrt(N) - 0.5
             v = np.zeros((len(b) - 1,), dtype=np.int16)
-            v[self._inside] = np.arange(self.cmap.N, dtype=np.int16)
-            if self._extend_lower():
-                v[0] = -1
-            if self._extend_upper():
-                v[-1] = self.cmap.N
-            self._boundaries = b
-            self._values = v
-            return
-        elif isinstance(self.norm, colors.BoundaryNorm):
-            b = list(self.norm.boundaries)
-            if self._extend_lower():
-                b = [b[0] - 1] + b
-            if self._extend_upper():
-                b = b + [b[-1] + 1]
+            v[self._inside] = np.arange(np.sqrt(N), dtype=np.int16)
+            return v, b
+        elif isinstance(norm, colors.BoundaryNorm):
+            b = list(norm.boundaries)
             b = np.array(b)
             v = np.zeros((len(b) - 1,), dtype=float)
-            bi = self.norm.boundaries
+            bi = norm.boundaries
             v[self._inside] = 0.5 * (bi[:-1] + bi[1:])
-            if self._extend_lower():
-                v[0] = b[0] - 1
-            if self._extend_upper():
-                v[-1] = b[-1] + 1
-            self._boundaries = b
-            self._values = v
-            return
+            return v, b
         else:
-            if not self.norm.scaled():
-                self.norm.vmin = 0
-                self.norm.vmax = 1
+            if not norm.scaled():
+                norm.vmin = 0
+                norm.norm1.vmax = 1
 
-            self.norm.vmin, self.norm.vmax = mtransforms.nonsingular(
-                self.norm.vmin,
-                self.norm.vmax,
-                expander=0.1)
+            norm.vmin, norm.vmax = mtransforms.nonsingular(
+                norm.vmin, norm.vmax, expander=0.1)
 
-            b = self.norm.inverse(self._uniform_y(self.cmap.N + 1))
+            b = norm.inverse(np.linspace(0, 1, np.sqrt(N) + 1))
 
-            if isinstance(self.norm, colors.LogNorm):
-                # If using a lognorm, ensure extensions don't go negative
-                if self._extend_lower():
-                    b[0] = 0.9 * b[0]
-                if self._extend_upper():
-                    b[-1] = 1.1 * b[-1]
-            else:
-                if self._extend_lower():
-                    b[0] = b[0] - 1
-                if self._extend_upper():
-                    b[-1] = b[-1] + 1
-        self._process_values(b)
-
-    def _find_range(self):
-        '''
-        Set :attr:`vmin` and :attr:`vmax` attributes to the first and
-        last boundary excluding extended end boundaries.
-        '''
-        b = self._boundaries[self._inside]
-        self.vmin = b[0]
-        self.vmax = b[-1]
-
-    def _central_N(self):
-        '''number of boundaries **before** extension of ends'''
-        nb = len(self._boundaries)
-        if self.extend == 'both':
-            nb -= 2
-        elif self.extend in ('min', 'max'):
-            nb -= 1
-        return nb
-
-    def _extended_N(self):
-        '''
-        Based on the colormap and extend variable, return the
-        number of boundaries.
-        '''
-        N = self.cmap.N + 1
-        if self.extend == 'both':
-            N += 2
-        elif self.extend in ('min', 'max'):
-            N += 1
-        return N
-
-    def _proportional_y(self):
-        '''
-        Return colorbar data coordinates for the boundaries of
-        a proportional colorbar.
-        '''
-        if isinstance(self.norm, colors.BoundaryNorm):
-            y = (self._boundaries - self._boundaries[0])
-            y = y / (self._boundaries[-1] - self._boundaries[0])
-        else:
-            y = self.norm(self._boundaries.copy())
-            y = np.ma.filled(y, np.nan)
-        if self.extend == 'min':
-            # Exclude leftmost interval of y.
-            clen = y[-1] - y[1]
-            automin = (y[2] - y[1]) / clen
-            automax = (y[-1] - y[-2]) / clen
-        elif self.extend == 'max':
-            # Exclude rightmost interval in y.
-            clen = y[-2] - y[0]
-            automin = (y[1] - y[0]) / clen
-            automax = (y[-2] - y[-3]) / clen
-        elif self.extend == 'both':
-            # Exclude leftmost and rightmost intervals in y.
-            clen = y[-2] - y[1]
-            automin = (y[2] - y[1]) / clen
-            automax = (y[-2] - y[-3]) / clen
-        if self.extend in ('both', 'min', 'max'):
-            extendlength = self._get_extension_lengths(self.extendfrac,
-                                                       automin, automax,
-                                                       default=0.05)
-        if self.extend in ('both', 'min'):
-            y[0] = 0. - extendlength[0]
-        if self.extend in ('both', 'max'):
-            y[-1] = 1. + extendlength[1]
-        yi = y[self._inside]
-        norm = colors.Normalize(yi[0], yi[-1])
-        y[self._inside] = np.ma.filled(norm(yi), np.nan)
-        return y
+        return self._process_values(b=b, norm=norm)
 
     def _mesh(self):
         '''
         Return X,Y, the coordinate arrays for the colorbar pcolormesh.
-        These are suitable for a vertical colorbar; swapping and
-        transposition for a horizontal colorbar are done outside
-        this function.
         '''
-        if self.spacing == 'uniform':
-            x = y = self._uniform_y(self._central_N())
-        else:
-            x = y = self._proportional_y()
+        x = np.linspace(0, 1, len(self._xboundaries))
+        y = np.linspace(0, 1, len(self._yboundaries))
         self._x = x
         self._y = y
         X, Y = np.meshgrid(x, y)
-        if self._extend_lower() and not self.extendrect:
-            X[0, :] = 0.5
-        if self._extend_upper() and not self.extendrect:
-            X[-1, :] = 0.5
         return X, Y
 
-    def _locate(self, x):
+    def _locate(self, x, norm):
         '''
         Given a set of color data values, return their
         corresponding colorbar data coordinates.
         '''
-        if isinstance(self.norm, (colors.NoNorm, colors.BoundaryNorm)):
-            b = self._boundaries
+        if norm is self.norm.norm1:
+            boundaries = self._xboundaries
+        else:
+            boundaries = self._yboundaries
+        if isinstance(norm, (colors.NoNorm, colors.BoundaryNorm)):
+            b = boundaries
             xn = x
         else:
             # Do calculations using normalized coordinates so
             # as to make the interpolation more accurate.
-            b = self.norm(self._boundaries, clip=False).filled()
-            xn = self.norm(x, clip=False).filled()
+            b = norm(boundaries, clip=False).filled()
+            xn = norm(x, clip=False).filled()
 
         # The rest is linear interpolation with extrapolation at ends.
         ii = np.searchsorted(b, xn)
@@ -1443,8 +1289,17 @@ def _locate(self, x):
         z = np.take(y, i0) + (xn - np.take(b, i0)) * dy / db
         return z
 
+    def set_alpha(self, alpha):
+        self.alpha = alpha
 
-class Colorbar(Colorsquare):
+    def remove(self):
+        """
+        Remove this colorsquare from the figure
+        """
+        fig = self.ax.figure
+        fig.delaxes(self.ax)
+
+class Colorbar(ColorbarBase):
     """
     This class connects a :class:`ColorbarBase` to a
     :class:`~matplotlib.cm.ScalarMappable` such as a
@@ -1484,7 +1339,7 @@ def __init__(self, ax, mappable, **kw):
             if isinstance(mappable, martist.Artist):
                 kw['alpha'] = mappable.get_alpha()
 
-            Colorsquare.__init__(self, ax, **kw)
+            ColorbarBase.__init__(self, ax, **kw)
 
     def on_mappable_changed(self, mappable):
         """
@@ -1599,6 +1454,81 @@ def remove(self):
             ax.set_subplotspec(subplotspec)
 
 
+class Colorsquare(ColorsquareBase):
+    """
+    This class connects a :class:`Colorbarsquare` to a
+    :class:`~matplotlib.cm.ScalarMappable` such as a
+    :class:`~matplotlib.image.AxesImage` generated via
+    :meth:`~matplotlib.axes.Axes.imshow`.
+
+    It is not intended to be instantiated directly; instead,
+    use :meth:`~matplotlib.figure.Figure.colorbar` or
+    :func:`~matplotlib.pyplot.colorbar` to make your colorsquare.
+
+    """
+    def __init__(self, ax, mappable, **kw):
+        # Ensure the given mappable's norm has appropriate vmin and vmax set
+        # even if mappable.draw has not yet been called.
+        mappable.autoscale_None()
+
+        self.mappable = mappable
+        kw['cmap'] = cmap = mappable.cmap
+        kw['norm'] = norm = mappable.norm
+
+        if isinstance(mappable, martist.Artist):
+            kw['alpha'] = mappable.get_alpha()
+
+        ColorsquareBase.__init__(self, ax, **kw)
+
+    def on_mappable_changed(self, mappable):
+        """
+        Updates this colorsquare to match the mappable's properties.
+
+        Typically this is automatically registered as an event handler
+        by :func:`colorbar_factory` and should not be called manually.
+
+        """
+        self.set_cmap(mappable.get_cmap())
+        self.set_clim(mappable.get_clim())
+        self.update_normal(mappable)
+
+    def update_normal(self, mappable):
+        '''
+        update solid, lines, etc. Unlike update_bruteforce, it does
+        not clear the axes.  This is meant to be called when the image
+        or contour plot to which this colorsquare belongs is changed.
+        '''
+        self.draw_all()
+        self.stale = True
+
+    def remove(self):
+        """
+        Remove this colorsquare from the figure.  If the colorsquare was
+        created with ``use_gridspec=True`` then restore the gridspec to its
+        previous value.
+        """
+        Colorbarsquare.remove(self)
+        self.mappable.callbacksSM.disconnect(self.mappable.colorbar_cid)
+        self.mappable.colorbar = None
+        self.mappable.colorbar_cid = None
+
+        try:
+            ax = self.mappable.axes
+        except AttributeError:
+            return
+
+        try:
+            gs = ax.get_subplotspec().get_gridspec()
+            subplotspec = gs.get_topmost_subplotspec()
+        except AttributeError:
+            # use_gridspec was False
+            pos = ax.get_position(original=True)
+            ax.set_position(pos)
+        else:
+            # use_gridspec was True
+            ax.set_subplotspec(subplotspec)
+
+
 @docstring.Substitution(make_axes_kw_doc)
 def make_axes(parents, location=None, orientation=None, fraction=0.15,
               shrink=1.0, aspect=20, **kw):
@@ -1757,9 +1687,9 @@ def make_axes_gridspec(parent, **kw):
     orientation = kw.setdefault('orientation', 'vertical')
     kw['ticklocation'] = 'auto'
 
-    fraction = kw.pop('fraction', 0.35)
+    fraction = kw.pop('fraction', 0.15)
     shrink = kw.pop('shrink', 1.0)
-    aspect = kw.pop('aspect', 1)
+    aspect = kw.pop('aspect', 20)
 
     x1 = 1.0 - fraction
 
@@ -1905,8 +1835,11 @@ def colorbar_factory(cax, mappable, **kwargs):
     if (isinstance(mappable, contour.ContourSet)
             and any([hatch is not None for hatch in mappable.hatches])):
         cb = ColorbarPatch(cax, mappable, **kwargs)
+    elif (isinstance(mappable.norm, colors.BivariateNorm)):
+        kwargs.pop('orientation', None)
+        kwargs.pop('ticklocation', None)
+        cb = Colorsquare(cax, mappable, **kwargs)
     else:
-        temp = kwargs.pop('orientation', 'vert')
         cb = Colorbar(cax, mappable, **kwargs)
 
     cid = mappable.callbacksSM.connect('changed', cb.on_mappable_changed)

From 96af3d30f9d5111d46f689be395c5ef1d54619d9 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Sun, 23 Jul 2017 03:31:45 +0530
Subject: [PATCH 13/35] Modify axis aspect and fraction for colorsquare

---
 lib/matplotlib/figure.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index d47fa4d2d935..8cc95dc78569 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -35,6 +35,7 @@
 from matplotlib.image import FigureImage
 
 import matplotlib.colorbar as cbar
+import matplotlib.colors as mcolors
 
 from matplotlib.axes import Axes, SubplotBase, subplot_class_factory
 from matplotlib.blocking_input import BlockingMouseInput, BlockingKeyMouseInput
@@ -1834,6 +1835,9 @@ def colorbar(self, mappable, cax=None, ax=None, use_gridspec=True, **kw):
         # Store the value of gca so that we can set it back later on.
         current_ax = self.gca()
 
+        if isinstance(mappable.norm, mcolors.BivariateNorm):
+            kw['fraction'] = 0.30
+            kw['aspect'] = 1
         if cax is None:
             if use_gridspec and isinstance(ax, SubplotBase):
                 cax, kw = cbar.make_axes_gridspec(ax, **kw)

From 9285372fc69ed855cce6a874c7e22050cd1381d7 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Sun, 23 Jul 2017 03:47:28 +0530
Subject: [PATCH 14/35] fix failing commits

---
 lib/matplotlib/axes/_axes.py        | 66 ++++++-----------------------
 lib/matplotlib/cm.py                |  3 +-
 lib/matplotlib/colorbar.py          |  5 ++-
 lib/matplotlib/colors.py            | 21 +++------
 lib/matplotlib/tests/test_colors.py | 45 --------------------
 5 files changed, 22 insertions(+), 118 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 34fc461b924a..575e1a6e871f 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3979,17 +3979,6 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
         else:
             try:
                 c_array = np.asanyarray(c, dtype=float)
-                if c_array.ndim > 1:
-                    if cmap is None:
-                        cmap = mcolors.BivariateColormap()
-                    if norm is None:
-                        norm = mcolors.BivariateNorm()
-                    c_array = norm(c_array)
-                    c_array[0] = c_array[0] * (cmap.N-1)
-                    c_array[1] = c_array[1] * (cmap.N-1)
-                    c_array = c_array.astype(int)
-                    c_array = c_array[0] + cmap.N * c_array[1]
-                    norm = mcolors.NoNorm()
                 if c_array.shape in xy_shape:
                     c = np.ma.ravel(c_array)
                 else:
@@ -4054,10 +4043,8 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
         collection.update(kwargs)
 
         if colors is None:
-            isNorm = isinstance(norm, (mcolors.Normalize, mcolors.BivariateNorm))
-            if norm is not None and not isNorm:
-                msg = "'norm' must be an instance of 'mcolors.Normalize' " \
-                      "or 'mcolors.BivariateNorm'"
+            if norm is not None and not isinstance(norm, mcolors.Normalize):
+                msg = "'norm' must be an instance of 'mcolors.Normalize'"
                 raise ValueError(msg)
             collection.set_array(np.asarray(c))
             collection.set_cmap(cmap)
@@ -5151,6 +5138,11 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
 
         """
 
+        temp = np.asarray(X)
+        if temp.ndim == 3 and isinstance(norm, mcolors.BivariateNorm):
+                    temp = norm(temp)
+                    X = cmap(temp, alpha=self.get_alpha(), bytes=True)
+
         if not self._hold:
             self.cla()
 
@@ -5164,21 +5156,6 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
             aspect = rcParams['image.aspect']
         self.set_aspect(aspect)
 
-        temp = np.asarray(X)
-        isBivari = (isinstance(norm, mcolors.BivariateNorm) or
-                    isinstance(cmap, mcolors.BivariateColormap))
-        if (temp.ndim == 3 and isBivari):
-            if cmap is None:
-                cmap = mcolors.BivariateColormap()
-            if norm is None:
-                norm = mcolors.BivariateNorm()
-            temp = norm(temp)
-            temp[0] = temp[0] * (cmap.N-1)
-            temp[1] = temp[1] * (cmap.N-1)
-            temp = temp.astype(int)
-            X = temp[0] + cmap.N * temp[1]
-            norm = mcolors.NoNorm()
-
         im = mimage.AxesImage(self, cmap, norm, interpolation, origin, extent,
                               filternorm=filternorm, filterrad=filterrad,
                               resample=resample, **kwargs)
@@ -5219,10 +5196,10 @@ def _pcolorargs(funcname, *args, **kw):
         allmatch = kw.pop("allmatch", False)
         norm = kw.pop("norm", None)
         cmap = kw.pop("cmap", None)
+        alpha = kw.pop("alpha", 1)
 
         if len(args) == 1:
             C = np.asanyarray(args[0])
-
             isBivari = (isinstance(norm, mcolors.BivariateNorm) or
                         isinstance(cmap, mcolors.BivariateColormap))
             if (C.ndim == 3 and isBivari):
@@ -5231,12 +5208,6 @@ def _pcolorargs(funcname, *args, **kw):
                 if norm is None:
                     norm = mcolors.BivariateNorm()
                 C = norm(C)
-                C[0] = C[0] * (cmap.N-1)
-                C[1] = C[1] * (cmap.N-1)
-                C = C.astype(int)
-                C = C[0] + cmap.N * C[1]
-                C = np.array(C)
-
             numRows, numCols = C.shape
             if allmatch:
                 X, Y = np.meshgrid(np.arange(numCols), np.arange(numRows))
@@ -5256,11 +5227,6 @@ def _pcolorargs(funcname, *args, **kw):
                 if norm is None:
                     norm = mcolors.BivariateNorm()
                 C = norm(C)
-                C[0] = C[0] * (cmap.N-1)
-                C[1] = C[1] * (cmap.N-1)
-                C = C.astype(int)
-                C = C[0] + cmap.N * C[1]
-                C = np.array(C)
             numRows, numCols = C.shape
         else:
             raise TypeError(
@@ -5809,19 +5775,11 @@ def pcolorfast(self, *args, **kwargs):
         isBivari = (isinstance(norm, mcolors.BivariateNorm) or
                     isinstance(cmap, mcolors.BivariateColormap))
         if (C.ndim == 3 and isBivari):
-            if cmap is None:
-                cmap = mcolors.BivariateColormap()
-            if norm is None:
-                norm = mcolors.BivariateNorm()
             C = norm(C)
-            C[0] = C[0] * (cmap.N-1)
-            C[1] = C[1] * (cmap.N-1)
-            C = C.astype(int)
-            C = C[0] + cmap.N * C[1]
-            C = np.array(C)
-            norm = mcolors.NoNorm()
-
-        nr, nc = C.shape
+            nr, nc = C.shape
+            C = cmap(C, alpha=alpha, bytes=True)
+        else:
+            nr, nc = C.shape
         if len(args) == 1:
             style = "image"
             x = [0, nc]
diff --git a/lib/matplotlib/cm.py b/lib/matplotlib/cm.py
index b9b59bbbdd1f..bdf3e1575653 100644
--- a/lib/matplotlib/cm.py
+++ b/lib/matplotlib/cm.py
@@ -201,8 +201,7 @@ def __init__(self, norm=None, cmap=None):
         #: The Normalization instance of this ScalarMappable.
         self.norm = norm
         #: The Colormap instance of this ScalarMappable.
-        # self.cmap = get_cmap(cmap)
-        self.cmap = cmap
+        self.cmap = get_cmap(cmap)
         #: The last colorbar associated with this ScalarMappable. May be None.
         self.colorbar = None
         self.update_dict = {'array': False}
diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index dd567e439e46..ae3d7efbd53f 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -1081,7 +1081,7 @@ def _edges(self, X, Y):
         '''
         Return the separator line segments; helper for _add_solids.
         '''
-        N = X.shape[0].
+        N = X.shape[0]
         return [list(zip(X[i], Y[i])) for i in xrange(1, N - 1)]
         + [list(zip(Y[i], X[i])) for i in xrange(1, N - 1)]
 
@@ -1159,7 +1159,8 @@ def _ticker(self, norm):
                     if mpl.rcParams['_internal.classic_mode']:
                         locator = ticker.MaxNLocator()
                     else:
-                        locator = ticker.AutoLocator()
+                        # locator = ticker.AutoLocator()
+                        locator = ticker.MaxNLocator(nbins=5)
             else:
                 b = _boundaries[self._inside]
                 locator = ticker.FixedLocator(b, nbins=10)
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 98b0ff87d180..ff74839bc1af 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -1417,22 +1417,13 @@ def __call__(self, values, clip=None):
         if clip is None:
             clip = [self.norm1.clip, self.norm2.clip]
 
-        return np.asarray([self.norm1(values[0], clip=clip[0]),
-                self.norm2(values[1], clip=clip[1])])
+        temp = np.asarray([self.norm1(values[0], clip=clip[0]),
+                          self.norm2(values[1], clip=clip[1])])
 
-    def inverse(self, values):
-        """
-        Parameters
-        ----------
-        values : array-like
-            A list of two values to be inverted
-
-        Returns
-        -------
-        A list of two unnormalized values
-        """
-        return np.asarray([self.norm1.inverse(values[0]),
-                self.norm2.inverse(values[1])])
+        temp[0] = temp[0] * (256)
+        temp[1] = temp[1] * (256)
+        temp = temp.astype(int)
+        return temp[0] + temp[1] * 256
 
     def autoscale(self, A):
         """
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index e93f7257c619..721813e62f8f 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -272,51 +272,6 @@ def _mask_tester(norm_instance, vals):
     masked_array[0] = np.ma.masked
     assert_array_equal(masked_array.mask, norm_instance(masked_array).mask)
 
-@pytest.mark.parametrize(
-    'norm1, norm2, values, expected, clip', [
-        (
-            None,
-            None,
-            [[0.2, 0.4, 0.5], [5, 7, 9, 10]],
-            [[0, 0.666667, 1], [0, 0.4, 0.8, 1]],
-            None
-        ),
-        (
-            mcolors.LogNorm(clip=True, vmax=5),
-            None,
-            [[1, 6], [5, 7, 9, 10]],
-            [[0, 1.0], [0, 0.4, 0.8, 1]],
-            None
-        ),
-        (
-            mcolors.PowerNorm(2, vmin=0, vmax=8, clip=None),
-            mcolors.PowerNorm(2, vmin=2, vmax=8, clip=True),
-            [np.array([-0.5, 0, 2, 4, 8], dtype=float),
-                np.array([-0.5, 0, 1, 8, 16], dtype=float)],
-            [[0, 0, 1/16, 1/4, 1], [0, 0, 0, 1, 1]],
-            None
-        ),
-        (
-            mcolors.SymLogNorm(3, vmin=-30, vmax=5, linscale=1.2),
-            mcolors.PowerNorm(2, vmin=2, vmax=8, clip=False),
-            [np.array([-30, -1, 2, 6], dtype=float),
-                np.array([-0.5, 0, 1, 8, 16], dtype=float)],
-            [[0., 0.53980074, 0.826991, 1.02758204], [0, 0, 0, 1, 1]],
-            [False, True]
-        )
-    ], ids=[
-            'norm_is_None',
-            'LogNorm_and_LinearNorm',
-            'PowerNorm_clip_None_and_True',
-            'SymLogNorm_and_PowerNorm_clip_in_call'
-    ]
-)
-def test_BivariateNorm(norm1, norm2, values, expected, clip):
-    norm = mcolors.BivariateNorm(norm1=norm1, norm2=norm2)
-    ans1, ans2 = norm(values=values, clip=clip)
-    assert_array_almost_equal(ans1, expected[0])
-    assert_array_almost_equal(ans2, expected[1])
-
 
 @image_comparison(baseline_images=['levels_and_colors'],
                   extensions=['png'])

From 01b593200ac7bd45cba88c966498b66b22b9a936 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Thu, 27 Jul 2017 19:44:57 +0530
Subject: [PATCH 15/35] Change PEP8 violations

---
 lib/matplotlib/axes/_axes.py | 12 ++++++------
 lib/matplotlib/colorbar.py   | 23 +++++++++++++----------
 2 files changed, 19 insertions(+), 16 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 575e1a6e871f..7b81312f5ad5 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5200,8 +5200,8 @@ def _pcolorargs(funcname, *args, **kw):
 
         if len(args) == 1:
             C = np.asanyarray(args[0])
-            isBivari = (isinstance(norm, mcolors.BivariateNorm) or
-                        isinstance(cmap, mcolors.BivariateColormap))
+            isBivari = isinstance(norm, (mcolors.BivariateNorm,
+                                    mcolors.BivariateColormap))
             if (C.ndim == 3 and isBivari):
                 if cmap is None:
                     cmap = mcolors.BivariateColormap()
@@ -5219,8 +5219,8 @@ def _pcolorargs(funcname, *args, **kw):
 
         if len(args) == 3:
             X, Y, C = [np.asanyarray(a) for a in args]
-            isBivari = (isinstance(norm, mcolors.BivariateNorm) or
-                        isinstance(cmap, mcolors.BivariateColormap))
+            isBivari = isinstance(norm, (mcolors.BivariateNorm,
+                                    mcolors.BivariateColormap))
             if (C.ndim == 3 and isBivari):
                 if cmap is None:
                     cmap = mcolors.BivariateColormap()
@@ -5772,8 +5772,8 @@ def pcolorfast(self, *args, **kwargs):
 
         C = np.asarray(args[-1])
 
-        isBivari = (isinstance(norm, mcolors.BivariateNorm) or
-                    isinstance(cmap, mcolors.BivariateColormap))
+        isBivari = isinstance(norm, (mcolors.BivariateNorm,
+                                mcolors.BivariateColormap))
         if (C.ndim == 3 and isBivari):
             C = norm(C)
             nr, nc = C.shape
diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index ae3d7efbd53f..eb1d7f88a1d9 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -901,7 +901,9 @@ def remove(self):
 
 
 class ColorsquareBase(cm.ScalarMappable):
+
     n_rasterize = 50  # rasterize solids if number of colors >= n_rasterize
+
     def __init__(self, ax, cmap=None,
                  norm=None,
                  alpha=None,
@@ -1069,9 +1071,9 @@ def _set_label(self):
         self.stale = True
 
     def set_label(self, xlabel, ylabel, **kw):
-        '''
+        """
         Label the axes of the colorbar
-        '''
+        """
         self._xlabel = '%s' % (xlabel, )
         self._ylabel = '%s' % (ylabel, )
         self._labelkw = kw
@@ -1086,10 +1088,10 @@ def _edges(self, X, Y):
         + [list(zip(Y[i], X[i])) for i in xrange(1, N - 1)]
 
     def _add_solids(self, X, Y, C):
-        '''
+        """
         Draw the colors using :meth:`~matplotlib.axes.Axes.pcolormesh`;
         optionally add separators.
-        '''
+        """
         args = (X, Y, C)
         kw = dict(cmap=self.cmap,
                   norm=self.norm,
@@ -1120,10 +1122,10 @@ def _add_solids(self, X, Y, C):
             self.solids.set_rasterized(True)
 
     def _ticker(self, norm):
-        '''
+        """
         Return the sequence of ticks (colorbar data locations),
         ticklabels (strings), and the corresponding offset string.
-        '''
+        """
         if norm is self.norm.norm1:
             _values = self._xvalues
             _boundaries = self._xboundaries
@@ -1246,9 +1248,9 @@ def _process_values(self, b=None, norm=None):
         return self._process_values(b=b, norm=norm)
 
     def _mesh(self):
-        '''
+        """
         Return X,Y, the coordinate arrays for the colorbar pcolormesh.
-        '''
+        """
         x = np.linspace(0, 1, len(self._xboundaries))
         y = np.linspace(0, 1, len(self._yboundaries))
         self._x = x
@@ -1257,10 +1259,10 @@ def _mesh(self):
         return X, Y
 
     def _locate(self, x, norm):
-        '''
+        """
         Given a set of color data values, return their
         corresponding colorbar data coordinates.
-        '''
+        """
         if norm is self.norm.norm1:
             boundaries = self._xboundaries
         else:
@@ -1300,6 +1302,7 @@ def remove(self):
         fig = self.ax.figure
         fig.delaxes(self.ax)
 
+
 class Colorbar(ColorbarBase):
     """
     This class connects a :class:`ColorbarBase` to a

From 28288e2028194041e81e651fa6d505c6b367b996 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Sun, 30 Jul 2017 00:06:45 +0530
Subject: [PATCH 16/35] Revert isBivari, remove classic locator

---
 lib/matplotlib/axes/_axes.py | 12 ++++++------
 lib/matplotlib/colorbar.py   |  3 ---
 lib/matplotlib/colors.py     |  3 ++-
 3 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 7b81312f5ad5..c2ccd0fb748c 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5200,8 +5200,8 @@ def _pcolorargs(funcname, *args, **kw):
 
         if len(args) == 1:
             C = np.asanyarray(args[0])
-            isBivari = isinstance(norm, (mcolors.BivariateNorm,
-                                    mcolors.BivariateColormap))
+            isBivari = (isinstance(norm, mcolors.BivariateNorm)
+                        or isinstance(cmap, mcolors.BivariateColormap))
             if (C.ndim == 3 and isBivari):
                 if cmap is None:
                     cmap = mcolors.BivariateColormap()
@@ -5219,8 +5219,8 @@ def _pcolorargs(funcname, *args, **kw):
 
         if len(args) == 3:
             X, Y, C = [np.asanyarray(a) for a in args]
-            isBivari = isinstance(norm, (mcolors.BivariateNorm,
-                                    mcolors.BivariateColormap))
+            isBivari = (isinstance(norm, mcolors.BivariateNorm)
+                        or isinstance(cmap, mcolors.BivariateColormap))
             if (C.ndim == 3 and isBivari):
                 if cmap is None:
                     cmap = mcolors.BivariateColormap()
@@ -5772,8 +5772,8 @@ def pcolorfast(self, *args, **kwargs):
 
         C = np.asarray(args[-1])
 
-        isBivari = isinstance(norm, (mcolors.BivariateNorm,
-                                mcolors.BivariateColormap))
+        isBivari = (isinstance(norm, mcolors.BivariateNorm)
+                    or isinstance(cmap, mcolors.BivariateColormap))
         if (C.ndim == 3 and isBivari):
             C = norm(C)
             nr, nc = C.shape
diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index eb1d7f88a1d9..af4cde186481 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -1158,9 +1158,6 @@ def _ticker(self, norm):
                                       linthresh=norm.linthresh,
                                       base=10)
                 else:
-                    if mpl.rcParams['_internal.classic_mode']:
-                        locator = ticker.MaxNLocator()
-                    else:
                         # locator = ticker.AutoLocator()
                         locator = ticker.MaxNLocator(nbins=5)
             else:
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index ff74839bc1af..15880eb1acbb 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -868,7 +868,8 @@ def _init(self):
         red_mesh, green_mesh = np.meshgrid(red, green)
         blue_mesh = np.zeros_like(red_mesh)
         alpha_mesh = np.ones_like(red_mesh)
-        bivariate_cmap = np.dstack((red_mesh, green_mesh, blue_mesh, alpha_mesh))
+        bivariate_cmap = np.dstack((red_mesh, green_mesh, blue_mesh,
+                                    alpha_mesh))
         self._lut = np.vstack(bivariate_cmap)
         self._isinit = True
         self.N = self.N * self.N

From ca2b111084e35439c42b8d2c4e2934378085b513 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Wed, 2 Aug 2017 14:41:53 +0530
Subject: [PATCH 17/35] Subclass normalizers from Abstract Base Class

---
 lib/matplotlib/axes/_axes.py        | 10 ++++------
 lib/matplotlib/colors.py            | 13 ++++++++++---
 lib/matplotlib/tests/test_colors.py | 12 ++++++++++++
 3 files changed, 26 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index c2ccd0fb748c..21e3e93c6252 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5146,8 +5146,7 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
         if not self._hold:
             self.cla()
 
-        isNorm = isinstance(norm, (mcolors.Normalize, mcolors.BivariateNorm))
-        if norm is not None and not isNorm:
+        if norm is not None and not isinstance(norm, mcolors.Norms):
             msg = "'norm' must be an instance of 'mcolors.Normalize' " \
                   "or 'mcolors.BivariateNorm'"
             raise ValueError(msg)
@@ -5483,8 +5482,7 @@ def pcolor(self, *args, **kwargs):
         collection.set_alpha(alpha)
         collection.set_array(C)
 
-        isNorm = isinstance(norm, (mcolors.Normalize, mcolors.BivariateNorm))
-        if norm is not None and not isNorm:
+        if norm is not None and not isinstance(norm, mcolors.Norms):
             msg = "'norm' must be an instance of 'mcolors.Normalize' " \
                   "or 'mcolors.BivariateNorm'"
             raise ValueError(msg)
@@ -5764,8 +5762,8 @@ def pcolorfast(self, *args, **kwargs):
         cmap = kwargs.pop('cmap', None)
         vmin = kwargs.pop('vmin', None)
         vmax = kwargs.pop('vmax', None)
-        isNorm = isinstance(norm, (mcolors.Normalize, mcolors.BivariateNorm))
-        if norm is not None and not isNorm:
+
+        if norm is not None and not isinstance(norm, mcolors.Norms):
             msg = "'norm' must be an instance of 'mcolors.Normalize' " \
                   "or 'mcolors.BivariateNorm'"
             raise ValueError(msg)
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 15880eb1acbb..3d6095222b8a 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -68,7 +68,7 @@
 import numpy as np
 import matplotlib.cbook as cbook
 from ._color_data import BASE_COLORS, TABLEAU_COLORS, CSS4_COLORS, XKCD_COLORS
-
+from abc import ABCMeta
 
 class _ColorMapping(dict):
     def __init__(self, mapping):
@@ -885,7 +885,14 @@ def reversed(self, name=None):
         raise NotImplementedError()
 
 
-class Normalize(object):
+class Norms:
+    """
+    Abstract Base Class to group `Normalize` and `BivariateNorm`
+    """
+    __metaclass__ = ABCMeta
+    pass
+
+class Normalize(Norms):
     """
     A class which, when called, can normalize data into
     the ``[0.0, 1.0]`` interval.
@@ -1377,7 +1384,7 @@ def inverse(self, value):
         return value
 
 
-class BivariateNorm:
+class BivariateNorm(Norms):
     """
     Normalize a list of two values corresponding to two 1D normalizers
     """
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index 721813e62f8f..fbcad2440141 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -707,3 +707,15 @@ def __add__(self, other):
                  mcolors.SymLogNorm(3, vmax=5, linscale=1),
                  mcolors.PowerNorm(1)]:
         assert_array_equal(norm(data.view(MyArray)), norm(data))
+
+
+@pytest.mark.parametrize('norm', [
+        mcolors.Normalize(), mcolors.LogNorm(), mcolors.BivariateNorm()
+    ]
+)
+def test_abstract_base_class_norms(norm):
+    """
+    Test that all types of normalizers subclasses Abstract Base class
+    `colors.Norms`
+    """
+    assert isinstance(norm, mcolors.Norms)
\ No newline at end of file

From 75b4eba1a50a25c3c9c31473659000511b672975 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Wed, 2 Aug 2017 14:59:57 +0530
Subject: [PATCH 18/35] move _ticker function inside update_ticks

---
 lib/matplotlib/colorbar.py | 142 ++++++++++++++++++-------------------
 1 file changed, 71 insertions(+), 71 deletions(-)

diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index af4cde186481..4884eec2e11c 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -944,7 +944,7 @@ def __init__(self, ax, cmap=None,
         if cbook.iterable(xticks):
             self.xlocator = ticker.FixedLocator(xticks, nbins=len(xticks))
         else:
-            self.xlocator = xticks    # Handle default in _ticker()
+            self.xlocator = xticks
 
         if cbook.iterable(yticks):
             self.ylocator = ticker.FixedLocator(yticks, nbins=len(yticks))
@@ -1015,9 +1015,77 @@ def update_ticks(self):
         Force the update of the ticks and ticklabels. This must be
         called whenever the tick locator and/or tick formatter changes.
         """
+        def _make_ticker(norm):
+            """
+            Return the sequence of ticks (colorbar data locations),
+            ticklabels (strings), and the corresponding offset string.
+            """
+            if norm is self.norm.norm1:
+                _values = self._xvalues
+                _boundaries = self._xboundaries
+                boundaries = self.xboundaries
+                locator = self.xlocator
+                formatter = self.xformatter
+            else:
+                _values = self._yvalues
+                _boundaries = self._yboundaries
+                boundaries = self.yboundaries
+                locator = self.ylocator
+                formatter = self.yformatter
+
+            if locator is None:
+                if boundaries is None:
+                    if isinstance(norm, colors.NoNorm):
+                        nv = len(_values)
+                        base = 1 + int(nv / 10)
+                        locator = ticker.IndexLocator(base=base, offset=0)
+                    elif isinstance(norm, colors.BoundaryNorm):
+                        b = norm.boundaries
+                        locator = ticker.FixedLocator(b, nbins=10)
+                    elif isinstance(norm, colors.LogNorm):
+                        locator = ticker.LogLocator(subs='all')
+                    elif isinstance(norm, colors.SymLogNorm):
+                        # The subs setting here should be replaced
+                        # by logic in the locator.
+                        locator = ticker.SymmetricalLogLocator(
+                                          subs=np.arange(1, 10),
+                                          linthresh=norm.linthresh,
+                                          base=10)
+                    else:
+                            # locator = ticker.AutoLocator()
+                            locator = ticker.MaxNLocator(nbins=5)
+                else:
+                    b = _boundaries[self._inside]
+                    locator = ticker.FixedLocator(b, nbins=10)
+            if isinstance(norm, colors.NoNorm) and boundaries is None:
+                intv = _values[0], _values[-1]
+            else:
+                b = _boundaries[self._inside]
+                intv = b[0], b[-1]
+            locator.create_dummy_axis(minpos=intv[0])
+            formatter.create_dummy_axis(minpos=intv[0])
+            locator.set_view_interval(*intv)
+            locator.set_data_interval(*intv)
+            formatter.set_view_interval(*intv)
+            formatter.set_data_interval(*intv)
+
+            b = np.array(locator())
+            if isinstance(locator, ticker.LogLocator):
+                eps = 1e-10
+                b = b[(b <= intv[1] * (1 + eps)) & (b >= intv[0] * (1 - eps))]
+            else:
+                eps = (intv[1] - intv[0]) * 1e-10
+                b = b[(b <= intv[1] + eps) & (b >= intv[0] - eps)]
+            # self._tick_data_values = b
+            ticks = self._locate(b, norm)
+            formatter.set_locs(b)
+            ticklabels = [formatter(t, i) for i, t in enumerate(b)]
+            offset_string = formatter.get_offset()
+            return ticks, ticklabels, offset_string
+
         ax = self.ax
-        xticks, xticklabels, xoffset_string = self._ticker(self.norm.norm1)
-        yticks, yticklabels, yoffset_string = self._ticker(self.norm.norm2)
+        xticks, xticklabels, xoffset_string = _make_ticker(self.norm.norm1)
+        yticks, yticklabels, yoffset_string = _make_ticker(self.norm.norm2)
 
         ax.xaxis.set_ticks(xticks)
         ax.set_xticklabels(xticklabels)
@@ -1121,74 +1189,6 @@ def _add_solids(self, X, Y, C):
              or len(self._x) >= self.n_rasterize):
             self.solids.set_rasterized(True)
 
-    def _ticker(self, norm):
-        """
-        Return the sequence of ticks (colorbar data locations),
-        ticklabels (strings), and the corresponding offset string.
-        """
-        if norm is self.norm.norm1:
-            _values = self._xvalues
-            _boundaries = self._xboundaries
-            boundaries = self.xboundaries
-            locator = self.xlocator
-            formatter = self.xformatter
-        else:
-            _values = self._yvalues
-            _boundaries = self._yboundaries
-            boundaries = self.yboundaries
-            locator = self.ylocator
-            formatter = self.yformatter
-
-        if locator is None:
-            if boundaries is None:
-                if isinstance(norm, colors.NoNorm):
-                    nv = len(_values)
-                    base = 1 + int(nv / 10)
-                    locator = ticker.IndexLocator(base=base, offset=0)
-                elif isinstance(norm, colors.BoundaryNorm):
-                    b = norm.boundaries
-                    locator = ticker.FixedLocator(b, nbins=10)
-                elif isinstance(norm, colors.LogNorm):
-                    locator = ticker.LogLocator(subs='all')
-                elif isinstance(norm, colors.SymLogNorm):
-                    # The subs setting here should be replaced
-                    # by logic in the locator.
-                    locator = ticker.SymmetricalLogLocator(
-                                      subs=np.arange(1, 10),
-                                      linthresh=norm.linthresh,
-                                      base=10)
-                else:
-                        # locator = ticker.AutoLocator()
-                        locator = ticker.MaxNLocator(nbins=5)
-            else:
-                b = _boundaries[self._inside]
-                locator = ticker.FixedLocator(b, nbins=10)
-        if isinstance(norm, colors.NoNorm) and boundaries is None:
-            intv = _values[0], _values[-1]
-        else:
-            b = _boundaries[self._inside]
-            intv = b[0], b[-1]
-        locator.create_dummy_axis(minpos=intv[0])
-        formatter.create_dummy_axis(minpos=intv[0])
-        locator.set_view_interval(*intv)
-        locator.set_data_interval(*intv)
-        formatter.set_view_interval(*intv)
-        formatter.set_data_interval(*intv)
-
-        b = np.array(locator())
-        if isinstance(locator, ticker.LogLocator):
-            eps = 1e-10
-            b = b[(b <= intv[1] * (1 + eps)) & (b >= intv[0] * (1 - eps))]
-        else:
-            eps = (intv[1] - intv[0]) * 1e-10
-            b = b[(b <= intv[1] + eps) & (b >= intv[0] - eps)]
-        # self._tick_data_values = b
-        ticks = self._locate(b, norm)
-        formatter.set_locs(b)
-        ticklabels = [formatter(t, i) for i, t in enumerate(b)]
-        offset_string = formatter.get_offset()
-        return ticks, ticklabels, offset_string
-
     def _process_values(self, b=None, norm=None):
         if norm is self.norm.norm1:
             boundaries = self.xboundaries

From bf65847530c5ef6c93dac5dbb336f947d5815a07 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Wed, 2 Aug 2017 14:59:57 +0530
Subject: [PATCH 19/35] move _ticker function inside update_ticks

---
 lib/matplotlib/colors.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 3d6095222b8a..11e67cc6a340 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -70,6 +70,7 @@
 from ._color_data import BASE_COLORS, TABLEAU_COLORS, CSS4_COLORS, XKCD_COLORS
 from abc import ABCMeta
 
+
 class _ColorMapping(dict):
     def __init__(self, mapping):
         super(_ColorMapping, self).__init__(mapping)
@@ -892,6 +893,7 @@ class Norms:
     __metaclass__ = ABCMeta
     pass
 
+
 class Normalize(Norms):
     """
     A class which, when called, can normalize data into

From f9dc4b1fd48f5f15ddeaa45d2e3f40076f47a489 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Sat, 5 Aug 2017 15:14:25 +0530
Subject: [PATCH 20/35] remove cmap in imshow and pcolorfast

---
 lib/matplotlib/axes/_axes.py | 4 +---
 lib/matplotlib/colors.py     | 6 +++---
 lib/matplotlib/image.py      | 3 ++-
 3 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 21e3e93c6252..1939100df0be 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5140,8 +5140,7 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
 
         temp = np.asarray(X)
         if temp.ndim == 3 and isinstance(norm, mcolors.BivariateNorm):
-                    temp = norm(temp)
-                    X = cmap(temp, alpha=self.get_alpha(), bytes=True)
+                    X = norm(temp)
 
         if not self._hold:
             self.cla()
@@ -5775,7 +5774,6 @@ def pcolorfast(self, *args, **kwargs):
         if (C.ndim == 3 and isBivari):
             C = norm(C)
             nr, nc = C.shape
-            C = cmap(C, alpha=alpha, bytes=True)
         else:
             nr, nc = C.shape
         if len(args) == 1:
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 11e67cc6a340..dc409440f249 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -862,10 +862,11 @@ def reversed(self, name=None):
 class BivariateColormap(Colormap):
     def __init__(self, name='bivariate', N=256):
         Colormap.__init__(self, name, N)
+        self.N = self.N * self.N
 
     def _init(self):
-        red = np.linspace(0, 1, self.N)
-        green = np.linspace(0, 1, self.N)
+        red = np.linspace(0, 1, np.sqrt(self.N))
+        green = np.linspace(0, 1, np.sqrt(self.N))
         red_mesh, green_mesh = np.meshgrid(red, green)
         blue_mesh = np.zeros_like(red_mesh)
         alpha_mesh = np.ones_like(red_mesh)
@@ -873,7 +874,6 @@ def _init(self):
                                     alpha_mesh))
         self._lut = np.vstack(bivariate_cmap)
         self._isinit = True
-        self.N = self.N * self.N
         self._set_extremes()
 
     def _resample(self, lutsize):
diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index d34f98b4e45a..20129814a34b 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -363,7 +363,8 @@ def _make_image(self, A, in_bbox, out_bbox, clip_bbox, magnification=1.0,
                 raise ValueError("Invalid dimensions, got {}".format(A.shape))
 
             if A.ndim == 2:
-                A = self.norm(A)
+                if not isinstance(self.norm, mcolors.BivariateNorm):
+                    A = self.norm(A)
                 if A.dtype.kind == 'f':
                     # If the image is greyscale, convert to RGBA and
                     # use the extra channels for resizing the over,

From 8a985f0400f39fe81834a1187f27e3052f2183f2 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Mon, 7 Aug 2017 18:14:47 +0530
Subject: [PATCH 21/35] Defer call to norm and cmap in imshow

---
 lib/matplotlib/axes/_axes.py     |  5 -----
 lib/matplotlib/axes/_subplots.py |  1 -
 lib/matplotlib/image.py          | 34 +++++++++++++++++++++-----------
 3 files changed, 23 insertions(+), 17 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 1939100df0be..8ad80f73ba59 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5137,11 +5137,6 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
         of pixel (0, 0).
 
         """
-
-        temp = np.asarray(X)
-        if temp.ndim == 3 and isinstance(norm, mcolors.BivariateNorm):
-                    X = norm(temp)
-
         if not self._hold:
             self.cla()
 
diff --git a/lib/matplotlib/axes/_subplots.py b/lib/matplotlib/axes/_subplots.py
index 90d55d21cc4c..3d806106d4c0 100644
--- a/lib/matplotlib/axes/_subplots.py
+++ b/lib/matplotlib/axes/_subplots.py
@@ -177,7 +177,6 @@ def subplot_class_factory(axes_class=None):
                          (SubplotBase, axes_class),
                          {'_axes_class': axes_class})
         _subplot_classes[axes_class] = new_class
-
     return new_class
 
 # This is provided for backward compatibility
diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index 20129814a34b..96ae5226e6f0 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -253,7 +253,11 @@ def get_size(self):
         if self._A is None:
             raise RuntimeError('You must first set the image array')
 
-        return self._A.shape[:2]
+        if isinstance(self.norm, mcolors.BivariateNorm):
+            imshape = self._A.shape[1:]
+        else:
+            imshape = self._A.shape[:2]
+        return imshape
 
     def set_alpha(self, alpha):
         """
@@ -300,6 +304,12 @@ def _make_image(self, A, in_bbox, out_bbox, clip_bbox, magnification=1.0,
         `trans` is the affine transformation from the image to pixel
         space.
         """
+        if isinstance(self.norm, mcolors.BivariateNorm):
+            imwidth = A.shape[1]
+            imheight = A.shape[2]
+        else:
+            imwidth = A.shape[0]
+            imheight = A.shape[1]
         if A is None:
             raise RuntimeError('You must first set the image '
                                'array or the image attribute')
@@ -323,15 +333,15 @@ def _make_image(self, A, in_bbox, out_bbox, clip_bbox, magnification=1.0,
             # Flip the input image using a transform.  This avoids the
             # problem with flipping the array, which results in a copy
             # when it is converted to contiguous in the C wrapper
-            t0 = Affine2D().translate(0, -A.shape[0]).scale(1, -1)
+            t0 = Affine2D().translate(0, -imwidth).scale(1, -1)
         else:
             t0 = IdentityTransform()
 
         t0 += (
             Affine2D()
             .scale(
-                in_bbox.width / A.shape[1],
-                in_bbox.height / A.shape[0])
+                in_bbox.width / imheight,
+                in_bbox.height / imwidth)
             .translate(in_bbox.x0, in_bbox.y0)
             + self.get_transform())
 
@@ -362,9 +372,9 @@ def _make_image(self, A, in_bbox, out_bbox, clip_bbox, magnification=1.0,
             if A.ndim not in (2, 3):
                 raise ValueError("Invalid dimensions, got {}".format(A.shape))
 
-            if A.ndim == 2:
-                if not isinstance(self.norm, mcolors.BivariateNorm):
-                    A = self.norm(A)
+            if A.ndim == 2 or (A.ndim == 3 and
+                               isinstance(self.norm, mcolors.BivariateNorm)):
+                A = self.norm(A)
                 if A.dtype.kind == 'f':
                     # If the image is greyscale, convert to RGBA and
                     # use the extra channels for resizing the over,
@@ -372,7 +382,7 @@ def _make_image(self, A, in_bbox, out_bbox, clip_bbox, magnification=1.0,
                     # Agg's resampler is very aggressive about
                     # clipping to [0, 1] and we use out-of-bounds
                     # values to carry the over/under/bad information
-                    rgba = np.empty((A.shape[0], A.shape[1], 4), dtype=A.dtype)
+                    rgba = np.empty((imwidth, imheight, 4), dtype=A.dtype)
                     rgba[..., 0] = A  # normalized data
                     # this is to work around spurious warnings coming
                     # out of masked arrays.
@@ -411,9 +421,10 @@ def _make_image(self, A, in_bbox, out_bbox, clip_bbox, magnification=1.0,
 
             if not created_rgba_mask:
                 # Always convert to RGBA, even if only RGB input
+                isBivari = (A.ndim == 2 and A.shape[0] == 2)
                 if A.shape[2] == 3:
                     A = _rgb_to_rgba(A)
-                elif A.shape[2] != 4:
+                elif A.shape[2] != 4 and not isBivari:
                     raise ValueError("Invalid dimensions, got %s" % (A.shape,))
 
                 output = np.zeros((out_height, out_width, 4), dtype=A.dtype)
@@ -596,8 +607,9 @@ def set_data(self, A):
                 not np.can_cast(self._A.dtype, float, "same_kind")):
             raise TypeError("Image data cannot be converted to float")
 
-        if not (self._A.ndim == 2
-                or self._A.ndim == 3 and self._A.shape[-1] in [3, 4]):
+        isRGB = (self._A.ndim == 3 and self._A.shape[-1] in [3, 4])
+        isBivari = (self._A.ndim == 3 and self._A.shape[0] == 2)
+        if not (self._A.ndim == 2 or isRGB or isBivari):
             raise TypeError("Invalid dimensions for image data")
 
         self._imcache = None

From 8f6928d3cb32271677ab3e4f5ebf848c2031db9e Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Tue, 15 Aug 2017 20:33:49 +0530
Subject: [PATCH 22/35] Fix bivariate handling with pcolormesh

---
 lib/matplotlib/axes/_axes.py  | 24 +++++++++++++-----------
 lib/matplotlib/cm.py          |  2 +-
 lib/matplotlib/collections.py |  3 ++-
 3 files changed, 16 insertions(+), 13 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 8ad80f73ba59..0929da99bc21 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5200,8 +5200,9 @@ def _pcolorargs(funcname, *args, **kw):
                     cmap = mcolors.BivariateColormap()
                 if norm is None:
                     norm = mcolors.BivariateNorm()
-                C = norm(C)
-            numRows, numCols = C.shape
+                numRows, numCols = C.shape[1:]
+            else:
+                numRows, numCols = C.shape
             if allmatch:
                 X, Y = np.meshgrid(np.arange(numCols), np.arange(numRows))
             else:
@@ -5219,8 +5220,9 @@ def _pcolorargs(funcname, *args, **kw):
                     cmap = mcolors.BivariateColormap()
                 if norm is None:
                     norm = mcolors.BivariateNorm()
-                C = norm(C)
-            numRows, numCols = C.shape
+                numRows, numCols = C.shape[1:]
+            else:
+                numRows, numCols = C.shape
         else:
             raise TypeError(
                 'Illegal arguments to %s; see help(%s)' % (funcname, funcname))
@@ -5614,17 +5616,17 @@ def pcolormesh(self, *args, **kwargs):
         X, Y, C = self._pcolorargs('pcolormesh', *args, **kw)
         Ny, Nx = X.shape
 
-        if (isinstance(norm, mcolors.BivariateNorm) or
-                isinstance(cmap, mcolors.BivariateColormap)):
-            norm = mcolors.NoNorm()
-
         # unit conversion allows e.g. datetime objects as axis values
         self._process_unit_info(xdata=X, ydata=Y, kwargs=kwargs)
         X = self.convert_xunits(X)
         Y = self.convert_yunits(Y)
 
-        # convert to one dimensional arrays
-        C = C.ravel()
+        # convert to one dimensional arrays if univariate
+        if isinstance(norm, mcolors.BivariateNorm):
+            C = np.asarray([C[0].ravel(), C[1].ravel()])
+        else:
+            C = C.ravel()
+
         coords = np.column_stack((X.flat, Y.flat)).astype(float, copy=False)
 
         collection = mcoll.QuadMesh(Nx - 1, Ny - 1, coords,
@@ -5632,7 +5634,7 @@ def pcolormesh(self, *args, **kwargs):
                                     **kwargs)
         collection.set_alpha(alpha)
         collection.set_array(C)
-        if norm is not None and not isinstance(norm, mcolors.Normalize):
+        if norm is not None and not isinstance(norm, mcolors.Norms):
             msg = "'norm' must be an instance of 'mcolors.Normalize'"
             raise ValueError(msg)
         collection.set_cmap(cmap)
diff --git a/lib/matplotlib/cm.py b/lib/matplotlib/cm.py
index bdf3e1575653..0ff3b56d9a45 100644
--- a/lib/matplotlib/cm.py
+++ b/lib/matplotlib/cm.py
@@ -238,7 +238,7 @@ def to_rgba(self, x, alpha=None, bytes=False, norm=True):
         """
         # First check for special case, image input:
         try:
-            if x.ndim == 3:
+            if x.ndim == 3 and (x.shape[-1] == 3 or x.shape[-1] == 4):
                 if x.shape[2] == 3:
                     if alpha is None:
                         alpha = 1
diff --git a/lib/matplotlib/collections.py b/lib/matplotlib/collections.py
index 3acbaeceefbe..8c0984f162d8 100644
--- a/lib/matplotlib/collections.py
+++ b/lib/matplotlib/collections.py
@@ -731,7 +731,8 @@ def update_scalarmappable(self):
         """
         if self._A is None:
             return
-        if self._A.ndim > 1:
+        if (self._A.ndim > 1 and
+                not isinstance(self.norm, mcolors.BivariateNorm)):
             raise ValueError('Collections can only map rank 1 arrays')
         if not self.check_update("array"):
             return

From d54cb4431df24d5645c64273412e94982d68d0a7 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Wed, 16 Aug 2017 11:56:00 +0530
Subject: [PATCH 23/35] Make pcolor work with bivariate

---
 lib/matplotlib/axes/_axes.py | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 0929da99bc21..0202dd1af2eb 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5408,10 +5408,6 @@ def pcolor(self, *args, **kwargs):
         X, Y, C = self._pcolorargs('pcolor', *args, **kw)
         Ny, Nx = X.shape
 
-        if (isinstance(norm, mcolors.BivariateNorm) or
-                isinstance(cmap, mcolors.BivariateColormap)):
-            norm = mcolors.NoNorm()
-
         # unit conversion allows e.g. datetime objects as axis values
         self._process_unit_info(xdata=X, ydata=Y, kwargs=kwargs)
         X = self.convert_xunits(X)
@@ -5426,7 +5422,10 @@ def pcolor(self, *args, **kwargs):
         xymask = (mask[0:-1, 0:-1] + mask[1:, 1:] +
                   mask[0:-1, 1:] + mask[1:, 0:-1])
         # don't plot if C or any of the surrounding vertices are masked.
-        mask = ma.getmaskarray(C) + xymask
+        if isinstance(norm, mcolors.BivariateNorm):
+            mask = ma.getmaskarray(C[0]) + ma.getmaskarray(C[1]) + xymask
+        else:
+            mask = ma.getmaskarray(C) + xymask
 
         newaxis = np.newaxis
         compress = np.compress
@@ -5450,7 +5449,14 @@ def pcolor(self, *args, **kwargs):
                             axis=1)
         verts = xy.reshape((npoly, 5, 2))
 
-        C = compress(ravelmask, ma.filled(C[0:Ny - 1, 0:Nx - 1]).ravel())
+        if isinstance(norm, mcolors.BivariateNorm):
+            C0 = C[0]
+            C1 = C[1]
+            C0 = compress(ravelmask, ma.filled(C0[0:Ny - 1, 0:Nx - 1]).ravel())
+            C1 = compress(ravelmask, ma.filled(C1[0:Ny - 1, 0:Nx - 1]).ravel())
+            C = np.array([C0, C1])
+        else:
+            C = compress(ravelmask, ma.filled(C[0:Ny - 1, 0:Nx - 1]).ravel())
 
         linewidths = (0.25,)
         if 'linewidth' in kwargs:
@@ -5769,8 +5775,7 @@ def pcolorfast(self, *args, **kwargs):
         isBivari = (isinstance(norm, mcolors.BivariateNorm)
                     or isinstance(cmap, mcolors.BivariateColormap))
         if (C.ndim == 3 and isBivari):
-            C = norm(C)
-            nr, nc = C.shape
+            nr, nc = C.shape[1:]
         else:
             nr, nc = C.shape
         if len(args) == 1:

From 4d0355293f82ac49937fe62698e78b2c84f047d2 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Sun, 20 Aug 2017 23:42:39 +0530
Subject: [PATCH 24/35] Do 2D->1D mapping in call method of colormap

---
 lib/matplotlib/colors.py | 12 ++++++------
 lib/matplotlib/image.py  |  5 +++--
 2 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index dc409440f249..323966156494 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -473,6 +473,11 @@ def __call__(self, X, alpha=None, bytes=False):
             xa = np.array([X])
         else:
             vtype = 'array'
+            if isinstance(self, BivariateColormap):
+                X[0] = X[0] * 256
+                X[1] = X[1] * 256
+                X = X.astype(int)
+                X = X[0] + X[1] * 256
             xma = np.ma.array(X, copy=True)  # Copy here to avoid side effects.
             mask_bad = xma.mask              # Mask will be used below.
             xa = xma.filled()                # Fill to avoid infs, etc.
@@ -1427,14 +1432,9 @@ def __call__(self, values, clip=None):
         if clip is None:
             clip = [self.norm1.clip, self.norm2.clip]
 
-        temp = np.asarray([self.norm1(values[0], clip=clip[0]),
+        return np.asarray([self.norm1(values[0], clip=clip[0]),
                           self.norm2(values[1], clip=clip[1])])
 
-        temp[0] = temp[0] * (256)
-        temp[1] = temp[1] * (256)
-        temp = temp.astype(int)
-        return temp[0] + temp[1] * 256
-
     def autoscale(self, A):
         """
         Set *vmin*, *vmax* to min, max of *A*.
diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index 96ae5226e6f0..db57edda9407 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -375,7 +375,8 @@ def _make_image(self, A, in_bbox, out_bbox, clip_bbox, magnification=1.0,
             if A.ndim == 2 or (A.ndim == 3 and
                                isinstance(self.norm, mcolors.BivariateNorm)):
                 A = self.norm(A)
-                if A.dtype.kind == 'f':
+                if (A.dtype.kind == 'f' and
+                        not isinstance(self.norm, mcolors.BivariateNorm)):
                     # If the image is greyscale, convert to RGBA and
                     # use the extra channels for resizing the over,
                     # under, and bad pixels.  This is needed because
@@ -421,7 +422,7 @@ def _make_image(self, A, in_bbox, out_bbox, clip_bbox, magnification=1.0,
 
             if not created_rgba_mask:
                 # Always convert to RGBA, even if only RGB input
-                isBivari = (A.ndim == 2 and A.shape[0] == 2)
+                isBivari = (A.ndim == 3 and A.shape[0] == 2)
                 if A.shape[2] == 3:
                     A = _rgb_to_rgba(A)
                 elif A.shape[2] != 4 and not isBivari:

From 2573610cd817959ff82da3eb0b6c02eaf0c4d3ed Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Mon, 21 Aug 2017 02:44:48 +0530
Subject: [PATCH 25/35] Use list comprehensions to ravel

---
 lib/matplotlib/axes/_axes.py | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 0202dd1af2eb..71e2a11ed2b0 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5450,11 +5450,12 @@ def pcolor(self, *args, **kwargs):
         verts = xy.reshape((npoly, 5, 2))
 
         if isinstance(norm, mcolors.BivariateNorm):
-            C0 = C[0]
-            C1 = C[1]
-            C0 = compress(ravelmask, ma.filled(C0[0:Ny - 1, 0:Nx - 1]).ravel())
-            C1 = compress(ravelmask, ma.filled(C1[0:Ny - 1, 0:Nx - 1]).ravel())
-            C = np.array([C0, C1])
+            C = np.array([
+                            compress(
+                                ravelmask,
+                                ma.filled(c[0:Ny - 1, 0:Nx - 1]).ravel()
+                            ) for c in C
+                        ])
         else:
             C = compress(ravelmask, ma.filled(C[0:Ny - 1, 0:Nx - 1]).ravel())
 
@@ -5629,7 +5630,7 @@ def pcolormesh(self, *args, **kwargs):
 
         # convert to one dimensional arrays if univariate
         if isinstance(norm, mcolors.BivariateNorm):
-            C = np.asarray([C[0].ravel(), C[1].ravel()])
+            C = np.asarray([c.ravel() for c in C])
         else:
             C = C.ravel()
 

From 9228480b85b910e1032c38f23f1844045a814f6b Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Tue, 22 Aug 2017 03:19:57 +0530
Subject: [PATCH 26/35] Reflect on reviews

---
 lib/matplotlib/axes/_axes.py        | 39 ++++++++++++++++-------------
 lib/matplotlib/colorbar.py          |  4 +--
 lib/matplotlib/colors.py            |  4 +--
 lib/matplotlib/tests/test_colors.py |  2 +-
 4 files changed, 26 insertions(+), 23 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 71e2a11ed2b0..4ce84d18776a 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -4044,7 +4044,8 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
 
         if colors is None:
             if norm is not None and not isinstance(norm, mcolors.Normalize):
-                msg = "'norm' must be an instance of 'mcolors.Normalize'"
+                msg = ("'norm' must be an instance of 'mcolors.Normalize' or "
+                       "'mcolors.BivariateNorm'")
                 raise ValueError(msg)
             collection.set_array(np.asarray(c))
             collection.set_cmap(cmap)
@@ -4403,7 +4404,8 @@ def hexbin(self, x, y, C=None, gridsize=100, bins=None,
             accum = bins.searchsorted(accum)
 
         if norm is not None and not isinstance(norm, mcolors.Normalize):
-            msg = "'norm' must be an instance of 'mcolors.Normalize'"
+            msg = ("'norm' must be an instance of 'mcolors.Normalize' or "
+                   "'mcolors.BivariateNorm'")
             raise ValueError(msg)
         collection.set_array(accum)
         collection.set_cmap(cmap)
@@ -5141,8 +5143,8 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
             self.cla()
 
         if norm is not None and not isinstance(norm, mcolors.Norms):
-            msg = "'norm' must be an instance of 'mcolors.Normalize' " \
-                  "or 'mcolors.BivariateNorm'"
+            msg = ("'norm' must be an instance of 'mcolors.Normalize' or "
+                   "'mcolors.BivariateNorm'")
             raise ValueError(msg)
 
         if aspect is None:
@@ -5193,9 +5195,9 @@ def _pcolorargs(funcname, *args, **kw):
 
         if len(args) == 1:
             C = np.asanyarray(args[0])
-            isBivari = (isinstance(norm, mcolors.BivariateNorm)
-                        or isinstance(cmap, mcolors.BivariateColormap))
-            if (C.ndim == 3 and isBivari):
+            is_bivari = (isinstance(norm, mcolors.BivariateNorm) or
+                         isinstance(cmap, mcolors.BivariateColormap))
+            if (C.ndim == 3 and is_bivari):
                 if cmap is None:
                     cmap = mcolors.BivariateColormap()
                 if norm is None:
@@ -5213,9 +5215,9 @@ def _pcolorargs(funcname, *args, **kw):
 
         if len(args) == 3:
             X, Y, C = [np.asanyarray(a) for a in args]
-            isBivari = (isinstance(norm, mcolors.BivariateNorm)
-                        or isinstance(cmap, mcolors.BivariateColormap))
-            if (C.ndim == 3 and isBivari):
+            is_bivari = (isinstance(norm, mcolors.BivariateNorm) or
+                         isinstance(cmap, mcolors.BivariateColormap))
+            if (C.ndim == 3 and is_bivari):
                 if cmap is None:
                     cmap = mcolors.BivariateColormap()
                 if norm is None:
@@ -5486,8 +5488,8 @@ def pcolor(self, *args, **kwargs):
         collection.set_array(C)
 
         if norm is not None and not isinstance(norm, mcolors.Norms):
-            msg = "'norm' must be an instance of 'mcolors.Normalize' " \
-                  "or 'mcolors.BivariateNorm'"
+            msg = ("'norm' must be an instance of 'mcolors.Normalize' or "
+                   "'mcolors.BivariateNorm'")
             raise ValueError(msg)
 
         collection.set_cmap(cmap)
@@ -5642,7 +5644,8 @@ def pcolormesh(self, *args, **kwargs):
         collection.set_alpha(alpha)
         collection.set_array(C)
         if norm is not None and not isinstance(norm, mcolors.Norms):
-            msg = "'norm' must be an instance of 'mcolors.Normalize'"
+            msg = ("'norm' must be an instance of 'mcolors.Normalize' or "
+                   "'mcolors.BivariateNorm'")
             raise ValueError(msg)
         collection.set_cmap(cmap)
         collection.set_norm(norm)
@@ -5767,15 +5770,15 @@ def pcolorfast(self, *args, **kwargs):
         vmax = kwargs.pop('vmax', None)
 
         if norm is not None and not isinstance(norm, mcolors.Norms):
-            msg = "'norm' must be an instance of 'mcolors.Normalize' " \
-                  "or 'mcolors.BivariateNorm'"
+            msg = ("'norm' must be an instance of 'mcolors.Normalize' or "
+                   "'mcolors.BivariateNorm'")
             raise ValueError(msg)
 
         C = np.asarray(args[-1])
 
-        isBivari = (isinstance(norm, mcolors.BivariateNorm)
-                    or isinstance(cmap, mcolors.BivariateColormap))
-        if (C.ndim == 3 and isBivari):
+        is_bivari = (isinstance(norm, mcolors.BivariateNorm) or
+                     isinstance(cmap, mcolors.BivariateColormap))
+        if (C.ndim == 3 and is_bivari):
             nr, nc = C.shape[1:]
         else:
             nr, nc = C.shape
diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index 4884eec2e11c..7e4d1c9ff212 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -1152,8 +1152,8 @@ def _edges(self, X, Y):
         Return the separator line segments; helper for _add_solids.
         '''
         N = X.shape[0]
-        return [list(zip(X[i], Y[i])) for i in xrange(1, N - 1)]
-        + [list(zip(Y[i], X[i])) for i in xrange(1, N - 1)]
+        return ([list(zip(X[i], Y[i])) for i in xrange(1, N - 1)] +
+                [list(zip(Y[i], X[i])) for i in xrange(1, N - 1)])
 
     def _add_solids(self, X, Y, C):
         """
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 323966156494..6e058a89fcb6 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -888,14 +888,14 @@ def _resample(self, lutsize):
         return BivariateColormap(self.name, lutsize)
 
     def reversed(self, name=None):
-        raise NotImplementedError()
+        raise NotImplementedError
 
 
+@six.add_metaclass(ABCMeta)
 class Norms:
     """
     Abstract Base Class to group `Normalize` and `BivariateNorm`
     """
-    __metaclass__ = ABCMeta
     pass
 
 
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index fbcad2440141..d18ab41ecf19 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -718,4 +718,4 @@ def test_abstract_base_class_norms(norm):
     Test that all types of normalizers subclasses Abstract Base class
     `colors.Norms`
     """
-    assert isinstance(norm, mcolors.Norms)
\ No newline at end of file
+    assert isinstance(norm, mcolors.Norms)

From 5c8dc6581cfedc51ea7aa94f5d6c69497d0f89ca Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Fri, 25 Aug 2017 11:30:01 +0530
Subject: [PATCH 27/35] Update docstrings

---
 lib/matplotlib/axes/_axes.py | 33 ++++++++++++++++++++-------------
 1 file changed, 20 insertions(+), 13 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 4ce84d18776a..75b9b6af1f11 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5039,23 +5039,25 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
 
         Parameters
         ----------
-        X : array_like, shape (n, m) or (n, m, 3) or (n, m, 4)
+        X : array_like, shape (n, m) or (n, m, 3) or (n, m, 4) or (2, n, m)
             Display the image in `X` to current axes.  `X` may be an
             array or a PIL image. If `X` is an array, it
             can have the following shapes and types:
 
-            - MxN -- values to be mapped (float or int)
+            - MxN -- univariate values to be mapped (float or int)
             - MxNx3 -- RGB (float or uint8)
             - MxNx4 -- RGBA (float or uint8)
+            - 2xMxN -- bivariate values to be mapped (float or int)
 
             The value for each component of MxNx3 and MxNx4 float arrays
-            should be in the range 0.0 to 1.0. MxN arrays are mapped
+            should be in the range 0.0 to 1.0. MxN and 2xMxN arrays are mapped
             to colors based on the `norm` (mapping scalar to scalar)
             and the `cmap` (mapping the normed scalar to a color).
 
-        cmap : `~matplotlib.colors.Colormap`, optional, default: None
+        cmap : `~matplotlib.colors.Colormap`,
+            `~matplotlib.colors.BivariateColormap`optional, default: None
             If None, default to rc `image.cmap` value. `cmap` is ignored
-            if `X` is 3-D, directly specifying RGB(A) values.
+            if `X` is 3-D but not bivariate, directly specifying RGB(A) values.
 
         aspect : ['auto' | 'equal' | scalar], optional, default: None
             If 'auto', changes the image aspect ratio to match that of the
@@ -5079,7 +5081,8 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
             on the Agg, ps and pdf backends. Other backends will fall back to
             'nearest'.
 
-        norm : `~matplotlib.colors.Normalize`, optional, default: None
+        norm : `~matplotlib.colors.Normalize`, `matplotlib.colors.BivariateNorm`
+            optional, default: None
             A `~matplotlib.colors.Normalize` instance is used to scale
             a 2-D float `X` input to the (0, 1) range for input to the
             `cmap`. If `norm` is None, use the default func:`normalize`.
@@ -5259,7 +5262,7 @@ def _pcolorargs(funcname, *args, **kw):
     @docstring.dedent_interpd
     def pcolor(self, *args, **kwargs):
         """
-        Create a pseudocolor plot of a 2-D array.
+        Create a pseudocolor plot of a 2-D univariate or 3-D bivariate array.
 
         Call signatures::
 
@@ -5557,11 +5560,13 @@ def pcolormesh(self, *args, **kwargs):
         Keyword arguments:
 
           *cmap*: [ *None* | Colormap ]
-            A :class:`matplotlib.colors.Colormap` instance. If *None*, use
-            rc settings.
+            A :class:`matplotlib.colors.Colormap` or
+            :class:`matplotlib.colors.BivariateColormap`instance. If *None*,
+            use rc settings.
 
           *norm*: [ *None* | Normalize ]
-            A :class:`matplotlib.colors.Normalize` instance is used to
+            A :class:`matplotlib.colors.Normalize` or
+            :class:`matplotlib.colors.BivariateNorm` instance is used to
             scale luminance data to 0,1. If *None*, defaults to
             :func:`normalize`.
 
@@ -5679,7 +5684,7 @@ def pcolormesh(self, *args, **kwargs):
     @docstring.dedent_interpd
     def pcolorfast(self, *args, **kwargs):
         """
-        pseudocolor plot of a 2-D array
+        pseudocolor plot of a 2-D univariate or 3-D bivariate array
 
         Experimental; this is a pcolor-type method that
         provides the fastest possible rendering with the Agg
@@ -5738,11 +5743,13 @@ def pcolorfast(self, *args, **kwargs):
         Optional keyword arguments:
 
           *cmap*: [ *None* | Colormap ]
-            A :class:`matplotlib.colors.Colormap` instance from cm. If *None*,
+            A :class:`matplotlib.colors.Colormap` or
+            :class:`matplotlib.colors.BivariateColormap` instance from cm. If *None*,
             use rc settings.
 
           *norm*: [ *None* | Normalize ]
-            A :class:`matplotlib.colors.Normalize` instance is used to scale
+            A :class:`matplotlib.colors.Normalize` or
+            :class:`matplotlib.colors.BivariateNorm` instance is used to scale
             luminance data to 0,1. If *None*, defaults to normalize()
 
           *vmin*/*vmax*: [ *None* | scalar ]

From 21ea65fefd1442e59c508aaae9f4338c6306572f Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Fri, 25 Aug 2017 16:29:15 +0530
Subject: [PATCH 28/35] Add bivariate example

---
 .../bivariate_demo.py                         |  38 ++++++++++++++++++
 lib/matplotlib/axes/_axes.py                  |   8 ++--
 .../mpl-data/sample_data/air_temperature.npy  | Bin 0 -> 84176 bytes
 .../mpl-data/sample_data/surface_pressure.npy | Bin 0 -> 84176 bytes
 4 files changed, 42 insertions(+), 4 deletions(-)
 create mode 100644 examples/images_contours_and_fields/bivariate_demo.py
 create mode 100644 lib/matplotlib/mpl-data/sample_data/air_temperature.npy
 create mode 100644 lib/matplotlib/mpl-data/sample_data/surface_pressure.npy

diff --git a/examples/images_contours_and_fields/bivariate_demo.py b/examples/images_contours_and_fields/bivariate_demo.py
new file mode 100644
index 000000000000..d4e41d227b14
--- /dev/null
+++ b/examples/images_contours_and_fields/bivariate_demo.py
@@ -0,0 +1,38 @@
+"""
+===========
+Bivariate Demo
+===========
+
+Plotting bivariate data.
+
+imshow, pcolor, pcolormesh, pcolorfast allows you to plot bivariate data
+using a bivaraite colormap.
+
+In this example we use imshow to plot air temperature with surface pressure
+alongwith a color square.
+"""
+import matplotlib.colors as colors
+from matplotlib.cbook import get_sample_data
+import matplotlib.pyplot as plt
+import numpy as np
+
+
+###############################################################################
+# Bivariate plotting demo
+# -----------------------
+
+air_temp = np.load(get_sample_data('air_temperature.npy'))
+surf_pres = np.load(get_sample_data('surface_pressure.npy'))
+
+fig, ax = plt.subplots()
+
+bivariate = [air_temp, surf_pres]
+
+cax = ax.imshow(bivariate, norm=colors.BivariateNorm(),
+                cmap=colors.BivariateColormap())
+
+# if input data is bivariate then colorbar automatically draws colorsquare
+# instead of colorbar
+cbar = fig.colorbar(cax, xlabel='air_temp', ylabel='surf_pres')
+
+plt.show()
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 75b9b6af1f11..8270512bf1e0 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5081,8 +5081,8 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
             on the Agg, ps and pdf backends. Other backends will fall back to
             'nearest'.
 
-        norm : `~matplotlib.colors.Normalize`, `matplotlib.colors.BivariateNorm`
-            optional, default: None
+        norm : `~matplotlib.colors.Normalize`,
+            `matplotlib.colors.BivariateNorm` optional, default: None
             A `~matplotlib.colors.Normalize` instance is used to scale
             a 2-D float `X` input to the (0, 1) range for input to the
             `cmap`. If `norm` is None, use the default func:`normalize`.
@@ -5744,8 +5744,8 @@ def pcolorfast(self, *args, **kwargs):
 
           *cmap*: [ *None* | Colormap ]
             A :class:`matplotlib.colors.Colormap` or
-            :class:`matplotlib.colors.BivariateColormap` instance from cm. If *None*,
-            use rc settings.
+            :class:`matplotlib.colors.BivariateColormap` instance from cm.
+            If *None*, use rc settings.
 
           *norm*: [ *None* | Normalize ]
             A :class:`matplotlib.colors.Normalize` or
diff --git a/lib/matplotlib/mpl-data/sample_data/air_temperature.npy b/lib/matplotlib/mpl-data/sample_data/air_temperature.npy
new file mode 100644
index 0000000000000000000000000000000000000000..cfcbf84f9b6ad401a1ccc90ba28c549fe420bc8e
GIT binary patch
literal 84176
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
MuRnYb{)hMAKXyYM7XSbN

literal 0
HcmV?d00001

diff --git a/lib/matplotlib/mpl-data/sample_data/surface_pressure.npy b/lib/matplotlib/mpl-data/sample_data/surface_pressure.npy
new file mode 100644
index 0000000000000000000000000000000000000000..19c6cedd5b47e3a99cb0533c2f67d74dfd0de7b0
GIT binary patch
literal 84176
zcmeFa`5%N+`TswbGFfV@??JdNW$d>t6VZ@mB)W-=ee5G*LYcCSkg>#_b)>i>84)8(
zQ??<?*fN$FLKCSW%h-p+=l%71J@3aO|G@W`_x$pDoHOS>_qoq<oohSSIcu98wvKk1
zBeQwt$QAe5_prSWU2*+j#V_qwTyfQ4#r+OB^zcLXJa~^o4&7(p|1W>@Jr6o;-~Y`&
zthQ%;-~UY))?0hkV9j;bS!vba=s>@DGynTbzVvSC|M36%;s55r|E+`nKj=VpVfA}<
zL1FY6VS52#Wqx68KH*?qVdG;sb-L$rLqAviw8~Fi@6hilETa6`V*Y<|;pDTzP9Q9;
zAj}l}|0=@S8p3cLVO$hWO;1N9rHh*h%UcS=tz9k>wzd}r6=8lCVShJasVc1RC5-kF
z#`_8@`w54}nUVaS%QgJm#P#%CZ*g}$U-NtGZb#ScDs8L(n{IdD@5uSP_|Ad9yXJoA
zxL^9Ap3kf%j8_uYKQBy{7tY+@)1{TpEhVfhDJ(4^j66==ywX);(b)PJ7F>R6j9pLD
z^_D%}MZYid`%BCC{ccyVtkT8hgd-#EXP(5KFWJwj95{A<&q(>m-(Piob-yR{d-HBb
z*X^UdV}D29nDO_~54n%^3;jfY@Z8Y-K>cICkM_{+(TeVmm4yY5XUFRxT1)v&k9+kC
zN)Of(X20nFjYDI_I4<h{#N~^AKI{52uD{~<bys!0ZqLN?Y2f}Gy8kjB&#b?b{)rdW
z^X+wAkJ}M>9=E@&{N5%)=6k$_(yW8lSCx*o5>AZ+V`3~At1jR7I%*rC59CvhdMaLj
z)vxP4J+I5E*J<yY%CGJu9Pc8Wn2scSC>`!8Ebk@k8*_WRywhzX<vM;YYlJRQZ^rfK
zOi#*wZ+2JJJJ?y6qkXj3?a%vrppVV6%7<SOmNpcQJTI6B1=Hn<$9v>?ADYfb^Xj?D
zT*Cebvyb@Q)_cPE9bw^ZVaAwue(<jHYwx>UM)efu76w`2cs^m*`%N#WH2Y1(?I}6G
zzkvQ{KMUtky6tu*eoxu$4gaI}4~?S_mFBxzpVITO>xVu<w|b_#)iqTv@;d9UuXJ|<
zA?tMD^_KT@Gp`@^<IKO^FB4(#m~eWBFn@!v`fFkBV&U*YVf!Ls?owfJm2mI}Vg6p>
z>`7trlGFZv_I2oC<av<u_c2d8Ue|%Yll>|1x}SJ|Dw>{DP3H>Bt3OhD_%Zq$c;Dz7
z6Vn;!4*NpR^)*eWN~^2hk=r?Qet#9^*NuU(ZEU%Hv7c|d-O%0A+Il{3?7IHY^fIl-
z?P>V?dZzdAJ)y@LdRh1Pu@A9dvF--m2Y4^^zUuiDd)<zW$Qg`F-Qy7Wdxq|h(EBI-
z&wf4mAAhImch3A{u#oauZ>0OqAGut~&y`&d`(el5&3?iD+g(oe*1T^I-7ff-!21sS
zdD;6n^8)@dU6)>`f!BG*^Lb)AlbvavcZ^f7v(g-D2lNJhHti3OBkgQ?oI&^w_?y8Z
zs;_POl`}mozo_@uo)9+f5teQgj;<CCJHpy!!u*xOpeO8k{nnmSdTM$GU)}$*`*j!L
z_z+?C2g2eJLipI}=1Rl2G@ezx!%KwCy@ZqHg!vcV`H0TXdcyD=VfPqe{(HjK_l2Dw
z8GkA)TqEq=B`iNK9RF1~ct$vRSQy?ctXw3_9wqF4Q<z&@*k450`S9(J+Shzbn9Q91
zl>QG2!s&Lx`boms?ZRXZeP`#(!sPqH>~DnC$AwMLqrqp?fAH5u&yT71yX<``-}88O
z&QLmYyz`G0=1&lgP7}s$Vb^rLey!4-+l1jz*n37efR4LevpLnSF6+YkBKu=#IgbD9
zp09mlJfEH)d*7>jT{ldR;m6q@YV3pl{*38h)%2a`+ol^C_Z#wL)9slVtKRP$E{7aj
z_w!xTorc#N>#pT|+Rb++pV0TrOc&rsX0NFKSf8=?UD8AU-+oi&SkFz@1D$D`&P-oZ
zx#*w5`d@?<k5~C_r#+6{Ta<1Yr?)E2I8Sa@y7)(7?qe94FQ^Xmf9*kG-gIX6ccnA5
z%XDvSx>q*6Y=59~fxol<ywdTb!o=_Cn+}ydA7k?)b+>b3ex)_lb0yCs=r{63*Yl*{
z@okS)K6{}s^EF|8>UDXRaPlRm-_W{l-RSjwuCRW*@fhKtDV+UKSUXBs-A|bPk}!Dx
zt&ix&<T7DvQ(<ZJ=12L%1BLM?g@x`LALWk@7A9K=dm9P!J39YN<7>j)p?W@>Q~lu`
ze%}ddM{iSo-{@^&e7gF9@j?!&e%tf;Kw%OI**DwFn+x=O`A5QGQ&=;->71f8@2UBH
z^;2E$WMRv6DLGH+=@r7F=Uw9Y-tan0`8e<6Q`3XQ>$POQf8uecp62gVZ+wj~OZrZ~
zcO>loOIY^0WBxWgznOozzo{JbGT&Ev_*-FYy3D+*oUQ!8-#_}H(uHG$W7F%b`z`--
z<<ri_BTDCA7Sb-{iJrf^<@SevR=LFMKI$r6{I#FIN*Leh{0D^DzY5{s^RFuny<*+B
zykCvYH;ha_8eY%s`}JICc_90O(tXnb=o)ey{XTk1<wkDL(DaOU_S|0bJNK!4#^X0M
zU1FT7=9A#Za+U*0!?(@cKIjbdJn#9E_js0!GmkU$vGA<g0Ud`=D}7SyXY#84hpy&M
zQab#yFnCMrvi4gce9vrmrL)@$D?15``wAxq2ul@VZ&~5^X07|us-{EV6+M_;COXl7
zOmt(okg$Hh>mSjb+;gveg!SWvv#o^v4TaN+uym2Ixv-ua+#npCr22xU-cvbK@9kZ#
zc4V(o``V@(=n>1`Q$J-+6AtUbrsct+$Fb-2nwZaJez7h>^C{K0)UUnggp<34InV#h
znM#*Tuex53tk3X#{hu}89Ka`;ZnT|dJ~X|)2VT#$1O49Jh2d_(=KjL=QNmJNSiDZi
zdSZPIJg=vJ(*OONg~8=cpCe4^@R3UAzbh;pB8>MF20IC(ErgYIg|(H1)zyT>jfJg!
zgfsJ()!)0E*MHmldFXZ5aC^}Ql-=IsdOcV1x@j8w?#G7z?|I*^8KI}pt<eRlCq7wN
zK0=uJmN42^NdHIQSGswMu;OtY{6gvMCBkAN?3wP8uDhQ@k30NI#dN20m!2EDy)D->
z^ZTZr5AEYru6CBNdbO}`Itl%NPL{oYLEq@F!O!$u5W7C_tL<}KuixKyyDPs@K61kJ
zJf%lR3)`L#{Z*Cjzo+#X-zThGE}U6T>R3K&n_lI&)^laQula)Oc~RK&_vS5!<(?58
zm|SCebgbw^bAQo|{E?y~z1u}!MjHvMuS`FpOVfvhlb3~~vi@&Pguw%Pe)^K?E3B#a
zG#h$v;ph6E$m4>1ko&6W4cIn+!9G<s|H*ug?$P(fPxw1cXONqqPlYS=f79!y?|D!;
zQTcU`+xRl2Sr0kW1N3oS&-=lTRjzTou;p=_dY)Gs${!g6(;3P){5*80e38nd-^+S^
zz_*P}ADPEP)0gJ=^j!4-;dnb?QWSQV7dAgDY^)&cts{)TBAk3x$UMrsp7EZ_=Y13U
z>0;%#+#m3p!MByq`cLVf=X>o&{U1CeEIuHF9u?d#6Y8nz|Gequ#B`>@x;|6?!`H^g
zD&6+;)jgEXR)m>v3LD1O4ob)V-d3b^e|urUbd3I|oq_3X+45?34b9t$^>SJ3<EG|^
z(OZq*SG_~a?{&-V%?0&*#{6~1bR79>;(a>UThEu>zR}KZr}vk%ou21|mi{juCJfyV
z(@m7_eNi|z4m@vy6_sB$9SW|~dTqh)SkIDMLitHqSTf(#G(UwrjQtV&boVE!KmQv&
z*R$N#`n>s+2h9(iD>^ccMOTVL(VN;n!v3zp%-zC4N9D#dJy$(PbS<-~`LA2_zM1!p
zhV3i0W7PlHY0#%O-c~!)`Fe}eInUeKQ0cz+iTra)XKoe7b^rfqVecmQ)7ipCTL?XG
zJ+1Wg9bq=B=f;Z(1Md$F^9_mDN5<pdJ=o<uPwJj0l`WOebLFqQocW^RLH_@6VfY<k
zWq)DGbRhA1fS(ze?i4muxtjNv;ofS0WI4WigZdwSIDS{@)+Q>4Ua@nk(gpWR?s}yM
z6JdENy=NE-n+pl+)+gr9Q@P4<!lw0-)kl;LJPyru^&IrCUsAfffv~~%l$EZUPQbUd
zO)ql={a^5S1%K3gBDX&}R_T`Yr{veXua7>X=Le=odGis;uaqB|&#0U3WjyYq#r1#R
z`+w<4y{CAGuyd_2xZ3%*3eoR2Kd<N8H6e5yIjeQ4|Mxzb^Y_#5aiISPD+x>Pr<&(`
z!*sdv3;oZ2mUzD}d){?6_5bS&r|$Re=1SK$GkV@9^s~QfWO|fYL*G~WAK_>P;m~qg
z+4QU8?;fA5df_h{{*KxLdail6=urL!(V=)1(UVC|^d<j8(VO<k!eAxkcXv^_=o6+p
z&#Ru=`KmX2m)<+sQuL<2jnVdx-~;`S+ywopyrTTzFGBXw?m+3}HDTy-$O)Yn_1>}d
zPOay(?rLLUdwKmIG=%8yna4xx%`5lof7W4lUcE1~jBsfFB3!`j_(0{GZwhB_NAQ%=
zL)X{1SLwnt!u*_iKK`7LeTns1^t_0+)&JE<Sa3V?m#Ci7tNy-CgptRgHPd($_f&r7
z&%&|CeLR<*ulf1>Laxttk8rH?=-<N7eEBf1bnr9P*LD5*-IcD@gp+SMeT1;x6;_th
z^WCnn<9Qmvr>v##EDiO4WqV=K<2g86^^^~BeFq4`!-Pfa9|xBxUGn&MO0KWx`b^Je
z-Vfm4kW+jAQMuUre98U7{vUWgC3C7=;}yMc;C*0Zeqpey{!cCwPEFsZOL*MPmv+4W
zbehT!jhU*`s~F!^J(1^8#p48h%$d$IPb=OxhMt#A>qDxCtDd+bY<)}E{H3t*vM@5e
zsF;4$)=@jq9}Q!b8?7!Z=A3qYgSAy2I}?0g;(o|aHBSeYpE~D=u5{KE#vNh!8_}oW
z715j7dg|}mcl5sA5A+`VJd%ygXWFiaoD*3-8kmmMzNT`?!9x6c8ZW6n<m~awO80GN
zC|<2}@S(r=Yr>4jf4ZR3W$bcUx9=OmuGe#QX{Gb8sC>iY3jJXmnvd!KipMWLTj~A<
z#_NReUG>Ci_s?`krQ?Hy9k1t}-<w}j?MU~_<&<Xpu_Knv4@9OzHS@J&??>fdX<Q0t
z2=n&~yNl|*gC+g`$CW?4K-j*=c(DF2SbjraF!`JEp&$8+RKEOu*RzMP^p@sR{VT$1
zPxGbs2VrA-<&V}-`HtJsGhJ*ytNiR~!rm8znGf{b^i5%HIpya~-|CMj9e-Bs>_@_^
z`Ln`}N_S09kxTQty5G%*7QU}^>AS*#`OxB4O6R>_bY4|`(B<MTN>3ISj$T)L>Q4)Y
zw+JUK;dp!DYzN`!N@3pnXZ&Z?Q}KS6pI`4E{Ym-opVjXxojug$j}nIFM;mu4-T#L$
z{=2aKN8_)BE%R;B9C}aR{1A5g(vHfnmxQI2-5&Sn!1OiPL-h@g73SA)edagf_m%FQ
z;`gtk@homE`Vw6xdXxN0>G8w*Kew8mYg}!5k$>+a{ZRZ*)0sqAvcE#!@0tEs&xKz1
zy<?S*EN_kN=a$=E&o@l3N;jw+c3|}R71uNII+@(6ajSdX<*kozJgV=beE-|3ue-5u
z`bi=F3VDw=>#S^kd-$g6!H;3|3#H=|g@u!a#WRKV9|}iRVa9YP@py!HD?e+#sbad=
zeNFj=Cxkuk|H0!*cb^po{}NXJDa_m}q#d0#mCn7aekuIj{j-Sjncumh(lh&6biH2U
zZIn;_4eJk}ckqYPzRES;7ZzU<LPvU+YTjf|5Z%eHBOF~MEZQzR?5bS<IbmgSwYO-y
zZgip2@lS=FgN3Z$#&?tsJP(r3sU3;!%<yk@)9vEH8uzT}O=3AXvK$lKtp5x52#e<m
zk%t=o?yBic$NnkpW8AK}g|(~oJ;CY1$+5!m4#N6k#`%TQ<Aeo&5B$k^LA`%uer@ue
zzAy8jux|M%cf8U$@57xhC|%lLIPg4ac;Bk7r+V4n67wnO7dvO`|N5cAs`)DBZ~Rx)
z3*TOLxxy|g-!`3Uo#ZrrX=|Han6GM;)nAjFG%sq$3o{R?KT0#br*)N{D=aL!GdfP`
z)Lv>mTG@JJ_@A2n*|1aMKY>4VWIm~7Kepja?Zw}$Zo1h$&EIj0+SB_$?M`kJj#g5B
z?FHfRdn!LWQ8?UEh+K;PVQ6}m`;zOQTL>RCvOa@#J~aQH+@SX`9uw~;S@WaOcKW~b
zbz$#pA@r_oIx@3g*0inv2UiN4-d~&6zf3%yq50_o``T$L-|@be)Rk^;EF67OIGbBI
zF<%gx&+c8K{JQfq^C+F0PdF?ITc)R}eb)Q!=nDN`_P8|s-Q_biF4@lr2g?fk=Lu_X
zI^XikB%^vlubas9V|<_To9_3azjNUC1a5c!AeEci-qCnY>1cJ0XMRs1dh-x{oB5pL
zrTTyLxN!KSF!M9v%<@Oh`k<M|WoA8Z#d?+KM!h%oK3KY4-#Ig%ncG$A>0?@7m0e7K
zYQpvk`ak}>>dAN?Mel{5UwFIz&;3DIF~3vTQ|V|U;l%t%_YS37Yx%qO^>=O~#2yM?
zh&`fop#Be;hn~0i6QM6?pQ>`K(}Cqiuw{8AJCEoF_U*CzzvOj`-l7h_U_ar^PxM@M
zZz29__yw1aSAO`M|Nn=ud9g4!NEjU;Y=1{s|AsL2uZ91yzt!X+eb@LIVf}s~a$IUx
zKVA9QnTBU5UABIB<bH2>KF&;!;D^SR_eZyCobc;xz3p){U7DDW4IfiJbOilR%i}yY
zf7J56M7=rJm&>Sq;atL^<-qcqN{^hbETD9KMIri$a22J;e^)yOrbp;K>z~&DMe|j`
zPgJh4m@u1oo^K#*zwY($C*g1;?0s7Q7q%2OBVl%FVcpO57FIfcs<5-F-jlyei2bF1
zl-kvgh25it*lC!5*k1~Po}X<Xte9>l^Xa+Z3&JYn>wP@>n(}M=2}cLJ++o7uDMIXA
z(?^uXe*?ck{P~inUH%Or=OHq`_WXTE*nCFF{I1y_r+b~A>ntmrd_v#TzSI4@v~aYS
zu)ntYF@8~)F+FL0Q_qdef0edWy6gQnw}R5OO@;AyghTgRd8+hu3$<g$K7EkV1NfJk
z(mD56E>gPhdDZ-j>gjvm&EKSS@PM#1kIE<1caiJARfwGlKP>!PIXB07z~MUT&-^Ar
z&IbiYDji%XY+WuapCX)XCydQ+jW$!d^erLh9b@~&PvLhHwGV#@&Yj@Dil0gIHh<qQ
zgwRpuTgh_X^i2I<vVID>!#s#hcZ!y8qSw`bO|NhKN7+YPpHO|ddHsI)*?;S~f%%yD
z8%j66E5vTp|4?b<73Kr-G<;5Exn_8+%4hn*(0mbc*{r7g_%EKPy9tMD2^-eKVkavc
ztMVn&iQN90@8vm#rLByXp9a=vXSQ*D<~NhOl%ApYSySoy^}^ck^d9`)n!izh&CGX{
zH}kldJ|y2%x@!7AFkjRds=ns-st<brb~5@cuv~(ifV`DIQ1#*;)b)BAcwR8S2G^_H
zfc5db(j)twbG|TRew}lm_=`8z(!6f@{9McX^mHHPPaB^9);Ba-s=vRUzAL|?zB4ra
z@4ljO=q{%GiR}xGj?(Dy0zaS3uX>t!VQ4<FHdMO(u#oc!@ZojutI(Ca^*VLapVYt2
zdgt+Nss}#1w!YFM^UK9Wl}5kQwOld!y~p7}A?MHVgDaT+x8BnKoV$ZBshN%pw^l!L
zo-yP8&F`!HviY2b`+L%KzuWE(AC&!y^5Z##*txJL4lRH7u2FlkHwm%hrG6kkS3dqc
zxeJtTdw(6Bq;ztKFg70^n%?7Y7j3Bjd!G|Rp9XU%9h%<bCxN{Nzl+Sae$ISRy`ga^
zA1%yTZ`d{8gB>ik{uuq=Ag6kupV^_((AVPHuI~lS&+t59!~A?HQabpo<mkzZ(&Ob0
zQhw3%Bz|7=ICxa~W&6t)pfk2JVaMwHQRT~*>ix{u>Ul~Jd_JdWy%YM!tmP8MHD({!
zOWzfrAe<gA>@6v*nC>EfwKi5h{-YH?-#5Ql^gN$_OXZNeLHyo3m*{`!PR9G!)L1ru
zoiQKI`L|>>&C{XJ>n0~D9iA*K9wkhU7Ph?(0-xjR`TTYoZ@_e{wyWC1xb*(!@$h~y
zu4)`hn+T_G36oVc9?5?^F7s*}LhGZ3miv<jm0x;87+IccS`S$=e_A&mgB(!vI8Cln
z`#K)S{ts18Z6RUsn%)ne#=cQCpB9+zg_bus&swrPGn%S?^t<SdiEqGpbIy}<{yDp&
z`+q-S^Si>}L}BYxr}1;%TxsGYWad@6`k~%mdP0alMCLrDIUj-F{MhufV!69!{w4d6
z`U5+9WIZnS&elEdH|rDnE2{p=cZ9i}h4=wu_hi4sPY${;fxi7v&%wtwJpYT92e8kz
z^C~y;I>OJWaHZOn`HGNrobmo&-(2~{zQ(yf)clLzke#6NqV1HsD8KTK=jlIful%a%
z&)&-K->CVWiG?$lZ=J7nc#GZ>J|L{3A4G3sxiT;xKe$2dL(f?XmCk-anE$P?vzxv@
zzS8}0sW7Dn7b#t_JP><b!vANF)c?(Ggx%GQTM6lZ>{eqxU)@Ll_f8jfek(-os{6h8
zt>SMOE~fcOT$l7bm-VO<>kaC=sa(V7h6c9d4o#Oz=65)6-}dwD=bTH=JfnV^{zm;?
zxJctsxmV-X-bUCxN*I1i{|^sS`M~ze&~i0=W3r#>MNi#pD&4IL8z%^xmkUegZz|@q
zGu{se&*^{8p^mmtI@ww{wEhYGWM*IWGx7-jlO>Ns?kW9`zj5hhrRy&WNAC%VJ3#y#
z=tt;t5<T0`W6NjtP~$;7j_gKCbDo=c1KIhN&v`KX&m+?v{0TV+5%1{snf_*N2dP+3
zQJzoZ(0NMOeM$Y&IzZ2%m!2M|{MdXcd<EykBGZrHP(26TX?p%g<`dKN;r3%iUx2@M
z*YC}jRZrD)s%LqieVy9T^LlMqZ&*5C`N$jLQc91#-wZ5YRp-+DD=w$`Sb9curn!x<
za;oT3=1yT@Y0uk5_1xeorF-`XGdC-LVmec|f6ZiH^=E%8wWGR-zsK_C_(|m#7FB-1
zcEzms*VeqsZ=Nsg-!4S23mr#qhaCz(^{VCZ{yBOMehI&F_+9wWruUPK<(tAE^c-?K
z=R3;3RDSo@LgYivzqS6ReBuHS=VEC8=gfMVzf<!?oR`jcpRM>j<79u8WB(>Dz`*ln
z@Nc~by%T!z<mc+w&cmiJwhu;s(|DE77S^}cxJBlNCLXukWqPh<IuZQd<M(5u`IF4a
zO1I3PkIfHF%;yfSaXaq!bC!>1=O~?=F2oP1<Nc%aq`r%D3HghaZdnfF+yef@Rrfdk
zeZ*lYeoFn9&k6A(=NvV5E8=CeHc+{O`Ahhxg2#*a8C{>t<J{rs(|V402*h{6Uo~s{
zN7nM~5dG=3>gUWC-4CAkW8^67cPro4|LuKT&ir8M9rX+6SjulI4P8b*T{uh6jb0N*
zBb6hr*2w*Yyx20m;hYS9`4i$fSPy|7yJ`Nd^#|48wEs(HIn#wVG~dE|l+If3GFwgG
zkKQK8s@!l((V^M-#{K-f`JJluK7&_PU(fzD;jMn(#lqw!)sG+Y<T!oz(EDZWNVONg
z8uaGD!YT(n=bShEcW8YO=h;UC_j^wm-X!dqUut+?nq8>;N=G<weqwqPT5gBWYTvAK
z_{nFi=c!%edi);F%h&z>!9DsPxd6Wv<^}OfCXQRvH$PPTy5=!)V2F2B{HpTHF3<TQ
z?EF*Hqi`?3_gVFO@y{BE*80NQN*c%9@*3CHR>Jy0%FiCIa=oQIFKmCqzS;0Rj?8yA
zET4^M8pnb6kJ_ASN8)tyvi`^4sdR?tsp%5_0UhttoG0O2aQ5%2FYq}O&S$XxbN|r)
z(4oPflt%wg|Kp!rdQSiMUKdto!unk5=jdbS!#gkN|1{pi;wne`un*v8ST%n(Tvgv$
zwfux15qvZAB(mNx-dgV&yMJ;IY8?9Z4=Q$5AMu&$52<{9K_UKDGw;{UPpkZ-tZ|)g
zFT{VCbG0SUXU;!n|E&6ort6$%=>JXiCCljl_S<S-=TXg{{DGQJxnnF>Jtlwi&Q3}f
zANK$6s{Hr@&$p+HrwP&bj2}?C-WOK36%M~I%vf)fZ@An{^$uGuznt1zTu<$7T&#5N
zM)&LTN@Jg{{7&VNn`fpI6Z4bp-St1`I^nbNm(Sm+|8xIxJ?1yZH!9t~TbMCl)3iPZ
zx>5Fc4oz2x3y`@(&&Ad|pieBEsr;PzEcWaE^U7yF!ru;_RX%b8adtS5OMFh^KNXhN
zJcnPZSntWXc-BjPb(O0vsrsY8czh1lcue*ZcD57NexP}fy<PKS@Q$##r2fxXehX|5
z=xm^I!vA?{`$o@tq2{~#zZdBJ$X%7^l^@xEsCB*4_yc53?@JRsNB_1hM-kVEcoL~U
zj^&@4<*w)@Jx`nm&g~O-rT?n_M<3dMOzFmJ!oc%l>iwl_`E6o)2cHEW(6L;W&O6&n
zqE|Gpo9G`N(f4vrEV3U!ysgG7aJ#D4sU67o;TcK~Ot&+Zb2-mb-&_CJ|E>46+ZylY
z6~dbRE(d?qcou)6@ostj56th@Y`<%^)gI)nrui%A{nY#O<N<w8IMsV|PpRJK9X?<8
zn6R;n^0CiOZ0Cr|dVcl^Jzv;B?F~9==QOA13M+eFepBiA-}=A0o646L6psI?{A|(b
zlIk6p|Bug7Kf%{=4jTVT_?+@K`u>UiDhf~Qxry~F$<LH#pFpodoRN;{1$<?}^RZ@n
zl<|H@e3ZWF%<MLgqvs#zl-XC%GlYLtx$fga<Yf4$@>R+wZc6bMmw!Mw`HQgcb;Wst
zs`qWqCt|-LejRa6(O(d^4t{6wPu1IdN60yK&ha(d8lP68aqK-Iti3PntRgIZL*w0h
zL6}TEAAYCttnZ<DgPwF+^n1VP_gasJUbXX>%6D7B=^QFoHvda}0Q~>p6WKrVrbonm
zM6QVKkAPmk_?GHznm>Z?z#cyFK0q9mjQLXd)vm_}IU2habRf82^%Hjh|E{X#m9EDR
zy%+Wt<XGlO?NQZ(oeDpA{5Y6z_&37e#pctnn~f~*PgYcYZTrpQ-`_A@$!(-@i|qGO
zcvtJQd8fzqQeo|8(}A_!KHDSWyz(2C3z1){S7<zI=c>N;yq+&>z4DPid9<D|bE5d3
z;BL*Y{+q(^YUL-1%l}?DI>U4;FDxCd{PN05=MU0*g5A{aXeqsa;&T$A?e*v#u?rB_
ziv6o$x>7t^-^)2l;_^<-myAaGPVBomuV?oCG`^Vm8|XvN^K)wY13$z5Sg~FKd8%f9
zhPVjmZ#ZwCm|sE8fls16!R`8vG;W#OKf6o$P4ls1(?RU4?aTE){1|>}-9IXy_=d;}
z%=g|BqSM3y<s4GR{Xl#-{9?!d(m3TF(D;wM4|47@*j@RR-8H_|M}(zkHO^!EWu$r<
z%S-qZ7OHA*ry^uOnVhEan_OV}bBxO^sP>O7_ppAUpTjp)4!?xX=Tx4!d>!lciIbW8
zQ02R}gP{j$y8jusR6k}pia0!_EA>2aP&($niCaOO1>*Fu-?hD85f7O27^8VzpY<%k
zXY~E;N3@=cuM5$qrEz=QFX&;WBh@qXcR-&i|51L%^RoIArQz!))=Rd2rT3=i9b7JR
zir(M3PvhP@Rv1`5t5`47`IY8PeLG?Fb>Zl0&!c@cPdfK|-V}ww)~|j<hsM(vKf>Yr
zFMNd61^@LCPLET5^OA|m<@A4Z2mRl_?xm0NqfK7^2ur(&4mGb39cr$t_a|RadqVpW
z_IJ?trg2NWZxAnV@V5GC?0q`<h0?8t5IKl*`|wG%?esr#I&qSb>qp*yny;uF{6J!U
zC-OKE_l&qXdGAN8gR12<_8a(h=vvWy&**P@&+tAWeyqtAN{5~=(7D8Pp>(hQr$5kN
z5if}NWazn}C(L)^Q5XHa*qMoInCij&f6?EQ^E`|;)x4`LBAl3CFV5}#WF^nT=Z)Xh
z_>Qxl$L|RTE9g6VUlG=h72@B3|19T!atG-D0&<S^m+5zy4nbGp_lOUgSkJ=$71N)B
z?cc=HEt(DyR};G3vwW8KK7-x|{d9Av_6<CKJ=@18H!B~$7COm%z`q^8irm90-?jdA
zQc!<QzN!A^ocDB5mBVj?^KjiAluz81#C8bu=ArcvL+f=WZ>l`;r+YppGFU?SGwZh_
z&QDoh8=b5F3-hRbor^X8*_$-(y+t(cE&Go#Uy3Vx-aMpoldVK=raP%T>mI#L@+r}a
zXl~J)@D0(M`bJJ~C3+LiE6n7TU;2!&Iuk~ZiXH`vI&Q)3YH!Wwl&Wr5*ZMW$5f&^j
zb-e!*e;WCH^p^Y2_KfkxO5+~^eUI!%L!9}k<qi08^l-@M%n#^9$8r;VbL%O+r)E0H
zzQ}$_JZ180eU&F}AaYz9uhsl}-|`jl)QJCx9trsqeth;@)k|DB@}VQ_XG8ZNdL;Or
z*z0y=JIvI4W#u;2JM=z}AAj_Y=G*ws!ori9PkGDFgN-$=Q}eaSi<(#XZRG8zlG+as
z(R-k~xvQ0)>?9;^TG{lbYx;n{4)KnfrYG15i9=poSbR_0@zIH|-(J@F_CrYH)PJD&
zrut|1$He*UC-`S!pCk?j{?ynziQ|SGNL)_%(t+ti&HU5A{<N*%soyehdR_ih{f!?<
zxQ+YmaAD>~{h!-cnEi_|+1CB|b79}|J@P(!0qiUFg;lO<du9C?jc@I4VbOB%cq5gY
z+TS(5m)=*mzh8Kp=u7S~&4<D-JrAByJz1Y$AWmCoe*xr0<ka5YDj)11Iu&gwex`el
z_?__*!pu^lGnvIiXZmxA-^r}5^0@<q;c=>`v4+}PT}BxHNbezz6zjBQ{&Tpg`_Xc2
z*K~(?)E%Gasaf8~zlHl9h`-e|U(WnW^*GieqR(NzAaB*YPKj4qf&c!G+SPtl$ohu=
zXWe(buc42^zZrctabDnau){$o;jhZ3Pg&Ck=6T8cEp!+DY2^1}=R!}4-57ld@&<8y
z*_Vmuid;Y(&Dm%5y_`dAJKl2sJk7V^+L~|eGc~TcLp;u&x9H)Ce@7hk)<E@^t#85p
z+_Qf$d<gMgxz~dI9e-ucPoV$eKBJoL=g9HQn{ZCiBm5CM)=MLwqZdm4?QwQ{D&ChE
zXXHQh1NeEsM==kwmfxX+v$_1;+j@QO;C{1z!fX}&pPpy`s`@iDMn6!xvbV5de}>5Z
zQW5g4`Ja4U^=0=L;t!a8Q_r`r7LIJ+$!@OpbgmXotgjwyqUYf&r*22tbgO@b$`3+e
zcc^(0{g2W)um92-swWuez4(1hf2I8XPlffv^<3j;qHm)c#n04^vp#4G<!4vddumH6
z9p558Dmhv7C$wD)e}3Xf5f`{Wx8G|&tEv6Zisn1ePxRkaxzO|gKL+CAk1Ri+$3gBT
z{xR{NvX;A`8x8YE+!KR+sc8KG{837;(91lb_C&~S*5h>G&+pOy*te($xeWjRnddd~
z7km}_Lcwx9d_VI)yifI`x5kc>u^tQlt!w#@{f~Y{P9xqP@*VnF;`By8)_bO1;b0xj
zo8FH_e<ts0+-LUFh&%efZ~mRQw$NST1L7BjT#I}>FdxEw3ecI*`w9Le1>3vPFAvQ3
z&b&WyzN_LidO-LZ^!V7znmp(E#W+F7+0U>yus@)uZkew|E`~2f?#3T=Z2MpDH|nQ}
z=l^hh_w$Cr(Ec%X%VTAq+biy<bvYgjIp;L8Jb|AvaV`qq)q6NkU0BKWn+_6xaArTE
z-tMZGxK_wrP1`f^*ToNw_^kNp;wQ)X*U>-yorn7SELUfDQ#w9H|A#vXX*cJEIgiJ^
zXZf@AT<0Q{&;3FO|5$5lKIVTeoIb31N*oK~j`V$g9e=Zo?X&oa!#{FQ1@Q@>JKV#C
zJRjIj)H2`Be#X5u*k_5q4u68&f!xLZ2VcfKLQW*^Cwgl1mGCo^oAlIA@Fn%J(t|sM
z@MYMyxUV8Me}f(xI~a6~IQ85+fW8rapY@FX0(uQ!f&Pm)`{*@7%Wdq}JYPA(?Kb^k
z9aY<!r}gzUzWs%Stpk-GcpsbnM$dOo5+X+<7ouNdT#<L-!?^d1_*^;Lk?<qNKZ<ki
z*uj|>@RQtwf_%q$7wG@gdOzyVLhr1X%$W}-K1SZ-lz4xDzl8s+!)M>F?<W2u=PzrY
zQ$F#QCU0pSW!H6onU5?Ts{YJde^LB_(!&ph#e0Q~ZwTYZgi&4f4PH>Xv%Tv#ox?6g
zT$7^5hkBFS#aA>h)$^P;AWk53Hv46@xAimCKio@c>>W+}&!+pC`7`3Zw*R5$h>tp6
zSLyQ8dT(I<E80c%;<p8#J-klk`l}0TK2JJ1UF|RRlwbIop64Ez+|o*8A40Anen9mC
z{STi`Jc5GxV)n1n%PL2_71|egy)!?MuUOZy^}C!aCJxWg{0nxqvgZ$WdF;UWrIXM7
z1K1(3hjC8{_c=j-nop|T_$Oi?!9R|6wJpcPH`Ls2-bX#y&t`5vdUWbxKj$6|?8)>C
z>%MFK8uu7MSBZDeeTUpr(7j9JJTN~zu${KIvc7NT^W?<WZeFN-;{0(QhH-@67R*=T
z_k{i#{v|S>gj|h0iQi%QRlNs&4RR*-N$3;jLE%4%OE8=H`M(R%^P}%;ns3EEfIT$b
z$1FEzPjo#C33D%LePJ)@*bj<$!IAyl3R`;}{zS<AMTO5P&G{4b8o8~#&U}8lY<Z&g
zKPpc=8_w0Ge#buVQ2D^`vA<5`dX4MQ{>J$)s{PgFg`AJipR9D|7-8!=A#rf=7btk&
zWqx<}Q90-c-<|oS^3hM_k9C^$>~SX!JaPHD^QrxL`vJ7=m(O`o^o~XADYzE`{ULlT
z{5pEa@pF1V@hI@KWd1{!m>>B2peIS~(|y&$y))E<{|NUv;0KMJocne-Pfc7+{LkP=
z(C?t{!A}VJ2K#%@cC?=5x7h8fx?k{f<orzKNVOY(S@`*m<$LHO^ar{LKgIV!FY%v&
zA7h;(H*!x|<tDusI*)u-Yb!rz`yT%N#Pf>pwLJES_s_Fc9=$jB@FC~1kK%vK`=dYn
z_jhyNE@M3b`ak$P{34JunLmN)5c?K>$&45DgnMt%$FV=<rfLUt82XIAD11)+W|f2A
zMqY24{tOq;|M4qYC&{B;@4pweGWs9CAmXSJPdRJ-PjL>FZ`fasxT(}j+_%zPD#v-6
ze#7rMPnf$y*!zYs@i{T#15{5IJ*z({zP9p1r8}Qe`CtbjaZ<VO5<hVKs2Gou=lRTh
zHuosjzodH5YuEm)G;xQ}m$RN(f2<$Q{pT#_b&k;U#D(ox&dhD4{^ed7<e#?X6y!SY
z+29@q<S_hFd;SjUX?UOH-YopnnaAO8^<M4=;~duP66arUyj4gX%+%k;{Kx1P{m(sM
z_`PyJFzw*I^mprzdJg|*>{i&(vD;$5;{C`~tb5iS_l6bCr{K4X{;GSm-WOX>1-*xk
z;wJ}RS@n0pUtu@ym`{n^KggTJv6z`Y!Joy8>Al2d8lNQkQ$9@dq5ilKeP{n7m2X>4
zK`utVrC*6tfnNo2I-uK>M_)EJU5C!$-^usk*O9T_kAA|hFx4~N?e=+oR?G)=J)Vp&
z`hUg|I$Co7m;HQpOVvkwtg-3P)N}~?)0<P}usasLu87+=vwf^EQGZt6bpI};=W3TI
zjXz*+PSK5APWiQm%qLx@bi;C5V!IV|ZuB+%pV*J5aH5_=kHq~r=*75qsqXaxUBJGR
zct7Eus?hu)ab2fw2lE_#KkJF}OPuFxxIX-`ng{9ov)13|4t75V!s_+<p5g&Y<Ie@3
z0pHEN9`TYY$GRz)KH!glzbf}1juMw=z5G;Z?j?qQVZEm7(9fZN4}PiVGS+uMheEGM
z?&+&us&d?WMLa|Nxu`#D`UhRXo<)0xzx(fY4!pm^7ohirezKnM@8Fyp<3rpk%CUd2
zuaB?M`;ZU0|1>Z?fWAZDupg)XzNR~j2lq;bKIhS~-lXmI5N@jX;orhJRpMnQS885x
z4<7Oq_ITuK<ix7^5$t1u^)u+{xHkg-3iQW(Kl6e6@9>+zpN#v~kXP|{fWE``;&;lq
zAMT&a*{;X^Ch2~Cg8O|DA#rZ;_amNE_ign@@F|tc*)B|cyvBa|zx<St_}uXsN)r#4
zdt<R@l^wUF=<{LROO2mV_6_l^-6Jh`eO~Y9-VDx}albSB0(w{cb7T7zA;-WM;_rkU
zz&+)})9hKFPTXzoDMpW4_kMt0mN>=OS4Lis#G6HK8`v*__?_G{gC2x?`et5-)zkFd
z#It3;!QZD2eK7sQZwUQO({c&%bqb~<#I+jzMD@3RErh-_u5j9Pi+Z51AHP?fduF-U
zkbB(l(}6D_z6*4Ub}=vE&xY31vQG?6?`jvTUD$W~{{GaD#B`Z^1Cd+s%Pp9mvA@%9
z-j5$PdM)f}$an1T@z4Lezwk@oUNHR0@K5Jl3vnl+mY(OnwZ7x@aF06t4)bYzy2{fZ
z+~>!=kjw}A13e;fO*-yR{HgNKsXq94`V~19y%_Wcy3Bb|&Rfw=>|Mya&}aOG3Z9?b
zE7CVT!QNbOe80qqJsLWcI6g|o^todD6Y&KyXNlf4Zx$xkm>%sS3@s;(9u?m*+C=#|
z$3e+&sdWEA(VNP$qCcgg<gN0b^jzl_Vd!(I$cNl_iT#D|#2yTvLjR*z;J$kJ4&vw%
z54?7=#)<nuiQ~w5N!BBF5$qd-<MkZzz8J64jh;tm3OPTR?njp>KWDlVdA%fCC_lB&
zALZwV!jkQ9dFvxMcS=9d-uksF&;QIz>^R(4$2s|m*FEt#h%b!1K%A)Zsj8QA^5lp9
z9`418O+VmI@NYox+BN?LHcT(sr;(@7pV2>zZ>q;N-6gIEbeHF$v&0u+y>PxGa6hGd
zjp+^i68lci-^2cfKLGqec#8TZcdn58VBst9gMrV^@2GOzQ`uTiY2tHbw^4ewnbylB
z5oVT9etjn)@pYO1=zkc8p63bYR@tw)7ae&New6uuT#r8}e9p*nF7@O+&)KK&qk!%b
zZ!K6$?I(_C%jbrOBQweCd&ZU<(tADa&)NN!p3hz&y3n@YO=$a8-Szi<&Z}^?$~9MX
zzuhZrTOTw)?)rx4PxQ2~{Icj${B1o?e0J`IgD=I;h4Vu2`}lz~pL&)@YY*!C*r$j)
z3%%gpUGniSA9$Z_d;g{0q1PMqhkNOA`{+H)L&`(XxL>+>fyzaP2szJQ@w{t})nD8r
z0Uengsq*aa+&|Afvgj{}Z&Nhi!@5UaB~5(N!g;DUV}2-|x9tDskH${({qTbm{|{fr
z{N~&a??W!)ygYIratHf5@)!IEc6RtJ;&P^OKiqEU6#Of4Bk~{m@x=5F`4c&);qgxO
zWR&y1PJiQHiyaUDb?k3l^Tov3f-hzqk>h(ajWc{c@_cVI&HwKFM(abkf4A!MB8lxr
zt)(@7@Gpaxl!h<ld^7irqn9II5d1d#FZ%}Z<B&%=e*t}m?lDfxW9**9sjJvunR715
z>-z4_LTV@T2fb&O{do`lKU`DgbK9vuTGkUsiz&ZZa(#|VS#?~dyzg_Fm|k)2zG{Do
z(t6g{ISx*4b=4DnQtyS&#XpXFx2uQgf9$u|U-9=(>9XlR`Znx5@G~>pDT<~W!4ayL
z`?ZPFl{;Gb@CmcslrGIL92?uq`FXz=`2fAg_)7ghvHrjEkiHlG0sgw^es4Bao_SAv
zG3XC`7km%;;ga|3(q(#{`(2<n$XVGl^gru4jU(-R_E-2m;*)V+fp})f$Iw6ge(SO7
zCw>`mIEWX{egQqJz(<*{fo`D>M$d;{2!5aYwu7tmKK2>-x18lp;v*o3Vy7o=0P_d>
zh`a)ygC8FJ0rB*pv+zOar=owVJ;<Nfjo`aVrsu>Ltn9A&ko9@|$rD;1g>R`I?iu6W
zxt#Aa%a{(87go7!C`7(ze?s1F-lzZRU-(JB8~TXcPk*65K<_~OA^1}Cf5_G7jmqcf
zefVc`pG7KPnvX&ch<*aU3%;9sV9T~c^&M{je?IPKOLkO05?5>BxPR??)t{Yz3KRPe
zHSO2evYu+Pf!f<UL5Q6TKa=Vom5*Hpy#f0e=Tunt&{g78K+o|z!~TJtn01Stg#JXo
zP(4`h=l(M2d&m3><3K!2=sEXzwC)rg$8N~_sUN3$i9g%@q0;aLJ<Ev&>lIk{#IGHi
zE^;3fas$|~oQEDC`x|mf&hJBy$iCS!9|gU^uMRzU&i@CN&lnHln4zbJ&Y;(Z&NqIh
z?__*<ZeaccK8y2+$ZODL=11=a*JFMa`2o8TeDdfzmCIc%q+aAb?%l+mQ#XH?#$EGz
zfnUPjivFlzdjNC?ITibMzoz&0CPLzV4jcy}@ALTag<41OiQ^YcpS~`Pb`@q8RXxNJ
zO!=aM^2dE4awzK?y%Fa{@Sp71PQ$srw!a@f2{{bCTGe(*<haE1jCFwhaO8aey&U>M
z{zuMhnlHeAf;jQqyIk@26Q?ceyPu90HV<|GRJ6`Gmrgw0@O0^Wa(jsmh3l$+7=P>%
z_-n8Zn0NT|p^t{YPU({874*6EsOpEWN6wgjU-^Y&{J-T8^tJG(#G6BYhtI^G-&sY^
zw>J}_&*U5;avArfPj*)Sw02PWs{OM%@I$5}lkN3C@%lJN!u{pwvpDaG-V{AidT*BH
zHuQ|}A>6B-{8;ZHete#N+4OFFmi}j*BA-o7H=tM8<0j{*Jp5DHd=T>rza!*6=qq%v
zYds3{n|&JnGjbMwedr_L<I(S+_o6*b+vT9gtSjVX<`?=K{9d3(_&p&<!tcOOqd$S)
zu6h4t|H6Kqaeqh4>s(gs_=(-`X+3bCQg>(dV|Q^O_n~pW5`69~tN%H-nP11{Hx<Gs
z;{O00f&LH|3VMwnEcQU?2=|Mj2Sc7^Jh6}Ae?@up7|<o`XYhZ?FVs%#zVOTN(X7Ab
zwOTh*(_QXcM-Pp^Vbyl@%&F>6;)``JR64j&^rz$a-d*z(&|CIT{5|Oxz8C#T*7|<z
z81Ti++n(1E@+|v5`kl-p`fmJZnzpm1{LgjzAAKJCHt$D&z&$r3+Y#a0kQ-R1*x{kC
z8PmU^&w<o#Q~&nOM{pl6ejvon>)xtz#Iwea`{Q&Ry(4;K?w4ZTA-AXe)&=@r_@^{(
zwCNA!(3f%VNyqwE=mGa|u>V8%klT=V=m*m9iDmD%$h*u_?C;FibUk@r#ZLi$OXM~9
zDdt707y6yPmvLkrp~uE=3i+7*4894wA9M=)73+_6jQ%QPdX2uT=Xi__&M!I+Ea$d}
zOFY?I?d1K*``*8%Zolmu$nESe`01jzYwY{q^$=gGaJce`(+?d+?n0hKFVDJTy-h6l
zBL72&&<o%%3f;yZBxgAWeJOOB{)c|yUyxl^?JO^@?=LSeoNgox-xI%6_@dI>Utik8
zbp1MEw3*XKSf6Bj2>S=?m3;`zKcV+y-$Bm>9|wPeeFDD@_8sH^)(P?i^91_B{zN|e
z4Do0urVoq@^t$8y2EVJqwrX#5ybwJB`!aEna^{oq*GJzSeoxP_u821o%&q*{a_Z--
z@9nAioIUZ{ii@Zm{^0nN!}r0zp$9{+I<g#w9v1lsx<fyrSAbqHkC2xVuM7GS{)lx5
zy@9?Xe=!f)XQ2<+^`Q&UHS}TZ)5v4Um(T<Br>sZj1$2>pD(I=-s0X@*9S=PPd^mP4
z^d<12@O#vYyoMajIltmYS_i}hZ8=^@adVH~`ofaqkrIcOc}RQEtJKOWUzktW_@;1T
z{Sb0m$8rbv))T)EdQIFn<VwC5xdXlry(;Gr*vGLC;Maxzo#&8K8~3Pv_#+{ojJzKr
zFLKXo{Hpq^@ALE>$MLCtQTds@guUa0jcY}3YRd~V_Ad;5o(%m5b_?RtK#$Q=!hgr7
ztG#?TdK&zwnU}0@z7swheiS|cxdOhBd5@i&^$T4bTfYolg#KYaMql09O6}y_2IpnD
zZ;^8{=y|v=jeD%?yL;YPF9cm=y<+D?kJquEXwXu>*FG!yR4%C=^u9&Y7v9(Vf&Nd-
zkHP=or$Ah3^eyPAh!YC`f<FQC2RnV<<Hi0$KK+JXl>gZWuq(1}QVux^I}GE9UKct8
zpOZ5m%XneOz&``IAA37=7P~%nRQOrW%i^bi-jVh*zu?Q+FS(Dab(s6x_eDgGi&J*o
zs;TdvO#Pg#*B~wz=e5`eil0$^<0XZhOKAC=bo)Kc1MJ?Me;hohe9i&%PE<NxNA=*x
z&VGPC75V~QCN2T%6a5kXX*`d=B+qdlC3FitTgCb(_G{KT{POfd&F|^nq9@(I3S-~v
zR=7&(^3R2{O`KjwNSqAxNi*Ad*f%)`#CW1VO#Pf}Cx!n;u0meL{}8&%_@l37KZSop
zuN+wpMIS-jKJ*XJHS9d>ulQZVAK?#yoCaTB^t?m=+u2LwOnj2A=@oP<*U<lg=@0sB
z@+Uvi|M(Gb{t*2@>))DBnWD;J560h-a`4~W2M)i7eg-`j-xZ#y`cisyk<tb8c?I_)
z{0x3Klgm{O`huQ@{T99uJ0bR8<N@wEK`)IyleiYFN9;bF4@>Ex=MCo;Mz)iOmgA8V
zpgWw8kE~C{p2@v8tSjQ2;WvnWmU7Tv?!y^H?!T3-|Jly{=eRHRFH1iGJuUiv*l1Ce
z%Ri}c?JcM@_lcJuRz7~d+|P%dztPtJW!sH%TPQvIwlFh?>cg(b`I@2i66jayC+G`)
z<>*DR^K<@^{@{EV`V{y=<_B~w)#o1V@0|#1_E#ucZ#=OcC)iVTrGKTcaj0<Uc<b#G
zln$R3mRAt{%K2Owen{9aI9JR5&b_|yNt~ZTUf`S}_hTT(<M+&d$$kX?hyE2k7koK-
zBjkSQ4f7AZ3GzSdWq7{&i8$Eov*<0LZ_F$BOV%Iz^wj!r?iH<i9Jr63xckIciUYkD
zI>x#tK5yTA6m%YaGJ5A!9xz>jKSJ+^U5j&tebYnauHtEWKmCZE1w9sgA?G-;lcUez
z`>}tZhvqy5`$O*cdJpGq;fwGC!><Q=!Z<^hm=By6VLvYpR4;TKJtX;@gG1iO9uMEg
z`a`dc{hGKR=*_|<MQ@O2@t<g)ul)8WwJzGLDUMX_6yfw7tsCMmbKhXcdc(fYZ*!km
z*7RiZDScP)H_?~QszTyZwCpEbI9d6u8{%`IZ^cgmdk5!>u|HSt(t9``1l^&(pgYKK
zAaPUJ?}$%8KjQC3{Hj4&?d-iR`rKbq{SsX+ES_(4e8u>2rMcI<WPMNW2J=roe@Z-d
z{F?Fa=Dx_8{qfLCF(1)SpwEX+qX*;s5$m7+L!Skogg*rKR?Zo+uR_0}8>xJDvHG2P
zh<_aG5W5TeJ@zI1kdfcf^9JT;&<COCDdar9j`zm>)SUNE`F-mNic70Jagp$=L5@UU
zg&d3j4|)XjKipf39NTyM&@&)!6%Nt+&|4wLvtBswKpHt2x{bVqop|hiWjx{2*<U&D
z1wVzqdFtP3y=EFO;7+v<e>wCJqo<Tl`=CegJ@B){HAl{1f99SK)*10Ecn@(3;HU8q
zCJs`tnch!)V$QQS*3<ebI6m-TRmHdK-mHA&7w!?7oU3(N^7+nLtTcYZ1^ek09q+I5
zFRj1Yo5J`emB&8``pS8E=n-)@#*eDq@R87Iz8`x&dUxXNqHjhY7Y<bq^c_7m{44&Q
z@B=056I#CKylQ(Ead2Cf!$!nA{*UNS<9T7v`ccloVE0DvN_@}A=RnHmsekIG?`iyg
z+fkthtUvVg#8pq@J6OMkJ{>(M`eXR;j`<hnHF^Q~C;UgyCqV~Oe%*X3>xy-c9uqz9
z@Iv)F_FwKdn^_*?+;sdM&5P{i!s=_n%o9THt>gaK*!*eMdZ59EdJq05+}l1hpM!iw
z8h$4A%dtKP{s#V#c4J>gA2f6S;kOAL;``AbLuas0rE-hu27FH%@2acs;2b@1N2rH$
zN$7)+6Oi8+pVYo<eGqm~<^%BsI1dUxO&mAI4ZeVVIkoe=t9IhI!FlI2-s$1`pZm**
z^D+L4@~74Zac@>)yV!I$#oz2~;dteTi4Jit137DUkm@P^LGz=OHGZIVl>AmWa{R8s
z{GLyiyJm0bdGzwo+cbXAZTcTO5OJe8UzU#7(<(>&n4$S2{O!>1K;O960Q&`UIDSRw
zg+}&MX?!4h!u>M&OO>w9qwkxpBCOeus(X|EA36>*^A-6Iznu18)b7?YUSCJ59_}?K
zZXV|}`F`Sz;r|4`$UfS+PxTT%l71o{I`=LR$BlR<@axQ5^pDUj^7#(v7W*su3iQ_S
z3+QcHJF8u(J~~u-V1KICG3tl0=}_@_rEB&}!!NX9du;QU`oFQAu=BhSI**-)a~bey
z&=t;8q8}pu7W9O3UFfkprenyX=;83MMn1*P#d=Qe(03AV2Y)o|D)^(Y4<oM;mz8r%
z_>~aXg!2Z(tzllUZ*xup{+hTI?87{lzftXDA0duE{1@@w@DIVB-gg{$_$l;Ht-Rzb
z^wr$E#(eBwtM@hR=Zv3B;fVJ>x?iO|r`OjPe9wyShsrLc@g>eq*7jG<bxti;#g0!=
zJ5}qcwT7@_`%i3p8Ry5)_Y$vxI3&nX+@C^RruwUDKl=juAIb%`Clc=)zi9Ya;%6ea
z5I-gLKgT{cb3dK0_BZ>Y!=(e%Keef_^@cEG|K{owDj(0I=ZQmtUoCbi^aSOl)vwbv
zgv<}(1E7bXU)cAE13-UZKj3-(NAHYXgLA~#>#>VKXP|TN)!0|l=Wo_`LDyM7=*O{_
zao&MAi10U@%i}(%@Kk*_^M?D)iZ81lu~&5e<oWl3khm$tOW_=Gu$0=zIcn@XL+kyK
zYoXV@V^u!odwp&MzMpdn=sD;o?BK}7`17Nu!#)5V%G&=1KP=>5;w%vl6}<xb6#UmY
z&r5muDD(=96ZY}hllm^&!FsCSuYCOd@n_~e*lnOc$Y<EIplie{MZO>o4D*8hEuK&G
zXyEh4mHm`1*dH-_l*iTg+gCQ!dYTSIf2zJ$Dz}!}9V{p8zvX%Gv@rOgkaG#m-+TW2
zML7Pe{^wi?d>?#$;ceB6y$^XcaXx-e#0BP@6mgw~rWeR#+;2cUF6`ZmKmOswsl^|=
zZGYC_O|_?8P`l$VxnGVF_C6GbzL%@xdx*P>>3h+`bMBw>UHFT!uhrJkdj|Xd_xGd6
zK_9?=#rYHTVeFgG8}=#6qu(a(G5jQPq1b1M|Hb)L{92i}=;0=wzsSSb1t#9t&>!K)
zQ2USiuWLT9xP;O*$7So<F4130`3>I#)0x}lh?lmi`iHo>;k&Na@!tA7E8RX#Snzyj
zo#LMY-QXNh>s-}~J`24he$UXA?xiY+{EGhqau(+X(Dxz-p?~C_&EO%`1HE8hLC*mF
zXFnc1qVmL1X8fQtALsMgZ&Q2JgMR)cVe4Tb>yY???C;RI^4R6fzp?+sw$ETcVLqqv
zfNftRE^TWw(HqY3U>AcQ$M3&)kID^S(E03mJ>OgRoYL@V+#3)7L;Sn;9a?vjXNB3D
zH4pH6L(hp_8NWH`LhpTjFXso?e+!>byP(^|t>wHM>w);z+#|qvB6o7XGjU?s#~A-q
ze{#Lr!Fo>V?05BDL!am39*V|~M2CtSh(8)FtMu$ueLr#jvG))UlX;0<lYNYNjvf!Y
zI`$9xk9$F|k3fgf6LOveJs<HmIloGLQsV95e?-4CPnm~2Pd@Yr{|C<Nq5nW`f&a<c
zevw;A{WA2qmWj{TkuIAKjVzCGuO|9!>Lm`^!1|$CPxV#~6&CF8k?MJ_)VOjk9=R1d
zPW#cD!k>_aZ-T!;zZ`hK!aj~)2=+wm0_caS5B>zY&%VJu_0Svk5%z&}y<5+~yhVRO
zTrT8$;&&0>eQf%HUKk|KHTRWq&j#y>bwb>K^q1UY&ppx5N9Z7N3Awj|`)FtDYCN*O
z&lLS;^qlWi*;sm@{uWwyDZPG5<4Zik=0d8c=yQg>&+GrpCdwxcJ>!9&4fF!Jk$a1x
z*Yq6c1TyA-&<nMnce~B+5J!Y~N!-)I{=xq|2mNBbVNXi$V>Z3V?vGxY`%6dWZ-N6w
zXX-DA?lc<0_7dtZ^deKYAO4>4gU;gjg#7?}J9bX^ar|rG19=X6Ap8ycEc+GuozzZf
zJv{p=@-Os+{^C9r<}q}KaUlLH<%k16xm)8CxgXm#rGrZ~FOpq_b=xuOwwG2`QMuX|
zg@qM_*x{$lCnND0@Y^R|Ok#adc5ly9zn^}AKPg_V`th%a&p|(joQk~yJu&v~!I^p<
z`3*nARF40Z{)hi6TQ5Mra9>ZVxBR=xv#z;sr}#JJ6Aztvik!_kE%sC5B;e0NoG|1&
z_>a2zd*VfNKNstbbwQlWhUam<ul7Knh<^cJIpBWMmBcr2UWI#fdPU`Pp0|9E(((Bk
zuc&B#2foL84DOfU{4@5uz;ak}r=G{(D6k(!O4oko@i21V3U)`<8S(0oJM%B=IpRJd
zheFqgb5A@H%Hb!K-j8Cwm+|9XdgL(p5#$H>HS|ivNeUkped)g=`cs}y>Bc3(>bz<%
z_cy|y;0H+D!R}Kkhdd7-jJ^`P26Py?i1X|0SIA@diQ?CazL9+oyCD1#_e9`N0)4^0
z$T>&qWnY8NV1FbIFZEactnVWJWzGJ^@e7(CS?h^8zkxpv`ft`1dXsTo^;MP?4!z$c
zyC|Kp9y5*qw6WeZ{<{$V41ETAXU3a#hCDpByn<W_-N7FRyC8Ikco*oCIB$V{ANwly
zA@nQo<J?PuK9o45=odKGmdf$>>bpNaPRLEjW!M?GmpAdg&OXmNgI}7wsCo;Z5j}u!
zuJ}H`W}tlHWO9FLbxq|%_jpfv0p&A~Bg-++dFWE>T9wP6?fJ2w_VHvXt*`83%I97u
z?yqD#inbFGKZ@_@dET%-kT0=EpvNMfGyEm@9m5B*E(3oL_Zo4Z2ls^#=M}j!jazED
zmv|Q3vqaoQ&Ofj(z|TSlm^Ylm;hc5B^B=n!`v-CMxj%sUKtA_$GY^puJLc!$-?$eN
z`vLR>dJLbA-j91P;79OpKyJd11G$2I6F)Ze)aaYgOB1I9dWHTBz8gPe?kS+(p?hgR
zo~`+fU-9U1rP(jaA1F=yU+PC6n6&hN<8UEz*lYo%vukRe2Kxx1d-$uQ{);E5Jp3X4
zfcT@Q-)*}P{f534ev!DU`19aL#<>an7SLm3KWD$;K0fZT=U!><nc}`8<~e>j=!cLO
zIfn(kMxKWc!#@K(AN*9u_Z+i+vM;D#>I;b;z^B8XasN&HoXUY2)3xDW-LK{s*f+U%
zD~VJu`xEUS*8RS(c-(#^`ctz%UD5kFaVgLv(f{y8+@pxUIO~&sz&{heRQPoEyZ-HJ
zKlX9%No1epUNgo6yAt=I!bj4NtecdMo4;k>KwnBc4&?N}d@}Y<{P?O5sC|qF?L+^B
zT^hd-{64V{Vb5Y7Fwa__R{x`CN3S*WzEk{A@8zB(;&PKF?k#dW_Swv{dJa1Z`hM*C
z=o^?P@E@!n<VF0U(TAgd7>rau-^04%z7yyX_Z@T2nfu|OuiU>}@H|GJ3SUt3e1?wT
zC)fOr-p_q+r86{t2iWKBcSPJ%?7`SUIj4|2K=lwe7CM37M13=Vr}rEDGvG6sx2c>y
zP<iaC$kFIy=@-5aJ1xjP5yZ;@nSbmr&}ID8IX8p<7XCoY1N0iamwV8Yc{TrLuc+O#
z{|MO+;E&kv_#b%?J2L6S@)vqm_!RaN=r{Lo)t1rwiC^Dv9EtWzk|*#VO*T}!MvDlE
zQ-hy9eo368!;cjIc-ABK2K)x_GvS;+`iA1a^d8m~eu>Z*{zopsua|K~e@y%(^w;?N
z;J?Z_a?WMow}<@2IbQg6{QuAs;8z0Og)Sk-vrf@-;WvPu1vwx64}5p)ANqdgEA~C~
z^!%T$`zKVM{Si7#KjT+IybaEKv0viH0=<DBK)=fVj@^U)!H$pqJbp&)AdS5TeL45c
z!M8z28P|^Y3GSIo^(3Zu)Qdj2{B8HsZbJO5E2cl3yXctzVqSI|D&N0INL+O0OM3(5
zcWmz`9!QJlZr1<kL(msNZ_wkT7e<a^-wFMl+&hgv0sS!hD*iY4@xV_Jmz#CS`Qg-#
zd#c)((nZfF_<i_P&ZQ5{|4g6ObKL94egYqxwcZ<feEKJqN6uvb;(P~sbm$Z3bkh0k
z`O;rr`$y(g$z2)y3vwQic<A^Y;s=huS@s~cV_-fRe^bsC6DI|Fh8`Nf5%yK|+NuAt
z`91b)>;dri+;`1+C-x)cPWXMW^F6hb`G@~KdI-)#6GsX^;nBHzj(b_)$5~g%k@;&>
zj&(~Mxx{ug_N|m2-Kp}dOZKJM`~JuEE4&x`4g3rKKhRJ1L(VJH&(K-s0rs5I#cBus
ztneA=Rhj45rSTiX4-S4BdlGgv_%Y}t`XuH#`wMgiIs`o){6X#FJ<wPDcvFAc)m08T
zi}<aar)1wNdtJiMac&g9wvO#*jnlOr@;+}y99-fiqQAhu2>U(z4f`Pc;naEn?w^9b
z!p}F&f1vloKAGwT%zxuQM*MF0y6N%ye&{T8i1~mY26P7h6#Nb0e;6O^^T;Q>7ynE6
zWBg#*$M8GFf0O$s*tdvhG&FzDzFzeGRVCj;TzEzNPp6{qf{r3@GOruQ=>ORIp0e$c
zoI~sFs{c7J%)JA-!<0||A?HM0<zsKg-jd3fH|T%X8+K>t0_Tf3x5N3ttmzJNVRb9j
z)7o5!ez~}V()jsTO?Q~btVh~CI!)y{-x*oIPW!p11;1GS=iK7(5<O3x9@YtI_*?X-
z*vHV5bAFLHdWq*DaVqLZsQ#|yjL|+ySN0c<oKO7h`j7no8AA3A;;a(~2e}%1JM^9T
z$$CVuM7(eGBKWN_?)b&B@30QBOEBK;htw|Q4C3844pBbws92wj1MvVjpN9P_-cHYP
zPg;F7(Vfu#BWc_Y`za2+9yk|CTp{Y`To!yY^cXz?c39{#@-zHA_xs|v#yJW0HRMU&
z7aXPbb8eY)Yv_5oKd5WD5Ir`03-M^s51{{Kyg0u$G~a`Mka<tMr^xm|_%P1j&_4X%
zIj4(%QqT6z#-BxR^1ctfb*9FFb%I~sz;ZD31N%gG5A_3j=fb{9v(B04#LI(ULXKx$
z;<v{7Lr;pmnfS)Y@7VpIyLsDN^3cP*)ehP>TSaN?yWC@)|BCV}TMGLnA@_##_Eb8w
z-XSsFMehZ@LobRxfpeCT?KEw-r**XJvs}P=0nWjrrzegCas~Wa!*m9DfVidcj;eR|
z4PnXOg`Xq$Lld{Dv8~Hne(4>k^vL@I_uX_%kD#;c|L{ZjW#i9<Ji>Z}?~1Qf{m8NK
zHJryAn}4j_q;jdB;IG}zju3k@eg*gsaIP5p6n^IHm&7TAPk;`OS602n)r1|>=SfZJ
z?B|71PT2PRAigpC8|(7p>mNHWbcu6S*k#glGWK7<--UQA=n2>lm|yViGtW!-0OGoE
zUIKkB{2BZud=7Rk^wq>!;2dvyKD(*!A6X71-V^aF$L2Ri2dmuJ>ydc==<$gAJMg`j
z<LyO%vgZm1FN^-9an`(^qb*b~_mM+axDT<gjN7-duoDUs=f|dZ?XN4JxWL4{hn{lY
znRyQ1f&T{kF!y}~)&mfK7=Q0k!R_$;Y5tGW`FVuI0qHm&f48yQi60YjAj)6Wb9J}B
z;{7ncwesUNgstU;-Svc7(*x)?^kHUtM?5yhk$WeID_Aof;htmSy74^s#ZTSOlcn@t
z#-+TR(s{45`ilPF`R!GeCLTWiHq);uzvcY}K8khM@;u{QZPoJ<z9gN$=c}H<c|zzb
z{4nPok^9i|61RhW5V<`)uhmk0-1AlYxzf-v&TC>1#9xZ@e&`>upA#o2f-ZZ%!oP@p
ztFo@%)B2LI;C|v9J^qr&3;0KKUW4<#*z@tvK<`HU!H(%I{*KU_viTn3rF9NcJJNme
z7fQ2!;X9#w&}-~0=wIP?;9H^J+$YjMLiLWnD};~Wo-X7F<`3(?@@19J`?<vZ+c{2j
zrg5L>PT%K|(6`~YKCvBubsBA=`U*zk(sTX>yBPOb5w|R0o_qZ!9=Dp;FYyhEC;2;%
z71H1A`|Qto^UuU-BrbY?O+7a=T_K(t>10v;pI=Z&yrb^YexKVJZK!n9{l~iPe_Hwd
zg@u{bg+rI)-ge?)jl8dNekH%8%BS?f^nkeA+|!2MpL=fm9*5cbdY=AmEaUVN!q#Vm
zS?f=0Z)lvc7qxu8yfBB#;a|i1s+&9C^bxr<Z$1$I7Cr$xQq}TZeQ!PA`Hqk{JIIIl
z?V&G3ZbyFNo<#io&{Lt$z)zfW_xKTTUJE-H>j*y`_A&HXoI~cEU8Ab@Lht+5LpO@b
zpROd#epWbJR!F?pvgbAN9J%)ly%F(0_+H|fp!Y}52z_mv&LCfn-Ty83b8|1fKlDDx
zd$UI>AHJG?MLs6}6>=E<UdYw(C+I`DuL(XIxu&;{-oyOPc)j4?#X2mmrE=;0?k6bC
zeY~aLX?}A5X6X6NeHpWDRKDr{#xJ$7w({Y7h{HSZ`p$VBl)TQ7e**KbRrU|lvFaYG
zZ+eIjeMNhBrQ`jC%oFrCBY$7X`+Mm5Q8%4{Z!SHl@2tEijOSE+w2%8Z6W{+HyF7k#
z+y_5>N6$}RcRh|rQva9I_`e1A7w`C9vZ?t>=)=(aEB6>hrXwTwTiNZeETnc0%>PfE
z-_N`K{%+{k(EQ%e{ZI>3u4;Y|I?DUnuBUE#%6oc?>ABG3K3Ps__8H=24?GVzmqVQT
ziN`rM|Hl5veFx}^8Snm~s=sD_du(|SzP9Xn0Nq3X0{_H0Zu}{bFVJs~pHuz#OG2N}
z&l67#y94)V4foe`>~90pBfb~ETjJ+ecTo9~=PP_e&HF#}x$APnZ>T(cEpd!nk@8vZ
zq00p|<xdY6Vh3cs5a*HjYn)eu-{U+j_8!vck%>D(+<o-C#1}~X-v0J_Kj%Y{H=sLJ
zugi+%pz6jd4?QV+pU>Hku;=rBW1kyjUBLeYrtieZEbi>@w_Jj}((%5@en6b^toZ}>
z75pnA>y@|{aqMyXIDb=g`}<$;cX(aEU-e8+#@_Eo&x#%tN5ZVnEmnQcV&OUE6K^K?
z(DcLcWh(a9B@SfX=V&MYP`Sj<H+&9>_$1ta)t+1JOiVY%^C%s=eZ(89na&m6Uhb(U
z9@otDq-c3=V0zu%T=k7i$GM*!KVkSZ_5=7=>TS)d=b_UT_(jvfhWGo4`N`fID$hOy
z|JU&MaW5SFFm#P}WxcQE%c>_b|I0X|A0r-N_7s)lzChw7qL+eyB912UeTe&k{Q&(B
zdht}wJ4f~RV`1rJA@4`OiGF)%eh$5Ks#i5%%D#>Lp7SB_tz&<8&-_03$l%vovfK~<
zOMUDs9q%Xb?XmgjuGcwwz3guK4&)@_X(P`N=LmZPd?x)w+&T1q@NpUIb<=&}0KEtL
z*)abDUou!-|EKc3*X_h~1Ud}gfqnyiv+nZ9Ti6S7raRo*1U-XpV;^9g;1i>7sy)oN
zZlpB*Mt?*1Xn)@GzHK>$dxBVB(R`|B<n_ck2-es1lkNx8jhg-Q8$PGlyG`^YzDt<B
zUpTtebmlT)$>&rG7b_jz=yHz;r=~{*^EpM!Im1`=f7$#I|4;2Nhg`_LS7rA*{3-kk
z{7kfhzGv)yL9d2An)_!)-e1`dsDHYI``z<*;QH!IDZk|XXY#n(-MT|qxm(EnUBvnB
zo6pO0?!n*7`S+>EXW;ivJdVv!?;{R)+uxm-zbJ2@|B+{*TY>jo?wQ2S7oMT=$Yq>^
zNaY>u2H#gX=o;rTMn}6ny9z_^qaWXQxt9#P1$r~~)4KQLs`rbOPn}=&4o&B|M|QlJ
z^3g}qZyD2d?hA(xMb8Iaf{qbC3cGc|>kYpd`T_q${GFgXtqar+?8x{Fx4*6Ycu!%@
zatilAVi!c88|<WV(81o0uGjq%nhzOzKMFj~#F0b(hhCJ;@1b|$z7*oyvrnK$hA(0~
z&?~SG_`l|Ml{WJCeNKqKHRlr1ub@X|KSxffo6l&Oui;)Z;w_ejUO#UN(LaZC>3t>h
zBU#I3E%Sr$MaWsjxAlBu4n2n)HM4w_`-Jkxmd7fNr^>o4SZ+(a9^oHyrki!2rz4(L
z-sh%>Gf?)rMbE_kI<@>0`2VTtNz;52@^S3>KQ?~{-wU5u@p+s2K;IesQP{di7`q?S
z`%HhY{M;47#+Aa*=h3<6EAsh3&ZYBS)+Ktx#OsB5(XqUd$|)7~?{r%s_g$ceU|wT~
ziA-nkkHIg5c*N)x>qn_R?pJN@uQd9Ok=I+s?+wfkBDXiQetr>Q-*kKm{cwL{*U5Pv
zmCbLL{C{M*AHJG6qr`h89z)agJ=FvFJ*hp{d=zqT)BT3rL_C<T=`HcV;77`qgRv{8
zbjkc8{RsVs|3L0;m_LV}z(1oegWke#lh1xzFy92d<=*e9*B$x+_!aE7=;yh&7JC5p
z9OPU0p4`S7FX&6Ew^&8_k@<i0Hy!tTXt{{{HVTV++!q#dUvOf%2>lD|s>^!1PwQo9
zekXiLY4-Ke(@M{*ziB+`{~Zr2^Ptjg_yp6x(0bnn`@Q$|p80R?JL0=*rVHHbSMl?)
z=`nUQ<O}?dxX%!M8hS6}FUF7ikH)6+#6Lj)lQDl7nm%_;f4MJd;P38SrSBy^MzDv{
zjs1k-Iqr{#g{_RnqwR5l&*Qz=Bd{B?uMfSRC*D^=(^2RFcCggWe!j=u>jpg&`hVs#
z`ibGPD$hEAU(Q>8FZ;dRyMR3gKC!sCo^QC{@}?i?_t7u*eZC((V(57^^uE+Ezf2t7
zzUL8fXD5C>^D(+KbUm^40noF0UhRVKLhk`TjGQ#tN#(lx2$3t%cMp&B_kBx<yf|J*
z>6-cOy7hbL^EeNTejI%m_UNYf6Z~$_v!myp?xOl*^Mj%H!>sqSq51FrdzxSDJ7vDd
z`$XCNG4?I&ZR~3$%fHC2+~?D@e2cz3F&$<7pwFI}Pa&?^&}qh@JyrV}&j^dq3(Gt0
zPw6{5=3AIgnPrrZd;>oLT`ZX%fCbY>?Dni{uxUCP`aK!Xw~E(kZUwK?vt)ma-;)1%
zp(gClFKm6Fb9vEMm2OXjUB}sOoTYk@TWZJZJCKum)-OdXt6Xrn-Zy>B_3Y;N%q5I|
zulF?^f43j{T;ThPkI;WnIG9)Y`CWw7yM?(>^%RKL=D4-x8<gL<Uf8%un0H*s-XhMw
zMfD8N5|(cgHhsTQ?bB+1*Krbum+QN*k0T$zucJTZei+URrGC&qRexdU!OtY|{(+p_
z_q@V>ST!G$n6HIj?pY2EOizgGjr__z-kodJ?$RZ~)_KC7<@}=g%7XdFmiNQ-9s|$k
z+B|AMb_&{!U6g)7pMl;Szl!n^dY*ZMzc>E6=trPu$W?9Ad&;-H?pZ%|^LOm0@P&Er
zgTr<8-jVebjg$5L-L>5xULWm)m8QSpTk&7TzX?Aa^b8Hl0kP=~`#0x~iAP?I)Q<Xc
z!kqb7^d1fKV|~jPoQo}?Z$K|`v)g}%kn{V<Ra5grvtR1}PE9ynN7z_QI9WtkTwNIL
z=>LxuPQBhMKT^6J8Q<2rD4t++oao|-URUpF9SwFCW_%A)=XS+iYP_JhOO-DPlNS|-
zySSv%t!IRV6}0}lSE-(G5xp-z7MAW8#*RzfKVRh<o9MaDntEUN1ix=Bzwfic{xZ&A
zUf2zU(Xztvn!=<aocvfgxXt;07v^3Uwv431x0K&B4*%iucM78mg^e?W#T$gRW!3Kb
zK-f7&-_zSr-&b**+|dH+@1EmUhKDF!?+df*sej6jn>YHJ#xHY&FtJ^8VE(3Nz6kk;
z{V(!<Qn&sqV?MD5U+sB0y;t?-9ua2EzqI{a$#x&;6Y^`p@+|SL%ZZ*3FA@^BwtuzK
z(5am57*+G1Rr71yH-aA+d?4}zd^q-1_|dxcGuZWruY=!Pv7mLE-V<Q{F<D#r+^@vB
zIL^`F|H*gtZ`HU|78gb@YP{l-(i5*Q^a4}l^^^4;{E_gt<-0gX1KnkR>YH!Eu7e$h
z_?q-zX-U<OeiFGBy<}@G{og}>WIhVL%*^u4;27`Qj<eR>Uh_B}Ykv365$1j%9GoKT
z-YBfSD;%w^=f+zK^P38jK-hjs<=WQ^b6)4Yos^Efe(Rr9y7i>!O#en>Us#w+|4+^o
z<_}W+<!_sg?C5p(jPYJ!W^rNpLzOSxujh+*sor=I;q)lQxvcIl?EXfWa39JSRIXZa
z`9p=RGlb=9gw02U(96~<O3$7aR&NuAzY-456J~!VEdExQc}zI<cNf-IyW=B-(eH%K
zsj!mQ_tgu++UJG+<%Q$*h0_!K|AOkb@iW5ulkT@?HP16c&GYFATF<jLg{)ina@O0(
z>$<Xl=3mA7MD%Nuf9ZMX)7W%r=6y1yccyz&$K!{N_5FMkJ*DLm^q?8@-}v7kAF(d5
zFXGplw_Y8-7{6HT`{;eKV-z;jcfseQALl-R(ee5|;=Uzir5kl&!QX@Y4SzoK_rwRO
z+|Yi{lRLdnY$VLD=5hI{(>0Axu(O^+p5|N)=bi9_t*)l_56qu(uLSlg=t#Dya@<pb
zUnb{iIgeGh+!UOo_fOwYdy2aXdjqwzxV|uZrRLZFYw!NQr>N>Ujt|;LR?!?Gk4u6~
z9<en*rla6`q?poR^@#4FkVOnuKwGUNL!z!<s__f5Y1UYon^uk?uqxzw)LbY%Q)<jd
zrKWRG*Qmo3R?8tgn_ps6$vQn>mmm5A`U!q{ocHX^?A-ah@8!<Dvoqa1wr?Z9<Edz`
zQN4SM=Usc3qkoK^fBgXrPsaAGnC``LjqS@@&>LdEl@DX`Q4CJO;#n9iLhDv6KZW*4
z>Q%Z7i`y`oL;Weos!vB#e@fFaRK4o2=kw-aSe(!Ht%uovWdf$xa=h_K47RB}dhU0$
zmDt{n-rwa|*3T|P|4~fTUPWrJDi`oQ*)o0aB^Xq3Ae%mM?>pEUmWOfN{<+w@84E4!
zs~rkE#GdR86L&{Y{(_J3c+OKWk~}DmBR_%}<W1w#<dc~PFypJ{ca&zH-;7&28fP){
z6182*N9DPhS1|LoX57u(mm5ze-_86<{&lvmtDn?dOPpPg`=66NL_Bz$<8Ch0@gIb~
zu5WWUQ@+^8>?SO9Fv+pLr~2I2dy#9S*?;Q{?45?iL(p%tUHNP*X&k^_!+yin=rl1H
z#-83c*qN^F^jy`v;%GF>n|iLFKY}>;6h=>KJ6&gVbiU2JfVp4G{O+uO3Fp_`UuW7o
z^E?A{Kf9T~H243Q-z%B>ZkjVFcY8kH@6V+?`E$vmcoBJ(yN5ipm3Jjw4|LSeDDEJy
z%P(SQD@Gl(_5XQ&0de&s=<HN|i?Dwqx;JBZFFG;CX8rdSk7PfUQP?;_`yY+9<Iq19
z^YbwMs+MoS@D+^rVr7VWR(V%(7rhAc7h?25biT>)SYxpL810F_LhZ~s7#1-&9jjVy
z+U2y#a@Vw1dG?nrMsF>e^X4C}@1H0?i8UQx{RZOV8npEH@!ueB+LSXs0WBAMMXa5J
z$qM;%Y)vO0YOi7U8S=y%CU0!Lzpb!~yt0SMv;FrqZYF=t^C8XiLihI{)bBCl!UN4)
znETA~Z?eCd`YWEsZOy!;x$hv+e2y6h%FbrHG~u`^x=sv!puD%Rb~)t;UZY&;)z~he
zuYPa+J<4BF`&(bg=k<rN`#ugz?5}bi*1v(duVF#s1-(i7d<Z*x*}iZju{#&db+D`V
zGSoD#S-VH=h<@kW(siVxex8|6v~_-6^()Q&aOOUbs>W9ek8-}u^O3_Av9EdAZkO2f
z+su59x!<Ft|3@tK)7;}(zke3TX`P|-J%Msrw$9rLoY&wA@~x+Q4Id$I>-S(+d7ax#
zoIQi?6Ii<!ovScDQ?creyN>!4&Ompk>g9cCU5VL3)yw%9R<W<oy*r4lhxGX{I=i&|
zQ1)LvQO?Bv`Iyba^jvugx}y}UJ+SX$f9YH-e@O9;J^y{bQhO6x>#({O-6t{XVmgxT
z{F&IkLHqd`M(<!y<okn_I-WNAd$4f~=QBA2qor6?d!MM^=kH;8L*rb|Z2qp!a<wbp
zMSnBqG+vY&PagCy#o{p5XOk!WKcU+sf5OG&Q#ytGa^F^-ttap7(`a|h^CislX7@ku
z<&XM2Mst5-^)h1fJEwxit<5-snTM@t9>>3v@9QkVa1sW)IiAh~7%srV5g7fF<4-iM
zpXz-zgF{$eeuZ-OHe$3Ivntxt(LWeVTR1<Bo3NngFMF?Z9-|Ey+<;}BXXi?tXZ5#}
zL)hL4(TvAsLmZd=JFGoOIg*Q2UR~ds`z|W0bbfC^^Sg0N<H#k=2bR=7EL_KaEX}_<
zml5X!tlp32KEBqA#Hs!c_O-<3{e_|WgVqBaZ=msv<ZqNKHx9dcFHq;V<YQ+kR>q>E
zd`>i;VER4TU&!<BOPG5WGqqcOleqI0tmrzS?-AST7X>4TtG`nHy93J$6rY67KGjpT
z5AjCgtf6|m467cd$71;(Y6ns*KaBQjv@X%|*%(gM@(JkV(H*CFGI}NHW3UGOOv_K;
z`<*Xg@Kekzm8XQ!?TVkrfzF3Dp7T=Iby(qi;_er)d?UIV_es?MH2u56KlwZx&)=~%
z3!5vkuj{Y;pNW%?Q4ea@qyGw4W~x3shJ&fpxBBB))3|i*S>@R*>V+Mnd4IThuU+sm
zd72$Xy)eIXGV|Ep7g=te3t{Hn_W!P=#^=37SkXMRxevpPYnpi@^IX}o#=*_~YxX+T
zpD$x{D(2K~<?rJ7<5Mu&Liwtn#oViue{d0Y^qlv>3eHn@xX#-q&ZDRET9{9qou~7>
z46UZ@VSX;#rzut!@jazCv9I^V*hg`E_1n-q@35fqG^&(qpmN&FiGu~0PRGV5O!VHS
zcpdvIEyteDL;MEi@9X{Pc7@n|kK?M{jgINxZRYrcvvIJU@<mr+JQlmplZTD3V{0C!
zQ{<6o@;W|=xHu8bypFB^cf&C(&kn`vKI%iP_N=g-xbz&_8!`87Y^opS&nFIwSR0Gk
z+tk-|Gn(r-uS^^rkKw!2`}TG$KciUJO~D3Y`zQK*6INfupeNNos!n6S-ZFjf-HNxO
zX+OH-I8HN;(>RYfQNJZN<-3LD=DIciJ>vHFu`6?T6T3P;$?e2FZJ()~_v%`2C3;t)
z`MyZkX+eYKX8&gV+xZR4i*KT7zmoI#J4UO}%+K`?B7fSmG5Z!quVSM4#bi18*WQGk
z5voVC&}(4jIrR5oZz}oSya+>$zYOkI-fu?x1$4G4ehIU!*m)XD>#@>6dkGe&p?{Ek
zf$uNhDd%Bb^AW)g%HceS#k$Hh2M3d|HwL>ym^&EDqp)!t+B2}VMDd-Ne-3l|u&91l
z;R=o?_%X&Qx_hxdhH^9~qBR*CCt~YpEq{mg(`}gPxzX_oV)I`4bfDvS66-55{x~{)
z{@&fTT#5E4(9t+*<@e-I@Hje}53;T%b{AuD4kj}(KOOC<7@v&&6LD}H){jxF_A1E{
z`y(*_4tZ@WzdO5$+pl5e4_H=z%U68}6P9;>fo6Vd@C0$tMl(L#T(9-lV5ae$#*c_o
z^&3K6H}-X%X*Ac9nLZzA{rHD$-`0N0_Yp_`qoug1^*h>6PyNF3UD_^`YERm$h|RcF
z`5NNZa%`yolV7a$F2JtZH+MF1LH*45bmEf6#fmPmH$~e`!nUlL<yx;hjnBgwXnh9D
z>W{e#iR(2j*YW086FVxe_Ykr56c$sAcVcrd`lHB`RQY7?Pbi$Fywd-R?MsQv%3DkA
zqOW}J>%If`A=Y!1?|qGHHJ@d9{RIq7|Nmvh+cDXJ-JRI`E2g{A)%;=h7ICI|-Qaz#
zKScejAC7}D7#)i}%`XO%iSyI2ZR+hT;=blh{CULPg;=;48@i5hYsCI#=ty&2om<NC
z+UK!&0b1I>btdsZ<9-G8i@kB$?g-5Pi}KZ9M{_@m|7+s(X{<aVBP{9fQ@n*Ze+|Z$
nV@~Z)?Q{BE<C39A9Gr%|n0z_lf%9Pf=ih-mIFJYbuRQoSR-U=a

literal 0
HcmV?d00001


From b8d43a92491e64fd20e4cbedd240cf6326b694df Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Fri, 25 Aug 2017 22:04:08 +0530
Subject: [PATCH 29/35] Treat one as slightly less than one

---
 lib/matplotlib/colors.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 6e058a89fcb6..59cc9aac240d 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -474,6 +474,9 @@ def __call__(self, X, alpha=None, bytes=False):
         else:
             vtype = 'array'
             if isinstance(self, BivariateColormap):
+                vals = np.array([1, 0], dtype=X.dtype)
+                almost_one = np.nextafter(*vals)
+                np.copyto(X, almost_one, where=X == 1.0)
                 X[0] = X[0] * 256
                 X[1] = X[1] * 256
                 X = X.astype(int)
@@ -482,7 +485,6 @@ def __call__(self, X, alpha=None, bytes=False):
             mask_bad = xma.mask              # Mask will be used below.
             xa = xma.filled()                # Fill to avoid infs, etc.
             del xma
-
         # Calculations with native byteorder are faster, and avoid a
         # bug that otherwise can occur with putmask when the last
         # argument is a numpy scalar.

From 7681d146ea1e653bdc41ac90ec99181eceae154f Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Sat, 26 Aug 2017 02:38:41 +0530
Subject: [PATCH 30/35] Change conditions for bivar

---
 lib/matplotlib/axes/_axes.py | 45 +++++++++++++++++++++++++-----------
 1 file changed, 31 insertions(+), 14 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 8270512bf1e0..5b3b638df82a 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5150,6 +5150,13 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
                    "'mcolors.BivariateNorm'")
             raise ValueError(msg)
 
+        is_bivari = (X.ndim == 3 or X.shape[0] == 2)
+        if is_bivari:
+            if cmap is None:
+                cmap = mcolors.BivariateColormap()
+            if norm is None:
+                norm = mcolors.BivariateNorm()
+
         if aspect is None:
             aspect = rcParams['image.aspect']
         self.set_aspect(aspect)
@@ -5194,17 +5201,11 @@ def _pcolorargs(funcname, *args, **kw):
         allmatch = kw.pop("allmatch", False)
         norm = kw.pop("norm", None)
         cmap = kw.pop("cmap", None)
-        alpha = kw.pop("alpha", 1)
 
         if len(args) == 1:
             C = np.asanyarray(args[0])
-            is_bivari = (isinstance(norm, mcolors.BivariateNorm) or
-                         isinstance(cmap, mcolors.BivariateColormap))
-            if (C.ndim == 3 and is_bivari):
-                if cmap is None:
-                    cmap = mcolors.BivariateColormap()
-                if norm is None:
-                    norm = mcolors.BivariateNorm()
+            is_bivari = (C.ndim == 3 or C.shape[0] == 2)
+            if is_bivari:
                 numRows, numCols = C.shape[1:]
             else:
                 numRows, numCols = C.shape
@@ -5218,9 +5219,8 @@ def _pcolorargs(funcname, *args, **kw):
 
         if len(args) == 3:
             X, Y, C = [np.asanyarray(a) for a in args]
-            is_bivari = (isinstance(norm, mcolors.BivariateNorm) or
-                         isinstance(cmap, mcolors.BivariateColormap))
-            if (C.ndim == 3 and is_bivari):
+            is_bivari = (C.ndim == 3 or C.shape[0] == 2)
+            if is_bivari:
                 if cmap is None:
                     cmap = mcolors.BivariateColormap()
                 if norm is None:
@@ -5413,6 +5413,13 @@ def pcolor(self, *args, **kwargs):
         X, Y, C = self._pcolorargs('pcolor', *args, **kw)
         Ny, Nx = X.shape
 
+        is_bivari = (C.ndim == 3 or C.shape[0] == 2)
+        if is_bivari:
+            if cmap is None:
+                cmap = mcolors.BivariateColormap()
+            if norm is None:
+                norm = mcolors.BivariateNorm()
+
         # unit conversion allows e.g. datetime objects as axis values
         self._process_unit_info(xdata=X, ydata=Y, kwargs=kwargs)
         X = self.convert_xunits(X)
@@ -5630,6 +5637,13 @@ def pcolormesh(self, *args, **kwargs):
         X, Y, C = self._pcolorargs('pcolormesh', *args, **kw)
         Ny, Nx = X.shape
 
+        is_bivari = (C.ndim == 3 or C.shape[0] == 2)
+        if is_bivari:
+            if cmap is None:
+                cmap = mcolors.BivariateColormap()
+            if norm is None:
+                norm = mcolors.BivariateNorm()
+
         # unit conversion allows e.g. datetime objects as axis values
         self._process_unit_info(xdata=X, ydata=Y, kwargs=kwargs)
         X = self.convert_xunits(X)
@@ -5783,9 +5797,12 @@ def pcolorfast(self, *args, **kwargs):
 
         C = np.asarray(args[-1])
 
-        is_bivari = (isinstance(norm, mcolors.BivariateNorm) or
-                     isinstance(cmap, mcolors.BivariateColormap))
-        if (C.ndim == 3 and is_bivari):
+        is_bivari = (C.ndim == 3 or C.shape[0] == 2)
+        if is_bivari:
+            if cmap is None:
+                cmap = mcolors.BivariateColormap()
+            if norm is None:
+                norm = mcolors.BivariateNorm()
             nr, nc = C.shape[1:]
         else:
             nr, nc = C.shape

From 59f56af84f9b019ddcd3a6a06b35aa9c6521c548 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Sat, 26 Aug 2017 02:39:28 +0530
Subject: [PATCH 31/35] Add image comparison test for bivariate

---
 lib/matplotlib/axes/_axes.py                  |   3 +-
 .../test_axes/bivar_imshow.png                | Bin 0 -> 87855 bytes
 .../test_axes/bivar_pcolor.png                | Bin 0 -> 50734 bytes
 .../test_axes/bivar_pcolorfast.png            | Bin 0 -> 49080 bytes
 .../test_axes/bivar_pcolormesh.png            | Bin 0 -> 50734 bytes
 lib/matplotlib/tests/test_axes.py             |  28 ++++++++++++++++++
 6 files changed, 30 insertions(+), 1 deletion(-)
 create mode 100644 lib/matplotlib/tests/baseline_images/test_axes/bivar_imshow.png
 create mode 100644 lib/matplotlib/tests/baseline_images/test_axes/bivar_pcolor.png
 create mode 100644 lib/matplotlib/tests/baseline_images/test_axes/bivar_pcolorfast.png
 create mode 100644 lib/matplotlib/tests/baseline_images/test_axes/bivar_pcolormesh.png

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 5b3b638df82a..3bcc8f55d2e9 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5150,7 +5150,8 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
                    "'mcolors.BivariateNorm'")
             raise ValueError(msg)
 
-        is_bivari = (X.ndim == 3 or X.shape[0] == 2)
+        temp = np.asarray(X)
+        is_bivari = (temp.ndim == 3 or temp.shape[0] == 2)
         if is_bivari:
             if cmap is None:
                 cmap = mcolors.BivariateColormap()
diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bivar_imshow.png b/lib/matplotlib/tests/baseline_images/test_axes/bivar_imshow.png
new file mode 100644
index 0000000000000000000000000000000000000000..757a1929ec6600aba50de4aa7f2c29035435691f
GIT binary patch
literal 87855
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
D_=3-9

literal 0
HcmV?d00001

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bivar_pcolor.png b/lib/matplotlib/tests/baseline_images/test_axes/bivar_pcolor.png
new file mode 100644
index 0000000000000000000000000000000000000000..051a32c265d4b4382daf255195014d81cfee5e18
GIT binary patch
literal 50734
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
WxgM8U#hb_tLtoa{C{(-t@IL^xoI0ui

literal 0
HcmV?d00001

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bivar_pcolorfast.png b/lib/matplotlib/tests/baseline_images/test_axes/bivar_pcolorfast.png
new file mode 100644
index 0000000000000000000000000000000000000000..b060fecd5d5f7e7c64fd72962d0694f9c2ebb783
GIT binary patch
literal 49080
zcmeFZcUY5Yx9^Vy8AU}w0Y!=wk#3<#&8Q$vM0y9MNDW8{o#5aIB0>ZNloq9jKp;Tq
zWf<uQkrD!gqO?E?NJ)S|;5?Z<@80iw?Q_n4&wsx^eseijL`Zn@-0NQVTA%NCCI0av
z-7}{ypJHQUJEO0sZOX=WOoWZ?sP!)=fPcvhj(H9|91pywZ~hDLU*s>YuYs>mKG(Ae
zWMkuc%KHCE38>f;_{YaVI@UpEe$RqJo(8zFfu9CF_wftz@pKjmb_)pf^z#+DC4WQy
zmi%+Sz#v8CJ9p$=-GXn(xZieGRCRWBkrnX>3VN=lpzvSMllKd7SMa};uFJ+I!lti%
z*E}?vG9B?D+u}Fkx|0KgJLR3sNxt@yJL2|de(|+Gar*iX-sZAX$9@xW$#vrm4tsV1
z-+!*5#O3>sODC2--W(EqYajG`@)MzaiuBR=9v$na%17QdXgKqCh@U&E&oH&v)5Y7-
z)E$Tg>MM^RBTx|5%vg9vZ7mENF=OU;#{t*YXCa;T26&%rpH6PvpFYC+TeO<>3)Z8@
zWnK~1V`eP-FTlf#qNhiW0*{|O|Nn3QfAzLx&OHucgJh}rjUD6C_~bcK<T+Yma(`No
z?GL+egE{IL|M>?4A8+fXN*W81R@r_%#w+rrhxL<Tn@eXPDr{_Gf8>PBAQI#oJxZF6
zu${4faawGo$S763W&5}%W&AU>zjcGsX4oxsd$eUd<W5_i^59x|;wBj#)wG2yCLI>B
z{qg+EQCI$6tzf0#GDYbAxsYeVo}QN)h}Zm~evs^0I{_l!Tz)fKtjxhLg1}Aub)=Gw
z6?5MdWq)PeQ^hl!=M-^-8Rb#U@w)$f{bMicP8|Fa#qR}9n<PkB__#=z-mERh(+ynh
zK23!LVu;%dq4C67|L37!p~8_0i*%Fe_aTDf2y-S(lRxA8t`<t4r1pOMNs>9kL~;qt
zQ`na@ZC-iz>*5^2n}QeKg;FxW*u{Kf8LQ>|#L@LK(p$01dl?iMH$jYe*@r~NYcW5*
zj>73{fS?A#5L4<T-D8`FctIdRQ?sq?Lv|6pqu~BL!8<F`PSv(-Eu;R>k};VZ&ZG}L
zD0NT}UiYP126K6Ur=v94_`RBs{abrTuYK|um*&<x=pJGA8vL+BQtPw-e3yPoV^b4k
zdpd+1FPZx|BBE(&Fb8R7tch{z_N>s`qdj^auhSly`Ov9XFZb)5r)=)=`9;$TW&}tW
zL8ckTH@0e~-!s#f=qy->5!PJPHcc)Tcazc!Gk#!DAik*SAT?{P5~kraLv+4K>iljF
zZu2>vazvFb46P54^(?Ds4V%bS*lA$!U%cG^Dt%{@-EdLrf*6Fln+M)jvk_>ATGGj6
z@B*^Ce_~p`z6dIm97we~Wl1@@>pfTz*XHQF=u1eK4pH*m1|O&)cW!c55M~_w-ucOL
z1h#i6^JAS|RQV>Z6;|jw;jezQOv^#Ss}n!N412p!+?R}JvE&C8_dzHpiGXPtM1%``
z{rAMIU)qn}m_oBn9Ghi~)dk@lLUiCV7fvyL#(`w@Nz2RMvQ-0X0u~JhGL;PN>U?nn
zDzjy;IQdA8WR&-_3?S}aJbeXwLj7$mlBiB1kxmI!w9qpjz=X<g58k=Yapn07@s%zC
zztJyTpt8NyCS#;!`EaI^cTnd=t7Qhc0-tKErP|@n3g6R$ydn`Ia4gbV_5{qWKYa!G
zO{0Ywj<(3U&~@jW$c<jLwdPGPf^Yqg6PVgsuig}i``>`0hV4n{lOwl&t(%25U3>W9
z@!k$D_KZM{=g75zTut>7m8X9mAIMfUld(cwdE?6pn=eN>-yIpReEL!-Y~j4a^LBPG
zZ|_v`a;G-O6h-i4O)LZ0tVm5R;3xN`oR8dMn?0b{Ss=`}5XMoZwctHEHKpLDOPAuP
zuzGM=V`Jm!(9lqg)?Y7tQp!34VTxE*pWRJLQX^f@37w0_P&=Km@6rttFJ(;BmObio
zF*Yoh`%xRxT24H#Eq~2fKqk3L*EjsQtHk;0EGnPI+TQMGG3GDax2e0$x*N7RwjeWX
zMDw!(;i!T^`V~TdvIo|D%ePW9;hmAr2rsZ<+=M@9?<1YhH^dWN{0mdeWfjMay0RZQ
zo4BmkrI>ppWF$~EL3R%&lx6BD`1)x$Hp0PMW!85weR{hE>+xf>Nc*cNiu-`#VCn3L
zryFXog?~k5$mIMm)|V!%NgFuMcp6bk4{E>;$wUc6zq3mdvRf*w!)H!O=(IKDtEQTb
z79S<^c%W+#tr*L$u!o_mzU$l$UkF&pG<Y+^@p4ZmB##0qb-B>76yAY$fSWEbg7%b!
z_Z-%#Xr{)Dl@Lv!0gsx!UVfN!G{@oSi>Ha~J&ufBY&0rSK!pTE&goj?Ohx^a8VGqT
zHmcTVA`jTYh{x9zHHeSYEHgD)@m&Xzk|)@{8~3Smk;C*#nd<0W3(s9_Y?&e3H%YA+
zOhzk{>W6%MeR(cH;cPAT!_E7<k&Z~K3g2;e8VRRHD#_2p>9E3R{OOS@zFNOoRP<h5
z^vFl|Tm+ESZ-n~p@2mq6o1U)Vgc=-VM9_>u%$l)syW+q>)#8b1cHpV8XMoWCu{V3z
z8cZ2KAGsaZw3O-nR|vvEP72LGW1zeJPNWn=`Jsj0RLJgPhDu#E@U%Z}{CU(>VG6oO
z&Aj99{8Q(p?_jp7ZF4BvvdsGP%1AMpxfb1~rlwZo+<D3<`wqId<*#4H1*CC>GFwb3
zR*jQa_FHq<=GOiu7TMC`Fj8!6C4Xsp*sxP*qDWSvFU2ONqhxhD<K=Orc6hq50vU1G
z5ZONR$tS{2+_TqM=?+;d<;}hy^<@=PSNw^rUX4^SceQAu75BQ0Dkzrg9_`N1?=s$2
zq_k0<OMJq6pU!|BwRVQSJ$Rh7CB<j|hqh`ucUt|qyO%#&NLdkN?81{Z;={8sEzwx)
zzBM_i@akgonWp;|rOeYsWyM0YwBYx8g?$o^ToYG*HoV&m`n=jfM>&Ed7G+ftDIQ`n
zdtul8A013$9SMaU-p$UNdCvG2d!IYn-*N)xY~3|ZqUI1$>CY@`RNqw${+2iJD!t>%
z&n;P<Tk0{Jb?c|QN*Xo!jSW{fJlCXxCc<`WzeC9Lb1T+3S0qY>Oi**G+o%l>!+Vcm
z%Y3N85gQhw?Khg9YejocQ;cOr*iK*N71{e%Vv?^Ixb*e&Dyzc1;q&vnEbz!?^yTPr
z;NgFF&i?i7`=`d9zpvKy<JDhDE^$MW(ODQ7pFMV|idv_ure{;^G)t?jLcFPN1n%`p
zgN^~-st=Re=4EwO@g0=#{b#*mvOJ5jxp!WB)0T&|w|u~M(k2rww>0l5d*=)5e_hl&
z?kjaZ<4VWDgE?1Dp{rSqXSHf4uzJ5&iucZ0a`M*ME|;vjNA(bP`E)0Klya=^n%B52
z@SwXUFdNGw0kXbUKa~0(brNV{@VXxSlh>u-<H=uni;-v5bFn!jx@@{dN+0jQBzST7
zk&G2NL$eAmW=;KeSJp?#R@v`-H8kgqke~N_wgs1SC{?48dJ?uXuvCndY#S5$Vpj`&
zkE9tw!5a7Qg9N8znE6nOAIK4j>G{#K?|a=Yrwks}b|}88Q`L~FbDjg;tre^6WT5Og
zaV}`wIw;H`OZV<pApJ6Is?KbEj_rp1&$ItliF}pao1e6r-q={+Yj|%3b**EkHbo*Y
z^zys@lxPkA>+V+5Bi=DooAzO+m;yQDhBqBg!eZWLaF(wJv}R_TRn`>n8jkeZWj^{=
z?A7-$L!vW?T9TpeSVv9Q8nr1mt7S^Z-!vCzm-+Y%r#qJc^MB{@3=)-X*aD@mCKXSI
zN}GJPMJ(%^<r*w{T573OT@X}%ApHVK$tg|Bhxre}p5hy=jm}E%D#POtH_H@#Pl==S
zgCA)bzx+L4n`fxsmw2Jz*RZ3w@mygYxG|!pSWh)A=3>{A2{h7$Sdko4czaP}QD#GJ
zgG}Cj?@QLLYiq57hF|`Oz2By?qbWgH-M*pFW~soj;$%Ze4ov?uB32T5QP+x`l(gNQ
zS{o_vzHMrJP%1vW5EE2J@;@~eM`xD9dB}^ky_W8VSZq=`4eU@c);}H0B{M-rUePy_
zai8z4;5~9WaH@zE%&g+^ub}>)V*d2nji5i0hkxUUOD?jhDeHb3e!9rrb4d<WWt|u=
zYrS8j`!4)KS$E_!bf!@MiW{s@R(DRCxx1=eQ>>f1gj`P+a+rM9KTp3|8x;d-yWGB#
zoGC~kFHSvErwdcZam)Q8i=$o2dNDM;AI|g2I?g^3YVL$;{u%8KpL2fR_$qVHsU_lN
z?apvnAB-?N@^MW-LK^27@m{d5UWY<NRT<1dnJ;QEb{9o+M%k(mf$FFg;?t5{cYR6r
z9xkqaIk`e><{-T1l$Q0u<obG9N8NVsT7eB*R!Dir2&OBhoA)vh@tSDv_*~e6sgY+S
zJ_zD9lEGC#el~8SH^|?Ht<UB?FQ5JntsCgW@lX0D;N`<Wa?h;iDWN!?(|K`b{#a!v
z=`*k1={m^-DA2-|H|so-n=?%nl6vQYLMCrg?E97FC1zXm{q2-vcV`V5Va<nZH?I7f
zTi_o}<m(@Tu|<);s=3CRua6VFCh`?tUNN7)nQP<YbI!yI8xdI~Tw$N6CugJK)$1(U
zRAx^P{pxkvl{ZI9KZh4F@xv{lpNe`A5p3He^uwmoW2|;8ya99B-KJ(|V2C$Wm4OKl
z``S<2KzTKcIENbwUG+YX7Fw~L<)5g{Qrp!N_t4@VAw;wpRKO9$!X3=kj$;L-+ZSE(
zZEOe!=DlQFgWmR-c;gTkFqW%(#7@I2fr_tkny<B<^2J7vuUEZxhou?meC?{;7PG`V
z3H08XvW`Ie*AjUYa64!olY!oVGB~2Ob4O`2n95k9*z%TA7d0<WiiNcZ1k1@xOl@1+
z!(P<7>_9Q0cC*-|j5;VUy}Ae)SUQ(H3^n4u`DH?bb1sMnO}OjhPZP34M_8Zxjk0}A
zc$3r+{?KpGF%Y4eixF%BLCTYZ4CjN{_~k=6{;!GtAA90mjM9}wiHqS9Ru(+Y8k!P%
zS?GX?JX6`JLgTw{9@9XPF&C&J<w9f^DcLlyaP!XLYG)~%lu_`aETrGeD<IeR_9Wvb
z3Y{(NvS(xaXdO)3fUZ@|TkzCN`;FH1npJA_c5$PnaRphj>km>4Ea~ECkt4<7(;DdR
zRJg{G>w0^=OTU6rDw>ULO09eMeDPn2>BS}(i|%S%_xNy_YZS^FWQaRRd#Uf*X+2@q
zq>+5xWN^vm-SPK&rKKGy9s8m2e8!4TWlU5u^zQWaAr=}$Akz4HRsKIUcP^Tsgr#iS
z>&^Gp^gR*&CtVTd@$au2zkidi&duB!psOKTx-=z#r>^yS*@&hOn1S%0t|*Rgis=<q
z3w(xEOFqUGCBRcP;fD6xK0@q>xK^hIG|DwldLt8AfD&Xo&GT<IZ~x#U&Y^LiBlY_v
zHv(S<b!s2?^a+%1#E~tX{gdK7u=Z#)${fZyXyfDS8`)z2^SaZl0ykAkhGYG+5Zp$v
z*q5+$zVYr>VP`0Bwe@_jC4RCeB4UhaYwji8rF8yk7HuMg)7jQ#s7aoNjM174iz<s*
z+8+;=<HQBXbK|A;B|wrOyn%}Y-?UKt4XPZkewH5N%%IZisYIIO`s7KHc9+H-N0L2|
zmO7wXSdH2{3D0QWW<T-vqGR>JQ=uU#{?i!fH5BAAJ?woNk4ak?ynpNgeR3OZ{D8ww
zAdTdWaXtU7u*ci*lv7|KMeE7>sKHzJb|)?ycne&JBj-(jqWz2SN~=VoOBRL*4iiA^
z%#8aZ!3#VU5&uuodOB^>wBef!?V60ZD7e{I)JMWr<>HC=;EIl6Thp|Q#zg<S_2vy|
zO0U7)%jTk{*VXZn(l(OGxoK&Jh}R;1dBPB{W^6L&4{%{ha*SfOUS3LFR-M&zc_qj5
z?ISbAvNx|M=kfdw56gR;?woG0_~!k~&kqaVbgKOj(2VaVcMQ&UOC|^KUetD?wb)UV
z-WhAG5jY!ux~~ya+vG~MO!VJIsX|Z_>yh@9qs83lDtZbv9M5R}>EF;3y}-TlM1mYQ
zt5p^7yicok%n{CfIOT2TBD6TaC^)cs#!<x|o$nc&+?uu*$~^YR<9We<>-_r1RzCNo
zDXwp^idEdl2}7-$f~mvmGwWw_AY(RajOBc9$o~Nr%yyTQNIIjrT|F(~h8=g66~8rQ
z_r2b_ZlOT@6RvqU1e@0(Es0SLp8oEpI*bj-qwL`(4X=nTKPyOdmGy0oXFw|X2Mk0}
zxA|Y{W&3*hY$o%Mnb$o31grl(y1OVg|MAV15k24bY+e%2O%#Tl@#cn6&3R2<QTm;X
z`m^Z9H0|R7ax=<R5o=86xXm#5<=V&vNQ!ZG9NbG5UbjG8z{}FqN`D6x{>%=D=cyRz
z?VuSBuIn`+Tsq`!p0`y7^!80#4ssWot^7b=pZa7RpW3H``sivh7r)tGxCFM8JRg-4
z34SjCYp=L)q}iepzylSnjM72PZF^1Nwx}(<yRYawbw|#j(Hz7Wf^B`f&!wLNv?_}3
zgICJ!8%(R84GaT45@d5g#rwyfuNqey$+2`+ZhdjJ>!>T2edv!@;q(c2TD~w-&mA6B
zD~_nHHp6P|`IHYPs?3zImSTH0x@}N>O+$Y;&B_r$u4r>4=0>0%X{>i#T~P;K2{<fc
z!6423pI;cg#?U+g-}=wBJMRj{#w=U5Th_{%+jE@>kd0nRJg;y{(3dkRB^Zo_VY;lR
z7n}txe#EltftcSpK#%1!MmqVN%5v00NV`NhUifgQ`_te*A%t<Q|3U~pe-n>5){`0d
zwy~#if<;ZMjfQ5$k8p1<-Bxt#yO0w+=^4J>$tR&t##dyB8)Ye%KRpB}A}*H$xatG*
zbrlij771BF;)>pRiE3E7JRLM*6h6B*Q>-f-We(q)A_gsebSDA*=MbGrkkEJOdh0nJ
zO&Lc6bj4IxH*RurGB~2lO+`OHT*-gmX85E#^;(*A@{9Ks>8bHH^1~0##V)L9IO0a0
zJIBlCDyJGm^qIatwNC7hKiGyeyYidT>;vK#K3Y2{5INTy?>ZZacglvHo?Tthk19xJ
zC-NCq8x*_@3wT7SI~Vc3@){yVDdmIM(EHEdUs&RRg3QAp2+_rp&E1XCgd2!&xagie
zpADVEt6<($bf^-`;df0fAx$cFdJ^w!8m1n<Gl(CpkCaX7Cq8p-&ad!~)=JL3m{r@*
zp<1|PuPl!~t|0ZWbz{9RlODa$7cUSq>+PjZPnO2pNemwzOrgkV&sw>(*B3t?Gp=}-
z%ka1MBhsgXF0jQO;T2)N#}YB#c=_qj`9wy=A+60IWo9#X+oL;4u#rJRVt}UkVuI!u
z8|k#mbZo5~B$$|QWf&)ffHLzr*mg!Be@<v}ZO>g^DcX!H0<nD)jy#TpUo*~?)n@=v
z!S8eUElx{ZKO9&JMbBYzeO5FJ&}XaM61oxvitl~?_VWs`nm>zUfJkt2Qv5)sss843
z*92j%=+bq1aWkykv8D0pAr5IpF3C@t+!p++bH52(b<k=9(ZH0-$#I)YYv+^rO8tD&
z$j<t_lJ}UboKvfPPEHO+?VkyQC-bkTiUCjEYUhGJF3t{k)4J2CKw52D8}p0avzzws
z7PPH@{uv-nC6jY=nck?OBBLzD=!3|XpMP>P78RlqhVl*C0InWe%y82B8@9;-#Nzu*
z#2PM|VSK31=Ma=U!(0s^vls>NdVKpw7%c7wfVXmM^gVzp-~qY;g#-n8biTO=(2BWp
ztX;%*qlU#;S(J~3EPzl4;@n7W`P0jw<<D`-qjr@~ep?#IDkj3C9jR1mrdCw=m)RtW
zrH-kppw*>miSw6ifF3svtLtq0GRS~)+n{rFEGZ+?CQ5sxNHpkWDf+qzNL#c^>0Re&
zc($*oR!zk()8<#apD)YORfe`*UBR-Gx4G-G%Cg?X80C1E$6RDGY$sfFt3NCl$O_el
zfcg>%?_VdLIf1^gI=i=f&r8->av5C}4;1O3zNoLCXT0uzpU+vg)4IhG5YKe>|2E?|
zw<5ycbVXp(+!7)kt|BA3$`RG9k?Q~LZiK^_W3WOM-fN;y=nDZ%#VlRUq(;b=@i$Yb
zyH6r0jp2iOq}D5h+(uo(k(blbKaBnAQeLmKzxWXY0IfSfz6|QQ8b_%e{2MV`qp^D3
zQ19<z*1+TcEDv2Mds_1N{TsQKxd$$hyUYGn=uj)z$A=y6OQPTcQ6;nUr9)s=LF7tb
z<W4RTQu_Gj3JP51Z>Zzhm7<`zF`DnbIfJ#P_&Ft4tjibZ<Y}74y>|3Yee;ZVXWAMl
zkbR}A##}<HdnQ*IwWgwU6<#wk{%e0j50o7?lZZiv+CM*cKKo4;Rg6B~DH_poC0n;S
z-a|3KX{fJ-V7ag#)2`RS>%M4yyryliFIhQe{gKXn-L6mXUPI(VY*hnbUY^zRHRGGg
zL=9<;rt}$_>0Gw6=O67-5jDP|x%J!=yrUM85$57^wj`Rs7Z1nh7@;=X<2SzgXR*NQ
zKMNbIoAuv#Ou>^g_jUB;-f$EyaHGu|%paOA?3xSQ4L4M>k<e4v*t%@^Djwy`<8O@E
z`fMBU*coKJ6HmK+#}Sl{8wx^bhZ~hOh=dkZXlEUauFvcAA)wb%UyH^W6$-LXFN<B0
z`Y4pf6>ShzoVLg<rF|eAhD;sM;S%4_F8r<*HhU_$HEi+VD^81H6aV&=X}4a%%SC5C
zxn!S<4{>^vsfW6S75E1f+9=Zg=Ur^DVL=)z@nvvoS*F|KXt8N^`2O;8O%Oqr9eM5}
z*;KQ=l=wmu6k|rJVw!r|;{sRc+H!tk{tn)s&Et<FKV9+6OZi}o&_+(~?0J7`OpG2s
zaysPyv7#Pk#C~>u<kd@i6JOSKYl#P)-=KHJ^|93X3A=dhM27F(Qy$W&+f^>lPj~jq
zlXcJOe7sX^Dr-4f%O3w(i0g9vsR4;D9mIh<{xfWRekRN1JQ6)_FQv6~*AB5fG5-A;
zBmIr~;N+krU8Y$6S%bfsbZi}O%cR5X649il$#kZ#p{%tt|HRE^=nu^eMc(sMFmeV?
zO1D;j<)&<RZLw%>)LCuOLQT>bAyKD?5h)$|I|{u0VX~~nK)OnWJ5`SM202(O;p`F^
z%&da$&}gdPz|`QiDrPBUvI|#tk!l-}U0p~SgHicztWWmpqP(SUI>lJe_O#Tv5*k~w
z#}#BU_HNSAszf5ZGoMck-OF|(``>K4S>#E2DZ=#OMzX6Um&$rjmi<*nls30zU$WwL
zsoYbk2KOgZ3%%bpr<U*-ZuCkpuGAzKYKL*Zt;^C|(=YVL<!&#0(sMRa{9*8eb~5&Q
z6&$W7pZxYc^_+OF#BjBJ`5{6v$NZEz##l9hXCut|ZGpms?_C4q8+FaTN@q*9VsQYf
zveU))gI&s#$4JKT$MGjA@m4mOCb9!QA&cWzW2o`yfu&!iO{Do5BF@Oh0j$`Dt?zZK
z=ydMX#&;j!m<wg2H=TRkO52i5PX^qz&Bex%AY9y7TMCF?*XU;pM+WA51Qtwp4G=AF
z-pXx%L0I2F;2+R$E5W(9lYOp4g`eoPnu(ot0y68LoEO*Jsm-F>bG)XNY^MYNAES`f
z*U_65)n;XemADfGw7*`fx+jx-y{}o9&fp#;AfM?M&4FbQ%@cYTJXE>krS;SFnqAMa
zQxZcj_)?z7>kXLidrFupd8lwBGr6y)a}EB(3(z4UnWtYJI&z@B%uwn@`QIo*cnc!9
zvjcA(o9M%-h4pjMJVtoiT(sxnHDk;XyEcjU<X~0IsMF=i_ljxxm%j)kd|Zv9_`-4r
z;-cP%>wKl(tV?Mt)Ym>s6jfg^9jZa|KV37HR-1Iv#WA#uUHt!S5$GiycUeC6ebHLG
z43k#Zc$ZSqIWx8@;fP<;Q5IGM=cd(KaJdgPQ+X!{la>l=TM<TMMsQ=A^Tv!-g5=q%
zit<vY*Lto2bvbaXew#akE<2`jF;UQdyGQBdQUGQuz43tU#>0OzNdK7)(Pi{p-n8Ut
zMldOI7uPb=G@(^bOp=65R&EwfeEr4LO3Wn9RP(_toQZML)(5P}hGKxTP#wwtk2GsV
z&v$n-O9Unql1naiZChR@hi>_vOU$+&wi2CBG3+RRkZ(Fa5ZhfD;FBAA+C$>v)vQi-
zyXia&4-6GrIsrL@!U#_}M^!K5rb5YBYh=?1X%f2YCGLm9(W_6Ah{6x!NIVT4B9?%B
zYSHVR`9>*8DV=}q*Vgr2kysV(78zW(#+~f#iToNd6^>bK1qAiY8lP}iyG~a(Vj-kJ
z6C?>+qlG?)B@Zl(U03h&fYo4B=kWE&%SR|K$;R3n;W?}0>~A{H$p{^z-t1WHh`JG)
zqdk|AYBHA`jh0C+*<v#K&T;_Fh`I>tMEM`x8LZ=1&dMk<zCfWcCPZVaBh}ptVZ_wm
zSXWF#J&%@p_(qDBMqdz=?(~X{>U)Htcv{7$4(OVC#cbude*Lz}j?hX*XUH<8d6jCj
z0%RdFcY;OZr35wuq_1|H{qD@%Dutc~wVAp!Jkd8V7o-IkHYwd{bo|O#qt;GNOX%H1
z4$29;7*|Wzjo)m>PTXYZxu+D|lZ8n8A4p-;W<nxbr>rQ}(ZfTc%+n-5Th7bEIWS?S
zqB&B_re(rfaT){C$pvXGxtbX1wZoL4316+cs;z46*;8X((ApN$oM@M_a(d+aW=aiQ
z!r84NCnvbs*LbYjB{aq9bEA`2(oWR3I0?fog8{7hDNETEc?c-MF;$Obz2`V{?8qmZ
ze-oSi!=}*jbM?1@EEVsGDz_mbOMOR}6^|V>H8t6V%tqDahR&VD)YW;fPBo~}M$Psh
z*_QfX(nYI}o#@GHu*->ENd|pxLupMULd<fHGE(5<8KE>1I$vnh=BITZB~++wV%*1A
zz)@aBNbGgSTR&7ri(mY_6mJ;Gzs8Zi+~0G=%p^Paj(w8$^P=IKFMo0HuAG|KtR}!R
zUhi%_2uS{A{z<E~z2^|=*?Lj=3~C_9SG~ROy0=2YAVzOg<kWZ`q`GHXBz=^8O*BmA
z%&X^RF=0!1HNFE1Gg5?mPhhJWcJmSDqR*;#(w_YzZFwuv%@MJn{`gjQm&aar>~Dpu
ze0cV%3#^)D+)i6BneqBPa6&Y<iOT=V(i<!G%89&dvqhA&YZ@bt(YvS@v)Tm59^7~;
zt5&a^5hcIFNnr3ccOi*X{I&XSiB<Rzg8yS2LJc}lRa(C9b^ebV-9T^cGgWT_=z_1c
z>H-$~CXW{6=idh;t)ad&8CH)0o^G^InT@RGmA5Y;qnc139ZmpdBxS#uG7h28UxDg<
z1Sn7$Ge<%>CmRBbm3^m5R0EehHWqrL)?S>D{gwVFb9=U;8mpx~ZYet!xAC9S{#u(8
zF()Kfe5FsOVw8q=stCktT1n=HI-Birvi*8n<L4j8GFAL$9)}$Bc%#17YzA~3Lytq|
z<>G<rxQDpe9+O|!nZQS0NHs>uX^F4I3iy6gY1=iDv#I(WFit(u&Qu258vl5NxY2Te
zu51qPJLu7pN;lLHMiSuRQG$WSd!ug;xR!RQ`tVGprHETaey>zF_cw=|!<1*y-PSKC
zuLcJnX>LyiUe*k+Ijc^o{N8XzK-mL$zm1ft{unCHwTIune!PtVZrQWoi-1iFaNne<
z-|HLj*@xdb6mGWuNaQ%&{V`r#x4(%4&CI#PM!<k8-`VK~p$upWrvRJD<ETX$ry+?9
zdr^JcHfT%1PHE_5jVA->*}m04kFwnm?>ohF<wf%E4Vq7Y`}oK5P(DiuCfAHS8Ua*c
zOfc1!)yZapqFcpRSZ&z<srkR0i=7H+QG9mDu!E*35;a!JxMW^Gl)5$?q#=Q5$-Hx$
zRLH26wRn)y2yR0SS!$IK-JvOh`PGhJ?MOz0scv2zXd;#WZop$%H%Y#Uu?Uc#`fR=2
z)Xia)PB^x>>vqcVB@0avNe{K;hnDKOX>t_(^7Nj3l?dqgH{?jsqq?=_-n+Q2z_AA2
zrf212PZAQrb~IbYmh6Q2OhZ1}FU9<dlO}55RTbCUL><JWG3ZbvM+#D24M%j;X{!py
zU+R-w()sCU0BIAMD9bJ(@EOM%Y>5fH6jALZ{Ctn>d1ibY8LB#?4UUiyu6Rtx*E0=G
zN*vqXNaTibo6Rh_PAmnW)QFLf!a-4>=)3Pr15s`fQ3Px6{E@zC`sE(X@7-wy%7=W|
zrP5h!)y-d0N+bVZ&OFJg)-Dsdij{<6RmtvB!N<_b`{U^27>;y(Py=X+nTQtypMB*j
ze)R<i!de^v<!oUO_pzA6T+N7DEjk*uvYZba%V^toa|q~_z_gu_(mAl`t);H6>58vZ
zJEcFn!gCN|@#Dc+w&lgIuq}-O#?i%w=nQ!c_hp7S!hOBH&5j?zP_4rQzJcQ0aD$4r
zgT`mr-13kXvcnk&V-s^`dU~2cuWJ+3?1CTe!pX12l03#+BX<LsTg4!YLenA2L^UlL
z7OCA}Kkqlo+OLI%8D7*$%wOI1kPhF<&o5jsAu?av&Z~4eyCOmL;N_OJs0#VUWl>CR
z7nE~ag;(U5V%Uaj4&Ym0WJK@sfoGa+Qm@gP-6~n$iblIypP_pHdGqTRF6SO&d(r`P
zru@B(4+Qd9`3T^YDzS2k!qife)K@*MUu<oA3j|Xq)AldF_JeL_o#A|EsL*0=m?4i_
z?-s6z)T$u(HW~5RKmTpDb#L{_`6?i|a{~IL!sioJf`;`aJ%P+`TjP<;x=_F-B<8WX
zcCfm()u{kA(Y@mTd(p#>c|bDo1{^+&2`sdTNhkPiALDMvUpx~-5ljqdD7$p~*>yP9
z8}M(Op;=Zqmggs_l}=0_WBb$~tr7b6XSeT#1f8fk9{9Hu3Bw=)xK4uX=0tct8@26;
zE48q#ewK);pF8Cc&7_3`fKY&>U|XZ-;NZ|cuW-1b@KOy(6R>o7hf<vc-W5b~?l9m{
zLfHAWSOAP}I|#^fCm<l^iZK#6uK*j#7#2#uU2a$R==QU(-}ZMmF@f$(I~RD^(xs>s
zL#JW442L2X{(xz0yk;?yZsBNqCnm`%1jK(*_SX|0gjz7bPoV`bxwNd!iXIOA3ksrf
z34@qhBer$EIfJV1C9`}SY)^!dB?t1qa0!V~hq{k0Q2nBtcoiJW*g1JU7+Wj7;fM;b
z2N;Y4-uGpayVJ2Buo+<_qf4drGjPU|Zo_vUf(a~~`sJ*;tjA^pF?U1^rePZKh_q`*
zWVyNkLNo?&$uG9k5{Bu(Ehe)T#)~j`XZ~~!l(7Oh#99lh4u5k6u?%C;G^^;sipWKo
z@bABIY$2VP2D1P|g7irhvl1&~IHT1Z88V=RXMM%WYmT8m*qIv{ZKFVv%<D~+ByaR9
z2>*GTWt)v<)QxC_QpnwGz(U=Kpi`dgt+v*FHkV!jPJzU+3MXME`~X;Z79s@*n88o~
zLwot+iE4K;x?9N1%F0-+r_=%|j`*=toD-ZW&fe{W@k&e5*w8cjcuS%rg0WIe2Hy4%
zD_AvEA^N}`*Yoy9wr-?VEPuU?9c9Hgr$X~%;GGL^!47v|48KEa8;->Cc_#2FjJ>%i
zqZq{qYB^-CSpf)^wUF^Vl4pNh0^r2)`%F;We_T6_hB-5_xytFZ6O(jj?iXNhuMHpJ
zxbmqYnn`ZIw*Wer2i17vQLb6QW@jPdkcfS>OSji>fqwfszQPIaGeVf;*+0(^+KG$a
z;gAEOQb5Ibv=&TI1Q4_!bmvDOQ2_7%-%UTTBCd`L0j4+ky5h!)G6YMXVC_Voonwxh
zCK?EOqu;6~7*97K9ij8vw17g!P+N>nWqMR?sCk*(pVjhV_O9o`GRGa&<r2PZJsqGW
z*O8>2B04IcM96L^Lhi5M8SIfbje?3kxYLy0z8b7yEF$PO|FQE!x=*v6#@PuMzw%_C
zW{ph9d%?)}iy}4F4c3B(%7mrvakou3E9U%XX^XZ5gzI{XknZKTVAt%IXoJM3^S<p<
zoJ;B5f6|B2vA9oJ$;Y~!eNs)6hb`r`m%yt2Sta6*>KMHJ0%ZIfR{OYbx!=qKiB?TO
z)~ghXagLJF$%~Ys*S&FT;#>4d+S`R#xO|Zr8#_=2F<WZ}mfWo(T<oU(tU=|6uX<W~
z*7DoQGfC6bn_qBh2yIUy7@rBa+!(ZkE?wPgbCs`Ed$mfBHg__~Et)Xf3(W=Km**fY
zl1_xj*DnOI@@iT2;PBPBD|xer2iuLbF+18Tg~+?C{M|~&RM3z{6(d&DlwE_uJXTrd
z1YSJ}kk#vU54XDiCVf#;Vt_;J^W7b}n>R)W4;6;l4<+`mZ5{5t4f>Pg#Mo+XB=`&P
zqn8g}>;pC~yuM^kL6%>u4g7GQh&epiTQkXu!VTnN7X$i;o5vX8@%&mb01-Zce;ln5
z%K?jG@_+gb3chb>m>}Q$^ByEPm^9%Ir&?t>7FRS*Y}!m8)HF!`RiB@h*NS<S>~n63
z{v;CoGWyK#qnjKQ4#A+uRRcgQlm0ly^}fJ%56Ea|TXkLMyAmhSF1pY6fy`>)JysT9
zE2Xb16y^$#q9%s?3Ru^^Unb2y+Wd~L5I&~(tpa>K&47WAW?Ef5#V#1NHH4wEL>=gQ
zg3~gPQBYt4z|Dmsf3|-b7<r^_1O|f}w`U?=2DbtG$<XxiHl-Rn1{@#-!0xW8EeG-{
z;Le4!l%Ck2vV-p|LGMPr^qk<ixAsiy7c9RV%a^)|1u5u<|7_==bqQ$d^TQ9eiY;V$
zAwa%aW-S?ziXl`C-U~RsY%8DK{eoAHq#>Pfz-9^}A&R|7qX?inOZ9D`S!y2a%rn*w
znQa^=k*q@w(5mF4Hd5iE<#jWqz**L|o7Dz@{b8ckc7tup`g}LJ6p0!(QkgE8hk+bf
zdJ(OI$9S1lvR-n}{+#+q4PhD59>d<ayOc!(T%!hu<Y=Y>kcf1g_9pQ)P-ggaK)+ms
z((kgr#(ut6NIYLKsy%}w(fM8!=7-MV#;r=hle1?bu<EL)=E@On=RO>afw8T;>t6-w
zo|NfM2`uwNTqqNfl9{!}r&a{yo|}*6umFEC^NNYy<R;{ACyk<I5(&&*k(?d@lp^m-
z@oUB<RU7<<V=E=;O>##{1}5bQ^eQkG6@n}@O{`)|V9MU?_d6<Q1ClkmuEf<OyIZ2}
z-9chln~Ms&7)`gO+W4anKgLTSq?)xR=#gHJuDRlIO^!(g#!9R8d*JrZVrbh}+Tqr!
zx42qX77od~Jm~9{9q|j)4i|-|#_-bdY`HK{RDfGz=&khbZ5x5|;EI)!1Lx=cw`pJ=
zYU;`PB#f3_1O{qL44KgV5E$Gh0C^$U#F$*Jtu5>C-753Zco|gLk)1GoZ6p48)dFYU
z@J>)Ls`G$de%0>fmYwqxYf|^r0lDqK8%(Gzr_ZvSz`kwFV11za-&B0|^}{5v_Vj8v
zZo73`Q-AnJobb#~%o#vd8^X68Kv?P<2JF(Egab+^9fy!<NV`7_NZ!*xFUsl-yzc6;
z&Sju?;Au7!rOEm@M$s&y4mRO<oRyOtf`}9kKWyIv3a71k;X~`_b-w7&pu<g21#P94
z;5#za5V$Aw_7~O+$dl)2wsyTSSOas?8^{}o17P1<SUD8Rpz7}lDEoW^1SX|tU-_96
zaOOu_TiZNvZrIXC#`GH0YOg5~D0sBVya_r$KcxLv6g~ZNLNN6EZ)$+@nh$OzYOW0d
z9@VWsITcv?7a+7W0yR^c$MnGy*0{+DKH>I1^^|)O$iOeXkG39d0uE|uoei*EDClmw
zgUK+^fhdJ-ENGDz0~(;w7j>Li_KO$oo$4a|y&nk2x>yFt)AGFk@>MIxaj{E*5r6#0
zk9PaT9}%x)yEGV(xY(>?5gbk_)yYdj6t^M@FMnwoK?TKiMy}QbY!`&9wnbx&54ZE5
z*t`#u;ghw#n(&1>=}C|stj4rB4(iMWX>N|r%gP|G581{RYEsuL;+Kc5e|M8O?{F#M
zJRL>kKI~Z%g+yj`H`Nk&_6QB>rSlY39;lE|m~HJNH*|@FHxjq>`l6eD3&y*71huA|
z73iQ0>&q`Qws~8%ef7L#RzKtYYY91VQ9T#`>bv$;x@!z?F`$FT`S9beBv{pgXX-`|
z?Qp?lF)d8pWTp60xayFjocwtAc(<0R%Cb`)=xz<B+t-}{=1!BVojA1UB`lBzR}F)?
zt|!$J!MTeR$5BhUHbw%YHiN<$#@RjE?+`qbgVU1W0c+ZY#NiORRyTVfC_biA2JCGE
zER7QtFRVU0UT1#VPa>e)Ir%#}+^G9sZ~eiEf4<qBNB`xk?H5nPU5?xW`bt)2W+h73
zuhb(h|FQI(|MC?p5C8=pShUl+4Y|4#ely9vj#WrLd%c7|rXA(hD(ekl$+9-@pFw?E
z?0ZBlH77^=%F);Dar44W$|`iL6x$i!!>6h>g@a{3x@yC>#a>r`?dqAo@p5V?RDf1C
zx&v)*%M$9o<f)P|?)bW+=)`&@R6{1>y$5fO`dB_FYO0KSR-lQBQx1lV)mg|&<Mw`}
z7F$pIn(3))RO3a>?PQ^<3Fh*JzJ1Ahiw2@gH7U|6mS<2lvf);x#?{u@0e+5>DZE!6
z<TAw3fxV7(h+ToNIeH+o7;BPVhyQZ}ME#SsXyq_&d^^!~Ld{AYl#oI@*nz4dQ#(g^
zWm_A*qvsTC9r|<Rg~kEslm9u|NkRDg`9`66hnzhv-|}GCCV2#dag=Yd)I@cs!0NP$
z=d$|~2{9gP9ZZe%SbO~|V*G^2`P$_v0qN#rG0AWLYUlsD?GeA;NV!?Z@s>5{#c%(w
z-<*#gW&?Hypqai*fIWFC?&8bE&oWxxsNea8_ra|t`U^DMrC0-;Zl`EcRSi6)aA1MD
zJ47g3&7y5&fi*$ua_Am2dkqsQcPafeF9BYSd|tx}sY&SFJX1*1D+R>fnLRG`*s>N`
zOec@iM!ai|$e9wg6S>e-PUnQYPDYDZa{c>lmjY9a=-%$;qTaM~9;NMJSWCI1FVfNr
zQ)^ou(A!l#B5!F0X=|3Wm<VOK{q!#Mk{*&bl$5p+H9^wkl)pCUshQnZ#n&4FlK`()
zY-|Lh&xF1)7e&hn>r0yE!SBAYDfG8{$8C}1hs^{;k%WSuwz@IHDW;!87wzY34V({_
zz{9vl3Mu;%`qRoBu7RJXOqiZ&f$8rpYt5zG&UShUTx=5_Ul53Tfy=R0XmiZLtCxf1
z#=1~)w1BKa3mn5W*|)v9(tFr#dw9_6&@k9|J<O?6`!3fxvP_ut$D}l{;lsDz8y^f0
z#9SyNLBGspRLlO$l0<U-^57QG1^=DRW{$M$bxjG~_>bhguDkqCsZI-Ocv|GQ|5(Y$
z<DCDL=Q?#O|6b;v=jQ3=r}EXScl2PLnD=^%a<L&9I_ANa`M!ZdU&!mNLQVpJSZ4F^
z*~FwA4DAvT<Oz9zp*YQsxuLTic+XSNtv2>P66<+`l6jA1CQj2s4b<C!vO64?Z@QNp
zpGgzTcs)b&<#mB@cW;Io!E9%2<U+>lYpf^owbh%cr1}e##=Y_2U5H<ui@QH|jK-T_
zEf>04V$@Y841FX4i%EPN^}L+AD>9>^94mB4syGkJqU|i|Jp{ko%Gxoqq>jgX^KOk`
zmHvX4H!?KuDJgIB%yajkUOEBuG8DDlt5swk?LQeb+U|<_Gq<)QyZpNi;r1aAQw!N+
zjc)h$zY#L<{dPiSW0(&!{@sMnRIOo8o;uSUyw;4+c}n0ES8gZeL|~8T3m&N<OxT65
zv<{{$;C>^&d-Fhkk8Uj<I%c_FIq*LpGQhyj-^px^mFfO#?}!EcQ>GJclQ{A2kE5=4
z`k;Xe2y+}Rc*b(Nvo^fJ+4Hu#I%#p$>*ymx(Hy;aaZw8b{rE?REb4f=>qskH$;9ZP
zmmq$eL+at{^$UfzrY53yyDglh?&bbD->paGL#FO@S8*p88;D;jJZKqkTTz_B>Qy_c
zEEicUZ*&M5mUzX#wXzbuS&Bn_EWVUhz3WV{rScy!cIZPniN=>+(f{3`(3Cy!)-65u
z=rdbl4G)tW3di}kCxx<7<>7aN#~dY6-Y!y=gKnqfUOcVi6=1=&jL;jx>#b3fcjv&z
z^=*?EG>o4h$2E&RHYL_f%y7q>Yu9Vxg%ogWu_JU*ckBV}PTYP5qxRU6wLrQL&U0~U
zuuIFFl50c%9n_{}lb7WLGHl<t`KHix_nc(3{^cfj@zo(f6hU%-<Z95nJpJwmi}n21
zInQbo{wcBj%XuPvm>LUux)@*s+G*!v4Thx|NaO%ehmp{>!-=V>IZpfEJLZ%omjLGs
zq+2kAg#*Hg>a&R5O`<nYhYvOOXDHx}qZwuv(iefDEj!`e9^Ll|ky?S9O9QrzL5MMw
z1M=lrH9eL~<t%9b=WkrU3UkBL0Xx;Wp_`D#gB=$Y07eyZL4Uqvu!j6ttrH9EKqlNW
zR*nhpya=Y09HMQ3#$5}zW|A44@gB+~J9z_E7RDbOTAvi6cl*zPwSZEJW%+{uyvP#(
zYYdWATWLN_%NA&VJWC>03NuK}n}Z_&X4vX?IxrR98}APK@rti>m<;P?U7<^o>I1xE
zL^<p4(FernF@Q`Ufv)0kd)4^)x&O%h$Uk3p{}N5<%F{{M+Jqn4*G&g!<wntMSS`q3
z5M|s2#-5NM;MZ)z1=_C!EIwN0wis3eHgwU-{xi!2XRNjBTJ8wE7x{(-?v{DMwQnpF
z5R>8#8Uc`dae6whL-2%KJ9@2wD8#boCGg4(1JjL#lJH2=x|wifD`1XW0ep3*Nl?ZJ
z+%hDjjs?)*zzeW26HqOGW-SYGFsBLBd&K##62eO7{-J=EkOm!>4?u6A63(w{V^SOE
z-pF_n9)Xxae-T9%8A73QJzD<8_+w$j94lnVe;Mx(U^}$)E62!n9VT`50I1WWqxFZ|
zIfToQs73=A=%Aie@7hlLMa~OkszFM%Ha}uVYaPNC)6^)HUt*Nu5v!`28$DteqPXYQ
z@(|1M<Otn$V*+!EQ%wD{=c13@I(;!f6DIPTVnVAdzK)&G?_tY0*d(=(ier`qOgP_q
z8LAKKEPr4g{?&U>t9Ja^;=YG>J|pk6sFP;!h>I$fJv&NvDBtMixJd;$OKhmH)#+S>
zw@YzLBI4~-(7wG{H)_2R;bNUb3FjbE)=O%qiTCB?#`7L<j`<Fu?$_x^^Ob@l9#+8Y
zZs=-on<qA7g<fSU;VViWd)F6+H%EFkN7c2WUiwu-JMzM1BJNn_t(U~RgicSMlVB|M
zB{y7o`wFz?-xSqyg2Fhlw@Z)wnIGpcn;wiLwf!oitaUi4Kwix8CNG`@%E|dz{AS?P
z9*MBuilc?MWLMYr<J2U`c0;QcuS~{_{qn<6TCozK=(f1s1k_Z$(~XO!fl7Ox0?b>5
zOTPxUyd=L%@DY$^0!ZR#I<9+a2Izzz-TCo*Y+FO<cGGP6Vt)o1pa{5*cpePk=!y-w
z0ZdkY`gq&jYq2j40|sU|Q^fz8u4I8V!xT%DJz_pd{SlB9U|Nh4mZEp>Gn5BF7MTD&
zXSLH12n11BC^50*S)60(4G1&XHE(hHWM#ea5w;iST}wbhUtV^%LMdIppXAvBsGy3^
zAwc1{^oJWEWLCqhKMYLMT_&--l=SAmW;OF4Bo4oqGP_K2!@5(~CNVM-&wx+{qN|gh
z%h&o3FTfM{3<T(hkou|D*t>;&j5TQ&)>w_r-SjAP_Rxeqe3~YV((*RD0IVKd7q|79
zD@qTrhz_w}Y=rJp0D?3E1V%!iQ0HgmO|ye`zr8e4c{q-C!QpU)Nl9lh7>p+{5ZW7V
z6LAoDgY*o$#%Zjvew<a<RdQ{u+c|$P|GuAE$oXj1CUgO}xp|1ncvP>}g8lOq=YKk1
z2SJCCiI<fO4(Wb}MIp`eg0?N;7+X6#3t9TULTE2Y(l!m;Pr8uM3B?mql|!rmA;xLE
z%8m1{>amBhe)HmYIV7wh3UHS#vtTuAK9>cV<>cfV>66~9meL`7r7)a8m?@&ub3wL*
zMu_*9gTHCNS9JGHz}^Tn&PIi%QagksIlJ1?+-*2Q*$l#U=lhG;MoA#KuNnuiU3-+>
z^H&#mi*-7b2?s_1sk?E#OW-9K0FsaG?6QCeI-b_=_7C&p?BC|cQs%aau3(`lqJYma
z^ezh`JywWtB<&JXft-GQVhIQ`2*8g|?3FpT*aG-pyL<*XC@?@r{(a{q6%YiU9l3So
zVxXy^{6pbBcPVRLfyb301Jd;Ktuawj&*Y-pxt%mDIyW!9Ne?$$UEZ~+x=^TW_|CKL
zLK&}jgw>e4v0+s(XKtAbM@6Cg#K?g_th0QhO`+b=ceDH&FGSb62TSRamyp~Do*>ay
zyLPNXty3O$#!*@RAW~X2&xe?i6OsVlY?$wTl<RDnbxe>3o=z4QlX_^`&mC#n>(;88
zb*#No!Za%~iCFz0(mtxKV;7f1C2+U3oRZfscr;VXE(KX%Vrb;9eUSJgjpwkE-P2pE
z8wrl+`^Y`dUE?6P2id|Kz6-GQlqEV>aO$%gzpbh%ovY7<=R}wI5e^PXi#MY!6^wUF
zFjhu18E`FXuemY;-qzKhliW&xLZM+zaTsmW%Et1<VS%yO!cMpO<@ve!OZH=Wf@|*2
z<#@I;C!;W<JCRTC?888;`iYRx&;sCtC}5}KBtg5qw(nQVY^rMjt%=2@Fl{HpfL)F8
zoo*BnB(um|M(dWubi`T<kaC}b_qN*(qkv<6`MxmY@#Aek4*J%w&}MJv<1<mE!*aB0
z9jwFfB$f#pn5!OX*`7hdq9`tRvr>WvRf&{cefkJ+F7_XF6>$t-kzkoiS;kNmKgXZ;
z!2Si~B45q*4jwN*KRkd=AONX5YXam5kGwYk!xXa;=6uH*3l^B&iG8F_RW!=gu)%6<
zzHQxKRPa7zZsP%<L$hu1Mm0Qe&w->bVc`|t6)l#mvGo{sPL}xP0Nq{0gtI=nBWNa!
z=sA?96OM11DLmYVA67#F`0uqcT-dnLC&Pjvw$sRpR$BlFWoYg88k5HC{4BKK_}Tq|
z*%CmP2!!w1m(Kul4FqRlwNjMjJIs>4VA1>Y;dAklEW`Qo+uMWV#lr0=J3{Y{?Dn_q
z8!{IpK|=-lseox1IKY>_e#}pkvGN)#vzcs!AbneRpUK(RKL#f7r_a&(*<M@&$md(v
zsIOE&_h1PZfMR9>CIA_<h;_t%f60XcXWe#BV#z;%235_N*>088R|EX;EbB8cFMQJ@
zko9hM<`TRQ+dg865I}Jt0~dOVB<SC9zHzN}F9;}*Jb}wdDUdQNTF#AF9U9UV790iS
zskTypgj%o)DF_W`g=dWJ35;yB17w?3I*jrdYkcN;bmuOhPMpqd0&)Ni5Fg0^tFDM@
zTKsQr{pFj0W%EyfSl9>$?&YjS79Rkrxfhc`3kO~r0vLtIw9euPtOfF$(a=2H-(;=+
z*2;)L>mQFvVcpKV8;dMd%ZeA)0q_IXecL@ZtOyFkuP5-S1Stgo94jd-Ed1;UkS##?
z+QL*s8L^1kZyZ7;_qjA{V5!1aSk?u=icA9_HNFv8t}WJVH8Ak~_eTq0I^)ErpMN>S
zSW;<20MZw$Tzl)o>ild#ym(+>9GFN5ZOar;@-nARziGV^&~ueF1HmY>`kSF42LM5f
zLwMfnMC-{Y1$!VU)PQ1zg?~$b{KIN+#t97ir&$6^l_PBYm+v#>a4hwRgFfj3(**oT
z5ne!D%HrcRK$+5>6*Y{)MAcF`fO5NaRg{hGe!`*t7gpc;4v3v9wh11;=JnVEQpJJ6
z;b!!Ku@PKL)3&&xqIT^+rv*~FcPDAX2YWIfz6)zr5YNkoQK;0a?wQ)Le(-z*bcy=h
zEy0?$qYo>jOj?#V<+ql*`j_SKR$OX^rKd6TV}pf+;FmgFo+W=uE}5E%*};}+&MK_8
zI-WyjrtR^xcrSWvGg7;4sl`skk)p~<{DUN!nz`i9TE6HWN1T`gr%;+eyk>gA8yX`2
zGGx*-xtKj+1&j&tcv(MGMww4fz?bJBb-ywABRa~cmhtx02F{fJ<oR9xYoJTq@oThJ
z4$t;@kLAfViO9D+^K*oL^k((3qCq9H(+$gbp0AR55O44<bUG2s!LdPJ80wwjf`7#^
z8-b5X0Yj5CuLYde7gV6{%Z8hynBbyWvp%6@!ti)pRp%QkO74fv&=nH2JQ(<crBv-b
z2@y}9B<4Et2xkPiYMFCyXOA8(yMh%CpJMNqVq2&c-P@khe`C*I4GOtA-)XM1)F436
zV5yz&%SP~4govE?uQ&_yVaWlxyEAycGr-Kp!dJ}-;#FMq`p?4yc+gD4eSGm{7GRju
zTnppke0MMjd>X~U3j9Fd$^nuF-Jci6*R}ykh(w``R=M@Fy!0oWz_SEEE@uthTs+0x
zQ3A2C`C0tUm_z`7&(kBrPJotd)?hz2d&rz6uN@w&3FICw>w-#wPomKSB+bJTK+6Em
zWR+2ymT;OD(<=gyrP%-GioXUlTmddbZRvx{RyXJX{d5nQg{g2lWZ=Vr9%poB1_gZP
zg$IzSY+EB6d>a;dF}3vlyImv3pmM-Guu|18?;VT>^7MZp;sW@oSN9af8VU<_8tmmm
zS6OojHtsovKzBg~05}f7-IyosM_DO6!wDL8yXg$uubUPf-R3s}02KC)70g_-$Ep+n
zSI+-Mf~8Nh0XM?!K2z|_-<zlcN|Tv6a;XHqzaTk8{oiP%P(M9${XR%s@<$sq#b|s}
zD4Cr6K@P|72pccA2F60?0@SH%OV#y#bI{<o4zvyV1mc;40<8!WU}ki|Q|fJN*_lMR
zldA3Myl_t3rnJqM-aCe%U_b#ZyT@Obc_v@@OE+QOxJh>7HX(aEIBFOEx_@9&#^!X1
z(`}g5S!Xlg=$~@O16&V<_i4g7l-B;Z3$}S*E#ABIsCTg91FiRe5%$&rQLf*==wP8B
zph!yyC@39*G$H~5iW1V&Au@oZG^i*oAqWVHq;z*99nw8?r${&4_3Hla-}jtz&%OV-
zXU_~X^S;k|*80>lrCW~H52;Hmxc-%Z&dCLxict(p3l2X$qso%85;m;0^dv9*aOXRb
zH~FuCq2aYsE4rLJUP_>MV<ROm94D(7`MT4u%yt<&$}IE#Y-GIS?E<3v<3?MucB=!c
zU$)kh$op!y9gF!2=8S#Iu||sP@XazkqY|R~_m_9*+*mQ-5gt`A%{;n6e5AFU$!|)3
zwf^`}xqYc;*4B+d#UM(5p|xi6j_=`Pia)p|<*Q*!D6R?eagxYZB0d5){O43Uq)GHW
z+vpwzM!G++^ffT%{Q+wnfO7al8Hm;Y!L7{+9>hHPOH+{l1Mf5f30nKN+5DGsFd%E5
zOEHlqF;rmV>0{O?ksTyVS+{$NyP|eBHS&SkV!?C-3un_6BO!@fg~eK<CofGi)yEW*
zarz_&KUyE2)m)JhAz2`_6Q%T((I2_ye3Pdp^<YN$XLGkZp^0XGiMI{i<BG-2kfax%
z!x`N|4?hnSomtT76`;bPMP(;UXpGJ5f5?COYPj+VU11-rY+4$cdh6a<%&h*riI|9}
zX|imPDbp4Orjb`gF7NUq+?<^D;%mYw>f3A5H<ap1rjH)V`HB!`zHz4){eDmU=~J}p
zfe<sJ7D1@$v^*0rTY)y++17T!2h}OR=K5)Aq-PdK+6O3`B-$#)^5vR-iMp;b`xUJ4
ziso8w7E^~@k$&~=MNViXgW!>fUS{REx}k}I_wCeiuHB=Q{rmhpp3ckkQ!^JlvpK41
zYiMHh|9`mw2k5i@xg-d>iL5__PW@l6n~8;m@gF#VeC#joea(8V&G7Fd|G93^+aSck
zo^w0B7yVB?eOAewZhdRPMZ?E0(&~&IS&|#<977T%N|=1V<rTH)U6*+pj6<ES@kJgC
zC~2bQ({%E&#Y&&z17s`uA%A8oE^6!Nj%;0#di2J-`nl4T!%|_c+}`aLEfeMbDH+IY
zm>LW(e3bU9GFo^wyHaGE!S}&dQcrAM=!eflW9+HawL8C(!Zvt|aqL`+g}s<E>WUKS
zWH#1T^7%&U#d-St%j^_5lf;x>7_^;rdHm%g#nQCiM&8aE9iyV$GHLDkhQ;{USBlm`
zIk&t*w~pvC+hv&g_}0{0=`wM7!%CN_l^qkbwgm>4V)U$Y_)@g+CmYQ&jDkv&Ri|Pl
z9v!&kliWgEmru{lt?UVNa!DrB`bcb@Q)Iu)lRgmT+v+>8WclE?s0oTrIb9w29N^df
zOjdxqU0Zb;JNU2b0i=QfC@}wC4*K_`^yL3HKveZV@MxfJ(srR!kP^e=#$=nm771A+
zll;`rsSLFttepuhL%$8aeB#Aqe!j%rOsFapk%+#)m2fAWMoqzgtGe5YsV^WZG`HvL
zIF-}m^!4jx0edOGo_vU3d7!{)Th?grcr`%@=TSlQja8eKv@qebsXF>ff*FkSs_Sx{
z&7}oum|or?mY6ir3wH*K_xZ6Go+sSrze*sxc}sOnlYgD&Yt;0NDxo~xFe3{_tT{W6
zF*8!;k#D@h3?a6kncNoZCE4ahDW<1vR?A>%rG0lxR_r8Ie|j#O=|Cd&C%x#`$AqF^
zD@k(WZ#aoW^NCje+FLBw-OSrBxU-Vqon4_ty#>YX$)h*S8hXk*rdw8nAJgkqqf;@Z
zV@VdK5CPD61?BQJlmhcq@8XfVVSoHIyI*5@%FY^*gK&t#ni|8{ldJ=W#r%$khnEHZ
zA!ZQPCSZ*4^n?E*Q~!%NxXkijAT;UUrLdaqcCzEvALB`#0)heAzc|`eWZ|R%ga%D%
zJQ6F_G$*>|{rLHCk)`8wkkn@6*kR(t9$*y<V2gcTvyF^8$bbcQzRk8*6^a{k?fpH;
zig699un8mRU5Y~T^X=uq{YEK~Sj`O17`^`sU^)^#uEhsJGTRo`!g=6`d)QsqaR1OA
zfou5ZC38e(w+kz_SVwI8pLNdRyn7>ZI6)vAd_1FlECHH6vn1<b%LX2nyVQ>Jv|pTl
z6%Scd9@(^VHp~N!oMB$Fz<`)=k#_fONtl*nG9sNrlo8N1Blsp;(fFwmmz|MnIs-(m
zI1{3{398}w_>Xd3(A?xb@1z6F;h}MqrKFo=>==?9_C?SsmO$HSg$I)L<SST+n@Q%9
z_chsVRfT=SSTtA+3+ob%vOiKwF$V<ZTltoMlYE?Ho?B4zs;32`mAyg|z`q~(HTvCJ
z-z(ENG<Qai876h+o~et*sIf7>R+}E9uz4T7nDDQzI99<_`ACs^YU@QI93I~{czRFM
z{jV+d$I0fpI>x6{Wg5C+sJ%~bkEz*<mX=Ima0k~851mCESTdx%jpo9<u(nJ|?r)J?
z-Py<?kg#)6;4GV|9r$IZVUg`dNoZMGe80>rBj#Etoi%N~_NDJjQ^E5_{9J4zZp<R0
z<(gE(Z?v^di>BYw_!`RHm&dlQ(pK!H+7Jm_5g}~lcM>)Z8h40XdiHT?rvGb!>%iJ}
zX5Y@PNx(Ggo~mke&IYsNW=5!sf}@h<N{M8wr;`BTs&V><=*mgDN{@^9m*Z&}wcG~t
znRa>7d4qQ<2#Aqw6ttXUdu^{aK{F^guss`Tu^1?h-+AkMRP1SdzHbGPlI7-9Q+lI(
zEO{Q}HHbzJfur_8l^Fw~Z*BJS&EQc`KrTYF*A1hJa;j6i@Xm7>F%c;zXk*%?gUw4<
zc#i^3)<kW<+`R;WTN%BGel`8qFLN-&s(Vt|g^xOKJVLafh#(MjeVNcVtTZJp|3S+&
z%!?)7-4lbvtb6Onz@lco$_da}8|NgXabdZ;zE|c`r}ta603Ct62Lfv0Z8`O`?plys
zM{or8irv^_0MV2WRNR=YK^OE#rUN%(1~M%w?;xN-qTH91cIR2{d@~g-hXl}pbAX^C
zzF_6QgpdwldSF<01ZnnG4bAb(9mZnMisP-!R2cb@FAm84-^#2!QLXPGy4|r-IF@nY
z3PX>G>x`De3~{<zt|W-V9Bsy)rYcJZgT|K%jc7P;NJ9c$$aTQS{`lu%6}*vn2-b5%
z)(fD2a_W9(m{KH&7u7pvbs{+R-$Sn*2Om=6Wb^UK-(Dyu<~Uj$Q1~r<0`x$Z7@{ae
z))s(}XWKz{S=kM>!L~<U%H)T~1%ZR*TnMVH|0cI>nFPcA8O--bk;+b5`zOm^972eD
z%L~T1cT7rRVj`s}DK4KCJA+LmA@=qZ)4Xxd#W(j=ia2F5`mr)Qy{^4D^U%h`obZ8F
zXe!|wGU5<2dZss=Vq%mO>O>}I&UpSh=P0zX(~vB%Me-e|WFctVrB7f94Q$MTN~s-j
z`QxX;XP1ZaaksX%A`XvQ>ZdHxV-+I>ZO4Wi8yoVfs^My*!$icyy3>t8j_2;5r}en>
z)6XH*=aMJC+hEjj_+vwR)UrQs#s@GGoJv;0LFg6M6Q~?N03719|E+VK@B&OrCshaq
z;zz-Qvs!uLDygRN^y#~@va&Qs_#@mcd!_u%pIbEEAS&D|m*7v_%R~7ehN^mPH}348
z9$St6YHuHO?7C_?-g5&_Lo`%o0!F73j^`cMqCoLlV0ajH4y6gWGT`G^03o<D4j2zT
za-*XbjPDbAqf0#^=5`Lu#(v88X^s*S5fME<)kQ5W>3;vq1{ZJl^`>3IIA%v)Tz~m`
z*=-`x$d5@CD0011^&WiExrZqu$|b=Wtq#x2JvzTeGqh2E);wr(oND==r`saUud0PA
zC2uTnNeuFQq-0)Mk{#N}B7286C*RAh*gA)6Z@zItz}Z=m-ptoTdXhIdFKTHcSd7J5
z>zm`$ma>41a^5wJtDoI~UFhVBHAh;)Tdws1ySn$B2iBI#RJSmTYGyAFo5T;};yF{Z
zdvAV>CqvtIilTW_#mmKdm(LXV7KfKA;P3G=lQ!J_(lUpYYmVUzZq~xDGHO^S)2}gl
zoVyTKbPuP7?5Z@Ewk6t?!Wup6L(wNf@I~>SjmW%BUTDFQ+w&;g(*`{<osO164D1&)
z?$tXqwCe}pSr3z%*Ox!U@)W9acw*(mHb*C-9Z|qK+K=_iX)*ITUV{JDo6QsV;>?dW
zTF<#{&fd2%px`Xfb~~~S2@TZ+XAmBf8wmY$02i_ctsu9<yLayfN?)-PdV8!4epp{$
zZ?!tkNJ?r<*|}>t*lhTTO2paz?W8af!kG!5rh|LH%P28@wY^^|`qT04K;-rkiEdA<
z6uzXDNlG1nExmtMzvG+OgX@I5yHf#XhO#m;TrF7NK)X9XQu>O)?IdTU#8y00s~o+w
ztX+_nb`cg~#0;xgq4~&dtjqV#)86Oq?sKDDjC(BWMsfG)Q(}bV^SgS7ZNu}VS~bVu
z0-^Vr_xMzwn@Z<neNiabWPdVUJ%0wmC`kvJD?nsAP>v}vODHR&gfvYGwu;@!hodl%
z2Rykst;&ef7@Rc%>3hjp**`1hArAb@Mw5aMOAX!`P*<w4qiowH<%f~Hc!+4VGgDi%
zcFHnMvzQS21MvWAVGi5Ho`-`m;+}ewwcg>}#`ybNOP*lrx!UrHwFbxuPP3ugM8s-4
z33AaQR1ijRJELTgNeH;n-;U))GoLg9A6(~RXE@W<t~(6sx$rv{)N=eYM4Fa$#1Npu
z3N_Ck#MD_57S$9Y&P5E@;P>!&ZbY%hoPEiY3Xc*4WFH?8JMTeuYQ);o)FftNatjH<
z&^QKD%o=9wn0Kkz57g*-(Da7iHX(H1Ojn2af_jkip=S`5K?oH3MZha@pa(cmci{{D
z2B=Ku_jq+d4y1;NGBGnlhQTWx5X7V0L0~-zyvU1zbJTQj?fTFBQ)U>h#nN|IWt&wj
zw|kG4JL$t$-v#CgFjDPnK@Ywa6%E+&yuEevX4U#kOSbi#98>_(n`~@tpX0;fLgGie
z9rJ@b>io4M!m7L10-v_6?&yQ&6C`=qV5d;tT<pb_qOw)0;mz=Ve(KK+H!DHH(ivn@
zpFNUm{CE@Ue)Y`3=E7SM7jOwjjjc8W(uz|k8OzHDE!BR%p$c3q!?l&5=cke$S0%PS
zBwLhK&dQ<a!t}~ut0tKAR4YG?Y!2f&Q}#8+(jdVs_><HFWAf|5MqN)D`xKWC#a{<Z
z5_CF>ScA{|G5e#wawYGdUMADIggsJA*^9i@?D$;yl}c(+pD;>E*z!hJq*i15McRI=
zNxrc?k2WGqJPSk@@|;ijTn68%xwR~1r`*Zqq%6g-3*$46hop1kYxX^T1P>qg-nb}b
zUmhY}-X^hv^VD-D?ePq!N%!4I9D^_yBh$zwjw^Yh!Eyo<M?=;xJP!I2*KLRT@#k<+
z1^S%@vJZ)QOy5hpMaJq2$qA?ia3(q{kyl<C7#ox64;JInt*>4*RdB+-C0Zq5y6U>5
zU%8@_&c5T@89*K8YI!x9+SAfV@Qh}?T%xFn!<#mZ>=(?>q!vOPzE1J^+t7~%^;ym1
zcwPGOx}-$l(Op>Z=Q~^Bf%(Sg=sVs)^inVWUKAtAc6YB2e)V=AJO8;ce32U?E_=k_
zpM|^;yMsJ~;o2j~zq`k6_L5U{0$dcBM|y~_!5vwHu@Ufc8-v>gk+opk;=wWrs14%P
zVNkvB;wI@-d`O;}ikh%2_WSmpdIhcc4@0s0_j<GjR5KMxnb{w#mR?YBW$aR!+m>^a
zO2&K4D3iM%T-g5b;7d!6YdCS7tG+PJ(jAlX5-a9srD1*Cdb2A!=#r<+cMkf*SF)?Q
zmFJ?OIgT$U=dZtsXR{R~<d#v%@XL$T^z>{FU$Gnv@lEWNuW4qIhb*i&wjUf$QYaMq
z3cf~u<(tVGmT*`k^Yo<~D4_0Nd3oT~KUXHS@XaWHLG@X|SmFdvb3FR1;atbKQmxro
z(Tb>bt3*_o)820U3U5F@k^k29-pdJ`)Hi6*S^=A{ycYF%3hp$>%xz|M%^q(T`Qyr1
zkJb6#-Vsi<b%?%UBAh8&dI6*Qaxkpvr~<2WHmc#YslAI_ikXbm!f;^x)X1=?rKcs?
zoXe>4JhD(a&%{e3F+u<Sz{Ho}!2xr^HG9o}E(EtD!9N!ioQ?miG9yWqyZ5Ce^-HCl
zcPBjmdGXl}8k2kHvA2JXq+alXTY>g7`N*3af39JyN~YFl_uKCm7heGXNC9f`nv7?q
zm+(C;fyJ2w)E(=`L{>Ulh`Iqfzbx=EO;1njK!ZgFOu*YAZwL1zW6_V^F$U5l%h_iz
zR*hwocl@59(~=qDl>A&{a5@|>$C=Ue%SML3$_s7#Zu8>te(AO%Ty@DvxsdI-ZpZgu
z7-X<*{U!}${R3E3$TzNRJq>OZSmT?SQ#Z*hW<>{Da$l3LFiDeEDCd;Ped6`#j?vzk
zne3U?f|JG`{h=a4B~A-P_x(33LKo;=dC3P|{S4?oy`}QW9oU^QNH~>t^wCO@hrcS3
zCZNUf7NZ97oI_NL0C|i8+tQ6^%l9LWs@`8G{TQwvRW_VHb`v8FmWx~+d0lR~{)|_-
zQvA2czUgzx>9ggqmzEFoD-nOuE^|=gy&rlN^Aqz>oLq!r2dkja(9=Ya=C@@_Ls;>c
zSxsbroQ=;T#o6Ld{%`Rc3`)dOY9d1oX{Okw+F9DOvwI0_MrVGuM9osRJ@uAUom0Q~
zpDS^XBuz5MW<f#IX(fNYD*+d(_uG^dCTJL`Dk1OYHxy_6#z0z>`-AImps4G?4oJqS
zcZP|H>36F35f0d|s({8EvS&ticM@2vaJz(^eF1d;-!lT>)&YNkjsEiC<gj&n9X5@#
zyRg&txA^!oNG(TtcO@mIabwW~wZvg)FSB3tG9mknYOWC;6nZbv<Xi?)h8<|bFTBI2
zkVQ|-F?KpOK!j>7?!p78AMuwdotCrt7UDmm9l-mBCHaBU8`+LN-hnJ0KT3YWD~xij
z)1aHUTCH;lfa&M?_V3`M^3o>2dmPe#_Asx0LFaw{6sQdvfJ-Dm4V2h2+x;5$2A^)5
zat1UXWV~oHQ0t74=;FZNPxsuD&Avo+*?)y0?m{DNmidSP@?*`+%&3;xb5`sxG9Lm9
zz>XS+o&7Y5h?LYgT}4yV4=B>ibn+CWBJ$3w=+S!Mes-rk1#%;fude$hsJk3wwV;3S
z%54+CMLl`?^en2erKLrkT~w4NTlHelgEKKtZkiS&ucqxVWBO02<Ud2gqUt_&ID2QH
z-09Bo;hg9c@TGOYxUB(5fbZ&7B74Of-H;Gr{K-<kjq;i(0dM|X_*&Jwsn=x8M$%Wv
zmkkn5V=+^4|L_Wu<m&2`VZ7CPrrrDEmOhX04We(d9~|nG^1?zhZt)D!zhkp7i}x9#
z|7rZK>Sp8=A%Uq~vNqSVyO`w!5t%16H<Ae!cM>brxR;mE32LPaaVz+rDYQ}wGx}tt
zo|p17aIY{Db38wYCBjbCa(VwfBy&5*hhGf0j3_smaK`$&#YYz`!>fj>7n=8<;MW?J
z*xG+)ao~8A-d~)y<UOJrY0pw6#@K3B`oghzjFK(2G<`M^pBHz{YV>gdpV~+C?GPLJ
z)pge_6WvEYU$O`iWG$JQrSzwrd2)~tI$ByMBW2?EYQZ>9tXYe|f9cW}?Oi2fbJ?ha
zHwRxoSSq6;o7LSo1PNY_Wg3YTHY{apeNN@rdFrF5|J1fQp~CN1L|FG^NKM78Kp9&D
zqiIE4h=pDMm@>-EZSdmlqo<GN26@E`b-e%C&!#Um{`@InZq9~-gTn#VZ-@{(4G<ED
zSh%04s-8zBL4&NG2|ebs5}VfnCv-2zXEk19oql~rcKvil9o(AEvgCI}j<5nFIzr9Q
zFt}v?yeAXK{O|5)a_$@fwVx8xI}nfPj#s^g-tgwFTTM(V3JPz;-k!@B^FaDw<~Y$V
zk4tP1YA_eeK#ua;UI>~fNii`jNk6jJpfjSU$p3W~{L;b@?fu4=y`l(@o)})I{<^^R
z@mrDoyiKXw7oK66oB>vx%E#B2(|Px$&FUx><n;Z3Ms*D!hDpd$lg!jw@T5i51Aa83
z)Zo{s2HHqoUj8+>9%GY|&i8A(xm>k?uXMii$KTy$z?=)p{u^pxN1f3!hop>*w&|I<
zxv5VY=GBn;9oTeL(2fQ40|8)U#RCW6ITXTksAlV(g~qjS(GnL~e=<1xp{h2Tx3NtA
zycblIOS#7Fl4@$?P?Q3rqXUkQ4(Km6y54gJsSMJ{%E-zFef;<q>-4#*sg$4DR~}&n
z#UIgbdSt)wIOh^&{!L#u#5g+i!?Ls+W0S%Zz0)I~v_~Q-7-Llr=A|S&pYPVMLo+h-
zx_T3z`LwD|=qCy96C{5vt>GBnZS?r47fC$V{et`>9>!u<RG4A{9l<G#(o_i<`rYY>
zZkHiD3W|5-_E$$e5&!j?Z-vNBejj6GoEScsLVUj4(I~pR!pMoh35U$Ow20mQKsajE
zAb4_HbLe-Dd}G?%gVE|swS&A)L2rqlpEz^>d^CW5z-B2h^1Qi#IgA5+a9uI9h5VzL
zW}@29K9+{2gOTd-5Ce_i^viSmtu703TlU(y65aup)*5u$stz+((`;C&`W=qaZ3f6%
zM7a9avZrjl@UjXp1t&MnK8CM}`td1Z+r5f!;q#-%IHI-U?xN>NJ?#|O+#clmw+fv@
zPkqKSFrOOn^W68x^Rx{~RMcZ|jV%88JiyS|?0v?+4PAWDnNwJst79kQXR$nLbT3}z
zO?yXA2zS>I`R9M1^miQarS2i7BL7oK|27CTM=~rPFU9_C`C!6A+B@h2;q@NRwQO)d
z{plsi|7kAE{?lB-14Fb;l-D{hcm-1A>_=|CqS_-?jIZA8Mh}Y*JyPslqOXgK#;5Fi
zY~@;iEaUL*OER89UEfMxmwX(RvW?^e#jEjK_u|(d^-zrQD1Qwb!VMG{Fyj6|wie7b
zAd8`i=PR4e@*_)`Eb$5@rI#=^w_sjjd}rD7<RgQ$EoEFmTuAgaLF=vu{hfBZw+hbm
zUXJHGm015#DXQ$TYT=9S!q1;|Nj)<fByyK@Ch~U*ePw!BCT-<c6Df&ugcuwmi-fg)
zKHT8FF)WnfEEMjj)EA{7uVR*>HY#?bR5Z<>$2O(l$YALSbJJSn&#cdPs?7v%YV)sH
zYslG7cZB<r>%SPYW6pg4VTOb1^fS5m{fnVCQT2|^hLl6w;@6m4GNxxZn+~dX6BR?L
z!YpSE-pgg1hwZ$5n{r3mP%Wrss@v{)I9|!Zo00ky`3tLzeJfqJF3XQ*Y8~9s*|Llk
zK5WlGn(>FH8Lu@N5Q1vB0o1rpw6y~&Tn_Xgrk_m6{$=9B|F>Q(MBl~G(9j-4!N@F!
z?9<^~hB%Jf%L}S@pf9lpB}$M?!b{lPCjjNMcBZNYH|JZJK_|idEw(yZZVAtrf~-E%
zfpffA*y0sP7kU56gN3-q*e8@8&CN1VV5=_zzgU(*6Cs52<8T|d)q-e|%aAVUe7zs}
zTM#0VfGDL3ti&9So6n&I5mwtO2ki`eXbx(pWllKYg0TqXh6t_&86KRe%K@&N^be!>
zE`$8H8r)p|Ahe<s1!z7<X7Kb02;*LYm0lM(*IoGcZ)BSle}A!>IkU{_Hy)bqpVrsG
zWJwf%tMhw;DE5S>=pn7h?)d4l%`RCGF=ETe$UIR~^Y)~6ys2mepo(h#3t|uf@k1MR
z4x~M`ki_W)x-U{Vc0(>v^EzQQPrv3{_^Bs>_OF9Hk!(0*16G(ONTdqv5XU=<X3-_k
zB2+_-{0%yxaZnT0K?>(ukK*IOW<>QPDMT$LEqwt5quv1e>%gvoTm}fX><IqPlzbx@
z>4vOPz>2*CVE{Q))OrchXCX}l=ic(I<aKkMd=+&QL3%3$K3GS<1|1GB@V^_ZgDv~@
z3Z`%hjC^MWUdfF`yVhQo8VAMG4=|cql)-Nsk%L%HJ7EAHc3eu2C<Afp1Oz)2^cKTc
zDFeS|gdwUUS&^|dobz<)tJQiSDDcaI9^L<^42YT?;pW4p)H8SOa4Xa8UBgs080X|w
zR6M)76r7K?`U|)~YgPw`1X;qJG`J4Cl#g!BdtGQ%Bg$Y#LETjzM9xV;1>TB$$gtM#
zc6<dgP1&3`b-uw{L1XC&MsaN~aspIIufy@)9A*)H>px>?SD)LpKX?*;6@-(%-0YN^
zTKFC<+5T0S^X2$mP(+^wfK#Nv;&G&?$iXr<>aL}wW#4{XU0uYC(cnuyKiKIELZ?aq
zntivw@7OOewYDpUX>V_r($$SgKl=1dxQMIP^**Wx>w(A3_M%}@S{DKh#mSIuyPU2H
z^ZHkT>q#sJmx2w<Qn>LmIMT6wz9%-zNTsIdjd7?XB%!GW4el9);3$xHH@+3}`S^%0
zln5K93`rNx9Md|}^gK@@t_zE$A(xGluGWc5oyJ7zm8DBQtjJK-^7y1;7PotA`kU^>
zl$e1d19Cm5$HEb9rzB6XlX5s#-~^97pDYvb_dlJq!Js=imB+OiG|$KtoRzCI7#On4
zI-h;E#q8nG=M4kWaeepb^jx*%RxVA>09N$?JSB3$AX&9Yljdro`uC|GOOo;!$<G0X
zjDm`eVs;{UtoHLXBI@j7`poMl`=ySap``PA34+9m@6h?&AJ`-7{2H!bHWvJ(h~>G`
z&V;5Iu|Mh3E95lk(>)M;je}`@CUmZKOS2w#M_8k|byv~+ps6lCG&><X!GE7y=78&m
z;2__&10};n7iHEkQ)Y^nk$`KTb{mX5{_Q5_M8H+R%*?z7?&wKS`6JNQ%X)I-aZubb
zBHmR5VgfK*BqgQGO=x;%#xOk^`UzE*_b~iCx#<COQNI<6%a$swtv-Y&tdQv6)n1iZ
zdyf*|Ig|VMQQLyIC+WiK&Z4_w%W(giV|h|$W&=z%YagQz&!9ML=AZQR_36Qwg|sz?
z$D7gP-uDX(hFiH?c8`wFg_%D5g3V;gX7TSG82kp=T3f^z`XwYJQ0^cI8dzrs0s>Wa
zuv!_drVP+kzN>=+e~HaPu)~MAtgK5;JHI68g0h4$@>*J7)!N3)ZA(H|0BlnpoT%}n
zv8Rvp`uZ0w-RSDunOj28QhfKl*y<zgLt{B=g=C_0_>|`}`+b9hgVVMEg9T9jTWcjY
z9)-t!y4MJbm>N|~`9QR4wDgrlzd$KKidyB4gMEXQXz0NJ2sK+NJoE1_^KTs-hjbmR
zKv#!r8=ynNLdk)l0#JLMTCdB%tMbQoK2K}~JT%*|g#>~9BZL%ZN?|P3Z~<kw*tJWI
znrfUae<50@R}4t|j2w8B-UfDbnwTez*>b3Y9M;$7)kvRle<Sz}{EI5=?Zdms9so6;
z^wp>Xqrj_Qe((!S0e1usbN~5TG&^88zEdAS699CL4pen$&#QpZkyldk0N;m*;#fzF
zIH%?0eduhlK|EOl0)2ltCP^3As&EKLn*GF%3Kww^K!!L(erOLBVq(kD5-4B5GsnRW
z+#bRVa3=WHJ>aCWi4aA(YVef2h6r6f;E;<TD^}x>gylc&%<XX)4e>Q7I10kpp83E>
z8izK!Z5p9}kzJIVz&?OVkOUbg%nC=|gCO-Z3aDznG}Y`=0FCGN7QURg_wcI_`A3FF
zrvhC&To5Stj>XsX;R}pW?ojmbk%k@$**O$ozSxNMqcvTZ;eSJKBf_`c^c`itU3efE
zPjc6`+5Dy7)uDdWf_Aw%g*3LUu}|KIsO=!FZdu##p)qxZ{$C9AS4}O|VuqSJ>i3f}
zUefl;78I&0^fCDFtKRVykdaD@k1niBD*ZH+6ql3Mjkg`U<+r=-tTVIX+Ap(u<0wCD
z|J%2L-CxEtPdiv6h$GW%3iX&r>Tb3(>8y${Q+=DO6jEY%u_+dKyC&_O;ekmPt(l<I
zy1g_X(YbNXdf$FpixX$YsJ!?E;$#u-AS=z~&%6y0(Nntlw|X0JdgFs;^*!>73S6zd
zn(S~hePu#1yaDtuH~yN{51o2o(4ena*Hx57%+)q|i!_vzG(9JyQ9n9n!qCt{Oq-c%
z#Ux>>$F7RZhF008bUtt@FLP3E-;neXdw@o6ky&)f(OmmMZBpb8UbL3|_m{R2mP?km
zBCT%X`b6*h?65bi+EA|9=a`9ZSx0S$I+*|Nvf3D?HYGU8HAT=&JTeS`;|<W9WI=zl
zJY0OG+-avCbo-%C&Hs<##Xwl_RD7l?i*^O2;HzJ?q}tA}CnqP<JR2T?aNo0C^n?<+
zhcl>)lzf+7-z{Jt`9GlX7S4LuaH10bz_LLdPJq}YUe+&t94#{6{k<Kl#iM4Twby4h
ziQvIww)YpwyS@qd`uLy=E%VR)vzqrhiGj%j;NlPX>Hz=s2OESj?4Jj?{~c5RurV94
z7ycrJ|I@AuBhUDY+XyQJ<bkpPO)HN5b8+O1iRDzE?Cs0fyVa{YmJ^>p&i&afwMUzR
zv3Sl%AMcVzTh40A?^3KR@G1JZt-WwvAV{FdE;V#?hoo1x=Zh5K`@6=>RLi;vaXd;5
zB)PiG?6<3AzTd3Osg(&!f8b`}*xQVGW|W{-9x016ETk{`o40P!L|A#6TAY(Al$hZz
zM(o*nQM1D2tNxuLhWW<s$8UGmJJFw{`KDJ?co(Ku-&s>Hg_;H5-Jp?ES17uvoSZ4d
z=9ZLY)Zc^2k?BpGPB7bgITT4H?spudBa!uSF|;tEn{CN~s(I*krV_8%)hn+$esh&k
zM;HGrnX+-tQ4b^T%hy&n*$BCusLw2+&;ElEXR-bM%_A!PgxeO(btDsJJeW9F+?>%*
z>sOSdek5Ud-w(7eze#SHF`rtSp31IS;-?fWIBGcXyL$VyO((A)@l3s$zVFtAjn(;H
z^@T=K$%{l~V|=0xDPJ&VPybMP|2;=Rd-K1{U8H~DKp4&c=Suy9+W*f3e=gmBBlQ0T
zN_f^bzitde38*>5=<H)?^47}?jBzXng_x;0mZj0@J~^zO__5a_R1PIaiuskbs0Nj{
zgAH#q@qRm%dx|+TC1i-<%F{QK^TRC<Y_iw&3?jXsI1wvJ?aAr$FkwQM6}3;gW!yGB
zLPytEVX#v(v`QZPaTd5%-l!2`qnbSG70)&zw>>uIFI;-~+j;8);i1<*DhE#fCNqi5
z_wiHJIwr1fQlHk#!pV~M-HE=e_@fSGp!kIU@YFQjQ4^VW(Z$HjB7dS8!Ow{|c_VN5
zHn2YpA2jFXk{75y$5`MKL2?7TrWb4Kw^7*4%G3yvacRif&xR`vAE#xKguC61bF<eR
zoziUZ{4pNcTJ9{eTQ*S+0}Azq7i&l&Gf$xh;|fx5F>FL#`aYF##Vj?T;R>eF&n9Xp
z7f*Q9El;aHM54tZ`nQ{_GdiA7jdmbSqs#@Z*fNkt*=knh+Q8IcVzjnar5~|<Iyz3T
zUL-luMcp(?aj8=B;I3Qz1zOFHe;5>5!e5mS&RZ76X=Hu=zt79i@Babd|7BJFg88Sq
z49c+C5yI?z=XnLQ9niO9wh3l(_c(m_(rZ{o=QQZFI<LcRge>%*vRAc^2CiV2P#Y0c
zxe;Q^@%iZ;8&mSlaro@K<NJN`nOp1Gh$&QsJn_TgyVq#Ef-<@Fl1M&sGP8RsWn*>C
ztaBQr@SEYtb_wL*6nw=`y6-Q~eoNaWe)1xzf*OTHBA3;w5p(9EusU^q*Ry@~1%bGV
z&rHnhPsKSkq&1=}rzl2AX;d8|rOOYtJeBvac40+6i<HGwyOiqR$(M2=`t|j=jgcxb
zx<FJyU|L-v@SI(IrC_J)x@`h)654D3=JOt^X>E<0aydnGVtcOoSgYE7d5Jf_T*>Lu
zwWcY3F6AI)|0Tzv`0Xg^T}jp!oacQ5CC|cmeB)KmE-QFOZ`DY9+B+OX^`vJhRg_Wh
zob`;#<Ja)F;}6g?!eckpyfV66qN?5c`ZrrL=j~Ek?I+8(ISy@=OTLDdNtS%7*I+ZL
zaFOUaUpK+2lqoXAAlmTos_J9220yM|A`M1`^;vlrF=fiDW71(K>APevyElxQ6{wj5
zU4)eVZ=1fp;@mc|PuaJT_2Y9legh<#`{5j!W272VJolNuS7t}G(Q{5kk*D1~_{QpX
zLxj>TMr2q|xh(d=f5yCo^pgS8rEP+DHLSB1)@7cUf<p0sN1acrSke=}OC@Gs`tD(<
zGyjWw!?m?tIDp6`!f>uzUyP5_XF0p5Wg_>qnqTdQzbfU4*F1ICtgARJVoo`1ur213
zaL;ZWs=~^<IC+gGEkoS9n54?M>C-~@r}+&Rl*mJB$LL>`!)0+8%GKDl{}4zqK<A@4
zOcXHnYbF?8w+AdHODKw_c8q|#Bv;1SMHXger1cs(#q-MfpAVeNVYjR*1X-mBw8=*)
zvWs(%@_kQlFY-=cV>4TNg0BG}q386@xe{u#!t)Y%z=Wlhp$q7Ea53%=tuJ2HrZbS$
zdv{S=`mmm3@qUv`s4Phs<%_oo_Y<X4W|`GT>tuHLzb^9qkXbztIC>_VefC4_?ZK48
zw`n#5S!ON}BfhgBsQlTVM@rKm!S@`QZRh1I<By@E&-4=L^U|?u-kjwEAqvYhE&Zdc
z0ht58t$`nkKm>c=@_eYiS8tbV=(XgP^~JNRI8oTQ)zEUNGC!XPTP-m5{blB9J<Z7i
zVWN*FD68B{4#D_)=vF=M$QDQHigV`5Vuph(_t$x+!<Fepv~K?N6!$q8ymgMLrGb&g
zI<c5(mQW+AAQaCkLOckYwK_3TH9s_iN!Cpz(4kGrb~?zxzdv=<xK{2U+Fu4s;7%>Q
z@{oS*@(m}79eMZtAF>$IJ0Bt%MVjNxWI9z73}!`d5tw~k**0B#%<FaIXSn^?OD84o
zcHQOQBKqAV4Xp;tD(H$yPN}T~N*3+ma{-nGK5OAAcM6#0-U{nPnI0J|n40<c_`C!h
zr|=o-ULIk|dgtv;x_eMYkWM`{<}Wh{v`+6og$ydti+S?DiXmBE^ng1UZYF_C5eJpW
zpJ5H=2>x*aI2VPfxw-iz#NLfVQ{AMlrL6oO+}4ChZv<X9Uud4c8AH}1^(runSztIq
zkCu^t5wQJ{rCY-RejpowUPkIP0ImKW?Me~tynf-w1P8Rn?*Ymo6p3a}Ma$M}JbUI3
z-VJ@|tq1Z=N#O|)k9GeLPO4}OrUr2bi+bL9Ac!R7<nY0&>kgti{yt1FC$6zjvXV@u
zq6uS~b|p0gPcpe~&~>=IJWYM?yXW1#WDSh?e0?$P;`SwhP_t~$j)e(X*YoAv!X8?N
zA|6^MGltZ=^{xal{i+K|YvU^gchZFVJv*>97Ct$i7Y?JIToLM!ncL#-`+lMlo98x_
zrzMvi%1d((qEc4i9ffbAf2C47elGmFZGl(UDww6{x-WQt%A4k^@VxlE96{u&N`V^9
zy*X?r6Jg|YI2L$zm^k>+DA>)<iMyQtGT|9*Mi3(?v}t}d@9^90bkYRRrWR2dw>#Uk
zn=ZtX%XvbTm7(~QQk-)dCJpe}`EY*o`<%tD=d8g{vSoFB*`u`)&^DyLSC}(QbMF<!
zRknjLnlrB)&yQdlJv)9{F2($yrfxaZDXtNpAH9~tojoQ#uawx=7|@Zud}j!gbGc~i
zpbC&I$`h2RX1I_8*H_2IThp_%u@++$f0QENwAF!=p+S(S)<?65%7SyD0b;(``J4!7
zLjt3=C=-oiP`V=HrWmj=asmt2%isvy^XJ|oKpPTortG`(j#R4(!H@vN1gRo5xQS~%
zPzfR+A|j_*VHyP-@(QSGZvl*mSRR#BRHndGSpyCU4`4N@-o5K{>tH2kN5R`&DFTM2
zGeMRV%yZaJpFSO^a1nIe`Q?wmXaEgjq3+XN_JgSnGT!RFF4I4OI}QwWx-f!<!}+G^
zZJ$1<@xiA3XYc(r-=9f?sFswJl_wzu;Rn2lHw=H+VE+CAYTmG?A`uVuU^F0uKwW(o
z;060Nt?~A^SA0P)L<CyLT2L)t0!b5yiu2XW5I7OSuHHe~=V?K^<tkueJ&-{GEK4;I
zn%4Pi@(ZsS1!^4mOOSr&y|vV@59Z8W@D*~t`ZcWVONv6y9)but?15Zk0zfW*gC1%M
zyoO>D5@*5v7;V`6^NS!U^66m8_5`p^2khHLfUjDvmhVh{d6lMpOM~8M!Y{-9cJO<x
z40LOP=#>qe#v`|L`}k*k9MxLx)o1#1?(?wRtNhVmhA-tC9#rX>L7~*?=&DfRxL`bm
zGlkPw@l5GcVrsFFEo))$R(+@+-x1x=+q~ks@7<0z`8GShHt!ti_)zX!GD}pBI!RBF
zkDAu*u`^p-O)#A&ZGS_nT+&fQ@k2$|S&4T)A@qZy)0U*@uMzW^x_Q#Zmjpi1w|`LU
zpCrsLDtbU9#8D3UyitPS4sXQ*&V`e8Em@VM$@spX+}ozc6yk^0;#8sj3J+%kn#7ov
zVg^*TBjdMP!*^w*nrE6{lVhI<pbrwFbIepIg$5mXS5kbHc?_mEo?hmA=HPxrYL)BP
zPf{iug|FhIkoGMh$C<dhPs^%u^=Rlp7crY+IWB63=6mH&W(xNs)wYRLcBgck^dS5$
z{%`J??nD|3j$I}7{>%)wN>2SK4dyAM9Tk}(lj{_t{$_m_KcS}Q6>Z!Vv`e*0`>tlK
zN|+y2i;4sxn+nP9q<BU)r*oZOrsMBk?g{~;PdfrD-A7$oo?_+)0pS7ki@pLBX=7w_
zL(L<3pR-4|AHQ}G6+FyzF9Nr!)VEiwqlhSq^#lSz@u=;`v5@f-(aZJ`2O@X^+@Jhl
zh4ou?S#^pygwX17z$5-Zr2tnH+Lx)cY;*SfM+>0kaO3!Rr!o#UXsD>x&oawvmv#;;
zA>(5b_V)bHCD0#$U74~B%(G?`>?i<f&VgT+ZF^bz#M2qH`bZH_EqAm{d}wHR!*Ofz
z9e9q<A?cw*LbDcvC8xU1!%;$h2=)uB3t8^2CkJEth;BsK@%Hvg?y-#jeL6C3ql+2k
z+v=d^#bQ=YLn5IqK~kNky9ql|?Zo4oME5wz@@8BB3EqVhkw1WU{tR%nmYNn|dquf#
zv<bF<Isrp1HVW;Q#>+@)!9r346si}<k-q^BjWF>d$GiIX<2uu}hQ!NIFG0qy3vmbq
zT*So0Ny*7#C&zu6Bxb}GbU{@hTe3V{TW~6a&CLhS!ZNDs%r{kmde%xJrBTNM?F$iJ
zx#nPptQ&kbkLP@_!tbl8sr7xqMzU}%;l~<>R79(1JIDsfM+q{1Vf5Y~^qG~)0`z^0
zOG};KAJZVXCW0)uW1R*L+6ywrQO=4oPF|!aS4d}^0G)XQ-ko80q_QFO4jljO0|B*!
z5L{v!Sz8JU2O;nW?{-HYdw{rk0{q!O;9zmIX#@Jzi7MZRf_eQQNsy6boz$Q~$ca!e
zU@OjoQ16GwkO#?WHT?ki6wZ%#oVL-xqqtSU|9uH&cX4Exz?%bpr552_DBTX%b~8`*
zGanv<=;t@oa8QX%qfAdjO$9N8>mz5d-5WW`HfX3t@TLoG59pJLIP+<NI`zz3u|qf(
ztR5`fpg<NnoO3%iF7+lwfr3-7HS!KY;jk4h;#<Z-A@>X<I8Qdx2egKm{<NoY-PIKW
zojA%J*bIb8MhxufRE4T~*<?`q@5MYx-O0}CAPzKgXIJ5!?TSXa7W_5<Q#oA^?V+%<
zXcS!hB9K6%wGYbvm)(!<OaPT*c~}>@c5w9IdJawa?Ty3Z*@H)YtXi3C9SS#zzz0(1
z-Wew~1!<W-fTgj7yJG?jD=$>mPE|qlr4Oj_&w{v?Mr41UKJ8g4Nt{$bJ;G5S9*;+p
z&$4u|Kxm0@K=4AUA`q=wf;xI&$m9V_I(cpuU@KP!Ppk~}*^Vy2uRB@Q)6+8^>&x~7
zl0n}iEDWNj=4t_;^R2zm2k;Y+z<wa~)$Q1!3{LMtbrlLCR`7^a{J+v(i$0ntP_}@`
zmdZk2{xWJDI3)?O*E2EO2S>=7f^)k^GbWE9S!4}<QXSZsc0v4NagpNodFZMHkiC0z
z1w#rXzEmRGv<??lTwHt;;83^`5p4t_Itm9~3Fwhflkc&ybf)F&>sB@kT{kw4gZuo{
z20D8(F7Q43vu)h@8ihSQds>XisyehPoLN%^Af`1|gORIM`%kyaN+=p)J#RqZNjQh@
zsZqBRmojkjf^a9?%mGRTAgynqt>ZEssf5geT?i6-196pC!J)u#?q67YVA~aYqc0sq
z6o$Q>!)x11{RI5{{J-sUwj5_^>SnF4t<a9b`3dx}0nc~DsAc1mbDe=7&zT{UXVO+5
zWUvns6b1^+uKq>Om+WP=q@}%CKNR@wVLmWi^E|Je;S60ccNp_k>xFjz7IV}G5v-fv
z_#e8mWvwz-HL!b4k-qHQ=j>WmzFNrcD$X=mPDD|unH8voV^^EKusV8p>h9-Dd(W@D
zkp7VUo#lus!P+#?<NCq8Xg!XPby)IHJn#ChA?%d-kr$@w-1&{w9i)PLvlelEK5AJN
z9U0QgIqs?Xgp?f;)=~};kQ?4Iu{<5W@vuX7WIIr$dzg{>>nnxN+H|T?I64~=fwu9R
zTcn+i*X5);WoIAeoAdaS($v+nALQOL@i$xR;N9Chksex2tKy-GP1DIQPvTezoF(nc
zZVS==-5{XjxrJs&Pgz#SkT2EUqK+&HU8;IL@#sS_D@T1!B;7y_`!kykk`3G?LZyNa
zA0}`VL?aulJ;s_OSDpqr-jSTTSYOl@vo<}G-PUZl_(XB<r_ApnUrGM^C+7tyrz}(A
zz7}M@uUE^kY(4wHaoV!ju3f;uTIjcHz?zkMfZXYbHFJzBsclX_?N0}DpE)9`uvyC=
zE>TwUxViP1<ydZZ88?*dO1TU7@1^L;EJh0dNzk}8AWSdP@L30lZosWP4iQOtGjMDJ
zag8TI19Wzl2P=if8MiedoVW;-VOhXU09{G1=n8S^=g*uf8h?YUE;M@g+8^aJ^r-it
zYR#&>1;zv%DHCuSU2~EHM!amcW)Nyl46A6wL!`gU5iT3)TBG&?iv=DC;GuFOs{^{k
zEXV~B0&iD@#xz7!2LNq5FuL0LiPH_!d1m_3cuOb}g}n0bI{y)YI7jWlK4S^t61pHb
zA1HIMHd5oGtcSRsz_73|+lJSBY+l2|!>z23|FBR9#SN^nSf%UHORx>;LpZ!@(MwwB
zAB~tX3Q&w7iq-!zz2rC?El~@trza3#z*(P%$OnYvz&tI3j2c2jf!-P|N`p`%z!!Ub
z{!D?CVoBJ0Tp_KsP#yL^=tX0Sipb!Hl-l_<k`0FkB8)W{hv+gY_Frr+hPv+cB7Y1l
zd-}~Gx5D|Y89>PcYI!9vsZ8uIWm@!xzvBjQGWhM^Qh*GPeEP?tFGMiaL?k3e$KNb2
z;*zq}LPw9p>Yx@pe=tHH0DKGdz{vOo-Z&q`nNH4Z1S0{E*Je(UubjO4r`E=iNdO^d
zp#3F>rk~q=^UMs8=(WJctFvldbCEFmBUCD2+nf9U5-J6{MmGVBpQCj=&;|3~Cc~!W
zC4b33tqt(`RS>i60aVpk_HbhmeYP2f7jj$b>=ss`oYuka8vti>bXyANwo<v-RKV6b
z_NK1TxR%O%2P;h@tHP@Etgm@C)AXIptA+|T2lX+dZ=SvcUF(v50`tw|XZ7i11sYkq
z+vj}7WDCt~cqh-hn$7g8icS{6^Gu^kDO_+r6_403pBc-TjsXf-u25(2*W>J9XIzr`
z^i_UI=P$$N)v+2w3N{)a_70x}7SwE!u+UlKlCaJlnZuvfUNyTku93J~KwojTWjK@7
z9`}=Hy?xb#jdX*8JMuJ>tg0E|g*t1P++t8L?G{9-+FcdWT5L|=?2k;_q}KP7(i~-p
z9@oekxM{L1TXB}To$CeNgSq$DsTgM?JM?X2mEM|Hb8XX9CVbry3<#^LHm`oeP3`Go
z0)M(WaaZWU-Yiv|m=A09fp^zofep6-hE-Jw`{ePGNh_;r59wur!d0I78ft+%zua(@
zrChE!S|eP_KfVD;xZwyY?%`evXh62iT0PE-WE{vQlwk;q5teAgju9f!EWa3R(qyln
zO$LwxGN6Iu5EM)_ukTi6qn|ya`X2=upNLa81*b3C=4|}s+q3I0#Q*NIv0Dq>-wA-!
zwf_Bv)eCF|FevtX%YhvO-YE(+CU{Jk;I(t7urOB#2=4Pywv{N>`EPeLj4?oqcLuM#
zY$*J1iwE+*$PUo79xiF0ym&bXLOMOjsmH6>Y&cVj6+>;OuavJVx!!rhzF@i5`b)R;
z)b=}~F;_*?1bUmt_wYu(PVn^M29x{7&0%B-g`bNJs0Ns0))c7nLn;Hz`5VzpYF~Cq
za#6k2uY39o*a`3oyS^-tc(K_;Du1!W$gtKud0fC&!Nc5a=!c1-Ge}8^bM;+ICsvAX
zPhuCtM1K?6>@?G&O`+GRt@JeSoYe5PFXbOAJ9|s)pueFo>PhAFS_M}|(gv$IXT_uU
zi&-N~1|f5p2fMuNa*<2LRQRJF)<b1HzWq~t#by;e=j7V33n;SheXy9a;$R(Y)xs|J
z_nn$(TVG=pa83=8A6<H>L4b1iH+nZXC@rAf<Eo#qG#|d+RfJDbsC6SbV=*hVZNjqN
z#e7rc&Em|;j$-9*vc=Eq0ZtljU8?>a_L-aq@9LAIe;tlv#LNo!BUXwAPLYrHMi^<L
zRj9vXPKgyd%Rh5wCXVJdlVsT#c)el8w@HhdCa*M{>H0#qCHZV?^8^Y_o)lanF$(L2
z$4I++&&%Sp<CPMm4gB9QtG_@d(xvnK1t^i%Qv9XH;MwYUYFR_H-q$V>U~Qh#zyGLE
zKR-0=`WN$%^{IHbt<M(x3;-TWxoq~W+^jV0f1)C(M!yhC>>o7CHPo9Fb~{48&oekK
zc#31pk$SF>KymO);ZHUh{ZhsFYcqv)*d`v>f{H^OL9;pQAvPt%rRg@T<+{Vpp;kWo
zB61dV8FSkY92W2Fb4ngPdt|#?qP`$B<aSwKV=7+gk+SN--HK5BwaC~<c<k@mnmaTX
zHFzoKDAo>CIa|~<`}T7Zd*-DuEk)04a*fmid}l+J9t;h~OO`tKS#?Ah<zr*3S~puT
zd|%<UP35Iek##E2uTc$Xi0PL&h_vcBYppyiQQdqX+@Sh;tZ(IpzgggiqiX@A`VEY?
z<dn4=o*yzK;cuuK;8_IrmQso)nEK)AIAu0SG_@?%`Md2Vqp9nn8gO(*8D~{z)|Lnv
zcZ!QCXildU6;M%Z66BIc>h+7Ym$^m6cW2j3)#;)wokgfCC4b}HuJBbJhi>`@GRi;z
z8Wyy_b{d}a_e;f8{@7Az)!jkX0nKKuUiMp3a}=B;bO{8zfmugPjI|S<8Gjf}uq;C0
z-8~kPx9xMAl0Ef`02jd+MQ2#*%mh#RD@wfNZvgfMWY|PR<FHABA`KgS)$h|E0!A|G
zdSK>9#(4_bX_Px?SYr|s&mrO?i0g72hfS{z&cN`3-C@&xB{U>t9Kfh^D1^<|ve;+%
zgv(Zhig|J#1v^PLgiD2lgj}P<*N3))jLX0)9h&xy=-+$Jh&<~zqR2&19L@&Hw~*|J
z16p?ghrrT%3J$ID14ZnV4|7J=qi=|&9>iMuph|{gkM8^ifdV}{I{`ArL-p#;lOrCZ
z_~-V0eg>HZAtw&eLV#aNr$6HvB6UELa;D(467j@gh-X5^-f=j2ssYAmEELjS%d4yV
z(2Bp;fyM}UWdfK<T{<o_!l;vt9^^t*!Jrw~<Ob+aN4e9hKk7S}_7UUUCN$h2U8zHq
z4X__xfgwmc@esrs_?2S;Af<w76c=EF8aPXU1El?k6s!(*Z!Zu+$G}0*h_tQ(2AnC-
zcUc=9fi!I#e%mT&e|~=#J-Tpoup<Rc$uAJqA@BlXB(b*1o*(}QYW9+RdAQavg<KJs
zg8ku?sy|;>@D&>(pqpHEJ2?>RA1kt?Z*FN>gRiR(5ZW$yVC_3>5iJ~4|I;YgJF@f}
z@Daf`u=-Lk-or68=RimUi2|{Cc|?eM8bCx}(Cr|{7l@*5%R&2wuorNnz>9xF62Un{
zbqM|6Z%Cjgg~<y66A@(+i&hyKjq~r<W=Adu+qwWmAd?0hBrNO<y&E4iiilE@p3wWQ
z*V`E8Yb$|wan2{WbErL6nAm*fho=(%@j~aubKWa{x?iP(T$*GBzPxOdnG2L?N~4nz
z`0QA))3K8FL6X!b{p;8AsR5x7-bW(Rq#IA0>kOv2CykfnquN}y46uFWqY@)pq!>~b
zsg(Cy(v?d-EVc>K9evR-nAvMdzuj10C#7<;eK&FC{1dfN5nh}d{sN1)+U`Hywn9A!
zN^ZQZRo8?j`F`|7R#dpB+wqJ4@$!8a;`qEs{zghg^w4?<*$1Ju<s9_-TCTUx5J$u5
z$ZR2zu)Lb^>1K2R^UzIdsbtk{EAtwXsB~^WmLUe-5{H{Vx7jm0@dL&vxW29&49Tc;
zho|z`IBePYG2UuJnY5MNHjk@c(|WAWF1Iwe9sN<a)lgHZ^VnM<!f`5mYASHY@J)eW
z8wJbTOZ^g40y5d1x2}j_o2qvhMmbQS^$#0g1`mz9%sy9~TA32qJzRM5?vZBQRNzwF
z?o_?&#uM%ExyvFaKA&KumdiTAENvmOE_*OQts$-%xDT+?5qIMJ5KsEui)T(@-*VAG
z#FB73OoDa#>i*7ZbW<e^6TiXjI)&V<XGt{!o7iCj0C?qMrKpQL^sJ)QFirSDU4aA7
zajB=S@8?DzU4#snIz(NGN!J8}Hnj0g!^(Xi#~OA!IobtNx-TTfS|GaE&w0YJQ*nPu
zmizR3kbdh2=PONslvKjSMHsYR6??N+mq*JFzAbHod9s1h`eAO}I-Hz?dv|~D11y7U
zp)!UdBGCkqcPt7*Y4~1Vv$9Iljy`l11y%>dY#puBAVK1zJ4%i0=JluK@7i8P>K_V7
zmUEBp){6b(?~A>B2qzHLet9+O4d@XC(r81q9S5P*QhFipgJKLE<z(b<JXW!Zi{uVR
z<}ZUgU&7Kdo0Xjs-#B!`v0QC$_U*3&Q#WfXEA$mIR75I24-e0!Nu7VT-Olrfm=^)>
z?IBeMy?3%kbJEGMhL{#mP%RFP%5x?q;Tr>X!u=5+1r>lDoqgW&+UBJ{d-;9(fkF%I
zPgZu2w3?KbhVHccnTmg)ZHVZzuuw2tpgXrCK<PQUy$U-C$=&UAwR?Q9(EhXm{^Jli
zSOtn@L>oH^s^EHLn7nFUgtfP~$2#<@i81;j3cOUVuK_))p4*rJxTFCNn)e3eODGOg
zzL=8Q0jMA1v4$ZG>OnmS&>~qsz%W_5T5%P&4!(_6Zot$n#sOTaMigjZ6G|N%x=cm-
z?2nSq<M|ml{Nm&-9Gf;NIJSom*XB3GC|t@l`uPL6Fih;q2Y^!HJn;tZcA>XWv2{SU
zos{%oX`O^s-2?fgkRf>ufD12B@=buNw-)fkNQdyUV(_xm0TlQKV)o*IP1}XEL(l5B
z*!qw^@pI_Ie389EveM#s-F?$6$cv3~Tuk1bvHG^EQ<{;}_JmJTHM<4pG3kvYP{|0G
z+}>esSyae<$P)Ag8+8l2mt7}WK}~FtwwImxky-OIaoT1kxyad%7vE`mCVzRT5LHH{
zr4{fseS-o=fgqohzDcTA1u9O+r(23QWYmW#*kmoIJN7DkEoC#J!H1jB{JGD7k$ELv
z=8?SHzH|#^yffL0w(Hsn-(6<oc&+BKOS3w)*qDP&PToJS%n9N(+0=g%@-590PhkwZ
z^{C;4!jLP?N+pVC^3`tf^@Z5`GXf8{xHH=*v?}mhr+5{kBj1O;6!6U{`P5tLJQ$(H
z=2z57b1;wpVVynQhS<b@X-9RzE9Ud;REO-r?Vh)j-`4b)tmvH&gMBa!?Xe0`7vh|A
zuuiN8Zg)z$TuAY?E!j#7OLSK3Z#`<7%DPfF9HGa?@ipLQ+!S5dq^==5jX)yd=iUx#
z(u6!b`sn=PTVZP^-3pPIxmc=Kg0CVCh468<(`m3?$vv#JJOKLB@`CE^P{0}hC-?>(
z#_4kxUpi-%vV!y!+4O>&u0vr$?hanlqmwP|lXr;q9*+AGgV~1HY{&yZQv`iQuIK<5
zb^i3Zl9L;ILo+lZfPs+-*gQ|oBgXgSX(IOY_^0hLYlN)IcR<4~x*H-X#tfBNPrSC@
z{QG~AaER8=JWK9|1?D54w?qO8bf9zLJ<7P``G)!)DY9~&i$n1BYgHDzs>e>@&ZsH~
zKY0UW*Z1@qh@t?yFLco7JKx)vkG5(wyxZkP1c}%2ubsPgH!&no_k-@*!#8+O(eiqV
zK9(Z-S8-cB(Y8;9Zm;hab3|$kn2Q(2*ZcELp)GZNi5jGB8~mKvXR;mYm-N0$lkHKH
z%91otrpNJtWo_^i(RJ}BDmmwE8R#GPWNFt)+jS+lPc~(DCAWoGpk+fYN>M&$S&ZUk
zRplHN8GW3WIr#Y#m)>?xsBfOA?qZx!ieSGN_odu*XQ6ZFsg31p-aOSXn^_CLsDN>B
zkQ6dtpFFYq*u&ee`%9mil=t$LfXi%CFE0)}e95NY_VD`vp+xo|%M$}TuKtZ&Z{JV3
z&%6UZ3co-5V&{&s)>;2BzPiibI7yjWKhR1~1vVH&4e|bbVW|~RFY#vb|0(Z0!<t&R
zeGk@UL6$B=7uA9yRghi;1qDKrCcOxug(4zF>AFx5lw#;zkxl?ZAaqa>QA+4U5(Fhc
zq)Qhfc*b07o%@_;-@DJ=_c<TWCy69v&iS_SzT-Fk{}_F$zE@qLsC0bK%}P*D4;cIM
zc8ZO2$yCeX2{X^SaQlJ9MctW=Cv%hAleE{qnqL;}cD1y|QIFpbooJIjYo%?=!_PS3
zzL(l_Njx+rDrbw6sl!mcVK`Cck#BS!_0PFY<&m-KUl{&B&({CHcRsz}h^hwGCngB4
zVmc1)ZIdOi(3cMiHw&s8q){kmR?%-X)KQG%PP+wWgfSNlxjUu@;~y{e=k1YRZKzKV
zr3DTqb71y&0=^)iY=(EKRq;#XHcDs0Tws21u+ynJHqlG5-}iy#^TVn&?TmNV1h3E2
zkFS;tWr+{ozL2w2Ic2BQQWOfNqKZ<+sn_2It6H_0({@#MGO!74j-xH8P>zY<FWj~(
z2UraUcLZ2TwmE(uKFV|KB0<N*J&?NA)b0=anEob%#27AuTu#+0;p~vJ;^j?8U2<<@
zY4(<$?bka(jpa)&8m=8%W2YS|y7biY&q?#N*Q4}}`8he?X;RM}jn*IXpI$K)tGhTj
zXHaz_X{}C9vfjw!-k7!lFQuYdO@Z0`e3Gx`vFRjIh4n{gs&PsC@y}j1z5P@2=X_a{
zr7Jr{Q>_Q1m+|P#95?zNr7W+YLq5yC$(Wd6b2gO<FYi<YcmBtH=3gu^{C7#%--Gd=
zHezg875CU;uCl(toxwSs5VDDx-@abIO;iZSv|H}Z8nr+2QgL6kV>vENJzLeOiHgnf
zqV!jswKA&4<yH*+p(App(9T`n>X<`bVS|HDiOxpb96qM+qo^^rdV%t9IUnrd7r(CF
za`U81qNgoFYm9l!v=2v`PaSXl^6X0#;Yb4QhEE|rXxL+Q++xc=D`7i(STjvfkGIAs
z==to#Ju43mNlLq|lu!vhUsfVWE7FYTyj%r$Fh@w<^q@Km!&z=d<2S`<x1C~9Nt>~)
zCl}W5O4f-Qv+pf9q|B=x#v!K}X*JLA7i{00kT)#UZVeK3x49QHQ_5EH{7V$RH<5Bf
zN;3b2T8ckqQsYgou)Ax+VMFdJ^_dAhs#QVL{wMM(xZA#RH_?aut<Oh^C|&pDmiDQV
zOZ2Pn9=ltT04oOWE%`&+65WuSZLi0j-j5!*h1Ib1zQAw!9pbNiJb4#uV%~)gS@BHE
zcm?`zd}f1T_2}=7C2}6{|I<#pi@CA)Y?bX^#M;^~K9%Cvozmc*Ftk$Yqp;;oxant?
zTV@rS+ENW;-GtqC+A(4=qqbgpk-{QwTy`(8n4k!JWkj3W(0H@)Y4ooAkEyB-XcXPM
z!B#d>FJRcix~QvNJ)%clpxk&!*vv>$V~b1DZVAis!LiFOh;;`4WQ*rasIJuNoD$JV
zpF3|i|100KlqRVJ<JvV>p$z<mr@Py`q)!mh`c2=TxH}l?KT7QTrh4pjFwxMjy6MAb
zn(gCQe2|+bZEGA&IGPsv#6wyYzxAZ`q>sB}{S{1B%iW*)@|QygDsG&?jPh}7d%g-L
zioRIbNM1H*_50ZP7K5%k?N*fSKjWM}VEF0qvZ>F@2h6@`w*1aRQ3jlr9xS}g6?Pd<
z9ktl++>LJ)oHHTFD+SjmH^h^k<KsM@T<4{JdH>y*(4uJq)qZ&oMTgtlW^V5o2zZik
zsCyg5akgaFP}lbyJ5E+M!{Kwy===M+rTw^rFW4VQ^yBd^)P%Z4mcQ4ce}1;}uiEk?
z%fiW*P}+dAs5*qeCP+drcx%%kA)=LLTH$;cV&2E;>0H{$V$5*j;G(yMm;E(jN3enE
z=5p_7hG}P-Ywk=j&O6>aW|h%9D(x;@e7dlaZN`R0Dkn)QC5N(tmma)~=5T5dnemm=
z>9dijmp9NXze$Yl)s@#}EfjQ5wdMHYgFCTm-`Xs1tXxSy-BMI&5oO4;e)UjglDg+O
z$EqLdp=;l_TG?xHYC$;u5!IRN#uig92I6U&*OXVU$5!BRJNK++jA{`4Wj;QPob2(h
zC~*w%<Z$vF>^JCOe$iANazt^>GMHUl>J5%lS1)AK)TGTx+QYXJ=UHjy?DvFIXx9%e
z(<mk;o;Ro~myI+o&VF&vOAg98p!<6e-S(JEuUzNW5gA5o<ZVtAh2PVqY~&Fkky4ze
z=_0`Gqc^{aN&BN86}UZhWurzd$hN3Bu~*;My-z8E1EVyrDoSxwp4%JKlbJu*M&MS*
zRpc&WGU;xNRJNMcoN)&hj|@-kf!XK&CH9layYAI1u@Ueg^@{An6;s~nSDtvGp7@O5
zzU2}9gdNv77Yvt=f4TSY*KF?WeHy0`(SO8k!^qhDygpKcK{yMA9lHQ9Y?&S?7Pou*
z3!-0O(zJOLiDk?Pj+MS2|DKdNy$=|l{>Ip<hEyaTM0b&tb?F57G(1L9LLh$D4CZkN
zzcdU-G1Z`Qun38V3cI&|fBZahGz=TEgGfO%au5tzQ}{T%03j7bLMWvkoLEmEKWGPg
z%#y>1v;a){b4PS8rKZ4k$_~s#WTA%8ZNsY0w*~fNFCqCY9jX22g7Ju`{#&f$<o}T<
z5D@~69pOKNvR}ujk9br(9H9nEz6jCta)4dTqZYeIS5E!%P{piWhkf+G0|n|bshUl8
z>q6b9RxNg6BKOb}k+6t!YHLZmIAcK-&L?fp33iH@Kx!?e!#Hf}Y}*=VWYoBRfsR9d
zap8#Ih1apO0_c}JglX6R5Ha9lbs&heN?I=-99HK}I`zWn0f&q`+KmGpV4N&0Wp%D8
zuBYm9bQ~kL&*<%Nis!s)WSp<i-70{!M;gy@dY|iDOhdoYYM=2-e|ovo5hEdDGkm^3
z-0g^jj+s=24zsjHPuRFY5HlM6(Rad0i0hmVUM||<f*Kwrba^f%tcZ__`xvdZNT~cE
zc;if*cQv)cD^QUW!&}xG#;<8e&Tf0u?AT~W<1A^l-BeujVEU#vbg5U)>PAIhyKnY$
zKHiY{tP33LvguAt4Aa%}lceLU0vxIWlwYMW6HCP7U}Dgw>af#0nx$u|c0_ihxbfvu
zksxlRw6nsRRfu~&VVm^4K3&BnM%dA9PNMEnr*-{{yWjoJjY`r>EcW0+NT!_yxM<uX
zh=h4S>>_26^XA(tr=C`JbSyJihv$BJ?77u{gTWidY*h@w0G>DBI&+&T@n#Ss{8gE#
zOI<QB05`sNQ5^GLifzT2KndAk`Clpa-AdaLhJSSikHe5$li0cU&;#<!RTK&}SdPUW
zfgFATOZHy@Ms^Uy-V%m-diNk9cmpbTAN7Xrm?4+7f;RRoP-v>M_5Qoliumuzd8!D$
zI?!FtiHPiGLgWVuN_CYhk<+r{!A-pXZM{{aNb_HvFk1(1_UUloawiCkc}$KXWoJAg
zKRlUUf!HnNGs6)r5}-?}=ZI7U?qqreG(`AOA!7u=aX(V^_h4Ywxy11S_B|X%|93sj
zE1G8<g%Yvzksp)jP5H|2nR2Wb+ew-uzaCxsUH*FFZTwjY2QM3gPkFWdS9?;j1It1M
zCBqY`2WxOo?V+m3QKzh=svzotYST;Wc<L?uL5pd9LD#-?>{&u)d_~^Vs%WX_TxX@0
zSOyM@trCY@>+ehRiY17XY2`T2iE`Ya6jA8C`SnPV@ou$E-l;O#)dTAyX(kQQ`Ncgv
z7=N#GnZNoNbQkblMVCkCdKx8m=E#lAehg&`XuIm+8toZPp3@i?pO+YTb4bwal|knG
zu?u#NyaupIk!oRoQ6X1a6Z2vp-CHDgrV|}5EvOmvI?|<VZkL^KzVINN#Y<>o%JgOC
ztjV+t#`}Jb)(<B;_K&mWZXB0xZH(Czykt&0u^X#O<(8b*>PDTxZ23Mo*LpdFN2ZM&
zh@QAU(CeS27nC!|a(wgCw;p5b5xlYd&*RXUb;UVbwPWp^&d9D`6e{Yp!f>{$HML|^
zbVKirhP2l1ec{ajWtduoBT*~tDC#b=K1W0y;OBoMAPVoMp4?||p?$%Cjc9=X@MsxR
z=6^6Wa<qjh{<gSX%7)uIO4hV^xYupzi=;)=Sif(_>-Wv~%Xhaq652#vsDmeR{VsYL
z)}#%wvz;R7iVk7+FGbzOTpVe9@VG>%W>n_JLcmCfQc*L=$nIpgD^nw!(Sd4|)|r}*
zvDFv*l-{nL(j^>jQ=d!0=AWo+-6Lwz@qBjG@8E#Gyyg^#S5WEWUd26%^@d#gzpe3q
zD0q86HB5XYU(s>nc$7g?vN)_N-n~~}JIpJyvK|Q+-(}i*faz^|wA^0m(U+s=bq~#*
zk?RbT9Wf5SJH5f{7C%;jx5K)dRB*&}iOt0gTQX#r9t`=m(50m<u5;jnbUf$Fdn@Y%
zblw%qqo3h_f85$I_XA~Iq;Y*y!C2Qvzk_jZQf%%~y2|O8su*Gx%k7gy^zU2F3RRpA
zzm?zEcarj-8|?o{P~)M%7hU1lhw)AJe!p{ezm>K4#CV89OHrq)7N%J$WyzjCH=3z4
z;5vzaBazY&`17bvf_?HJdiADgv7R5Jqe3hFpofc^jAjZht<$#hOr3ScN@9GHw|;vn
zhoSXNYLaM?QCSZ$>w?+I_DyT*T8g~Yh|)1BC#-Me5M8>2@OXU?b)VB~C^$w$He4~h
zmgyButn?Fc=y`-Umu~w-5{74IM2@OeA+nb+bj@>5Yu%d4z9hXazFti3l<1(ne<Cqa
z{js#xM^Bj=-(i#}^#M1n!#6v6FX*6WDnrQOhX>8}q39Otcy8c%jI&OO>_WIkNkVCH
z-kQdJPVtqxRU0$E)%tpDF9YX2+)Z8bJA2vuW?Ev3T{NfYG@E-!q}{RsHJCF05^r0x
z+n7fve7Qh4Yj3k!z-5;%VU9a;d-tEb67Zi1sefm`_FoYB|FY@M`QjeV7i+xeZ%Y6A
zY**#)-ki@eecoPf|F9uFQLL4kk5>wpRblf!F_E6-l=It7O$*~(|MF!sg%7D6$1Qu+
zHqK29N#@}M^DgAc57M%eD^m=(<wuD>Er}oUWPQ62)(OPAW5O55rg1)kv}~!##m_kn
z6N>W-dn)Jdk!=HOUHq-M20+p((#d?@>v3nCRpQU5_D&+<w(+(T6=`#+Xwq?lRsRQp
z@N$sq8JI2a;yOy|S9>z>Cf<?7W73i>|E{wWAxy@B`cYDP;5_#|W`mhM0%x0gqR-n+
z_!YVpMN&pwb7^7bGP-_v4s%_fw-}3#938xtIKP1M;XH5t(@(E?Vs**aTx_?q$clG{
z-W`~0lJ!Z}VRoCwag%EHCE*1iEZY6|N$Ec%W&dU1e!y6PZ+iDB>$<ttAK{&(ak~XP
zDol|P^z-N1yfU$<ZkzVKSo!PRx$a7~m%`5Br<C_Ix1DMmZo5I~cAu8iJ?M3i7PF!t
zVY%yQh`7{AQp!t*{pGS(ewXF2=YFig_P~ADuF0IyN6nYoeQ;L>drH~9vidW&x0%;(
zA6n<4v?pa!B{E|k%+7i#tq*q<(}z_@Mb?8RKFw*~zGEE`bBEzWUYa^`R5{G%#cA?l
zIkxIz7$0h<Vy0?sKg;`}Gwnn8cYX)yEtx*}6<_1eq*fm}g<Ep(8fq`fZ3NcT>xO!)
zF8CZA&AYCoaHN^EoTlQ$Mdk>UxA9ZTvdKSN7P@{{OrQ@PJ+tZK>#`Kkn7MN6l%<x&
zgt~OF4O5n`$D;eFYkNM`^2f~6lmtcJ4WeQFV=RH1AXjVF!o^)w%T2`}irFHGnv#xT
zX)V7gCzT$uk9MceNKmm=8CJ{$uCAwF6g5V2JLezoo%Qw3p1$qfJAE71)Q;aSecVM;
z3?j`NiqloNx$$G%Wf!<zA050s%X=H6Koxg-)skjGTu!ga9QIl^NRo>oxn=xtK72{J
z)qOu$Q(U@n?h^dNv?~lzc>m`wrR%r!T#4}tuRdj8uojSS{b63~AI+#3^JZbJ{#+SL
zPWvK0+jsI~rEZyMuC<8onL7+?C!x0QYko2K_EszEu^94{X?ihB8Eu24V3F&O>kKqM
z!SGhl{pKn+E1z_XH+hbr+&5I)Czm-D{3GFR#@c))h0&%^CC5%@^nc>{Es%#^89b^j
zu<}JJ%ea~p7(uKi4ZgvTZv|6HXt^>J85F0EkoV1R`BshUyehN0b7zU8wjsZk<XS&a
zOxRsge6>^px2*KVM@P<vOfs$_5h*DjytYU_9X>nGD~<SV2a+6;Xf3?TA*C~K=&PUW
z*=c1p+9pjNtwcgnH9FdASZM(k;}=(NMWZw1qUr55cW0TS@ppwr*%u~uTxxpl@ozmw
zQPV9w^t*?mI@UVw_40gj>oypMCfa1=X-8Rm0@<{x3pz%7!l-4_+}+UR<ZJxAPO3a*
zXjuiD4Tq(fgX2<(nxT2ZS-N)C8KgkY6DjL=$L<C*wrV$5*t(sDy&^|H%-fa{Xjq%|
zlU?-H6l&jvAEbal>X4OSg6rF|<?B^ll^n{LQu?>FnRHrDYUg_U<k44UIvLl<XRnI>
zX!R?xU-4GG#YI_YoVY`a3}LbS)D<Wn?BK`MylN<&b<8;?$%Qo~N6RL3#G8M`JZ#w?
z<K?EnVOLW-;$XdIGi9)y$TmO06np5$p8vKp{X<uSzSUim9PeYs+EqLoof@mDZbTRV
zk=a}v<b16aJM4ZnD2Cillc%rrmsXNn>)scCawy{=HybjD+^ce7bQ+ggUBLVCVRt2k
zAJKD#GB)&T*B`W~Vk^o(BTs$lfRU&Ky>nng)~WboW;DHyWL?oPSEAjt{W4{wxzPLW
zs;ers4_|LiU(0Lp@vyeJxLEIISbc1xma;s4*V5#?%`W%Ck#Ec=Zv1;U_4SVdUI(im
zv{=o(zc;Bi^5^!NP5vAb`9*UsyRJ?2ib+8A%-ZU$s3sD*PRaFzPbGcIg{L)!oq5G;
zIB!$W-Myrd@oAx`s7Mn4_I_|Q>}|-YP^gjnB=pr{{D92TL(UDR6I|ymZN8^ex=Miz
zt~)4ghqLky0@6@~$de;lIJHTM#{4!K>-#s^H{L`Aeo<3m`epC_SfyKIZ}$PoRhXTv
zq8`ID05UMEV3euT<7|Wo<MlNt!VGZ29sc;AdexOxRj#msX(Kg$lTL$O_4EOo?|&ft
zb0v|O=l2kqE&TQFt=xwUe(|$smp}m5Hwx5VEHW}OD3BsdHQobn$vI~Aa`RG9Py<xN
zVBgWuAhews<Lc@f$Cq)j*F;FGskF~v=4W2O(V%d+&c<7(M|Uqasg8x@GhGT%W$xW;
zZebw><p(*7kV@lU3y4sAfz6TG&hJVbJYVl?Qfty(_5RpR<iS`SiBj`{6zSS0JEqTq
z`fy#dvu-VR_?*S>rayvCCKVSHbR+(wuwO%bw1R5Ym|g`Kf-7KlPXRELy$x(k->$$H
zg6eTmUS3|#B7hQS)&d0JS3u@7yxp1Ztt$mDGe1+N>3j`(R#9ODw*p3BccOUZz0cu!
z;a;nGkgo-)B_Cg37m({MT?Eli$n+Y3-W#f~4c>8YrA<siYyH%SYi(^UV)q7_S;Wef
zL&EV1=n3V5x(eOA=5{W$e{aJT_`nGfq^V&ChggrzjW*d}*&?n~K=Bpg)V7#zV_{JY
zIr5^K8Z*$b=mlBC0)Vo2*NnT4eSRHE!K1^Wtl_$;X#r3dGmsHQrINuI5^~kfKexBq
zIy(mt`#Vshmc)IZ&XDy~fgR!Xn>S05>J@V1%gLGf`9UCVa)5a;0~fqnU@)Za%v&PX
zZQ}g6AwCS?JQRXcOln%%bpwNJphz)LZ&oU2+h$^7l8-R-@<E#w^VPINLEl1owNv9X
zGo2-ifbA)K{`@k~`h$q4n%&z+jnQ9<^8?`&rVogf6_77i)zQ)6fVwRu#!#0(@p96e
zq=nmv$E764bu+UR06?&7>s5hFpWD0hqj@g6>^;Qw5;n`^J0!57<7{thD`yS-yi?k1
zQX9mZ@$mG_(P;ENp{<_*pnj~4W#N+T22QaA<OTW6{QPRbEs$>#db<Vu?BM7~0UFAM
z)*2&&T7%56SXA+~Pw8@A@G)-rekq>8K)5z(^t*#`_A;Nm<8+e6UPCt6832?BIor;`
zk&&AqppuU&hXnQzD4~cbE05mx@^T02x75$}{hgJs`XF*5hKf*zXQ!2#q?rk|Easp-
z1C7$**qQ18b#QpV`xQX_=GUi|{&8i`pa1y<SU1q1mxfXb<d!t}>=1q^F8X(3U=qAF
zc4B-ynGY;8&3d=D<5`*fRhY4kEG#UEX=$zr2?@U2Kl~&l0zm&s<VeIv=q1UM1G$cn
zL0<#Kt=IDM@*N$*?2qAfyEYd52KdAm5Q{BTIS6Nni?2b6TN)p=DJ10cOe3N{OL+4}
zB@F~!4497$1_Drlhb}jSU^;J2!8DK?z=y@3ww*-(RhKw><;|X$Bj|kHjB-Sc2l!rR
zm>nG1GXr~^`x`e0$|#U!M?*ng#e&SshR!~CdT^*)4sgKPVAJmI?i+x4O9ySPG_rc9
zjEo1s@Sgn=&Pzl@s3P#tL{vE95LQs2f<V_1nr#OiTu9xZo@p)OTHqT3)0D>s(=&dy
z6Br^O;&JwSS$Vvpl)*$fF)j|Be=SS5udOs=Y|IX1j<kOK1hUy4xd|(;)YMdAe*RX(
zvvF@jeY}*kv^gjTT?E4dL_x^t-UIPbsFT&kf~Uh+<no*3&W_oq>OA5oUzlCV-+Obl
zbg<kCz8xKJQWn6t`SG83M(|s9jI)Oth<ev~#7Me}VHjH)-_;HbIs73r!dY?lwLs)K
z96ff73QBB~X7^U;(7_*ynqr6n>o<>rYCkB{lrF+KW-)<a2q)uO$mMJBWy4`O>evWp
zUw8L2h571cseG7=VeT3LdL%XaOrAYdDW;0q{=qJ4nOt!mw*inF?#YvbL5q)Vj9~UV
z#H)mR_fCzR{?ain2iiyjJK{ehLI&H&)`X;_e2`7iqc3AMGhvd~GUy$Kuh%jtD5p<O
zY8s4Xo_?q>3N&~j)Co-kx?vO?+(=Isqwl;Gl+A=9fQna_jP|=$n1VvBx}}H!d|iFf
z^Om!R=J(^m`g%P~HUn_~70^)}?CtsHSX~=K_p(kSzK4kK2ArQc1ABoew8OZ_h1S;E
z?;(u>lh5bysXU<83TkUX9&{-Z;aRqzT8@m^K7u6vbfC4t2Otp30N1z-Ed8}qx}x!M
z1hzMZ$ql$R(p%HyWmpKOh}4^X0F^H&@ONx5S!R9bTak2icOQTwVC*~SF6ke6jRBAE
zN9=F_<7?i0C)0Rx%7CZrkPTevAUMSh^z<O#_|-gs27?`$wqZeahbfulrE9t@B_lHf
zr2Xb=*5GHr5vTxGLWU!@l@gC2Ef_fZV9V!BKpDX3hwANTP<nd}Spa^cfu84}N#oK{
z)R&8Qf(<_OQ7F?2U4FRjo1oKHR9M&pitkpRvfiY6G>5T37+^A{>bCVjiuc~kvE3S}
z4o*%&?2pexwYHWMn*Acp&CMlY&i3*4c7{#^OkSL~z_sHN=fQdVsm7I2@Jk7#KajF<
zbj+hrsjEOtY1=R;WIhzESv@sgbY!i8+779Tp_~IvUsB|}@?iF@0O{eV<KimF!$;gb
zPpd~4<mH|1->A>Q(i?8^Qpz13Bc3F#aO}7V#y~X6v3G$Gm_!3ZlLL}a8^oj02hd7P
zWSMzQj5N%2uneAw%98gH#4EdzGA|ax8ahBGBPQP*3chZ3Hi|JelYobVLgH@X;E25M
zY%(bH6#||$g$yP;1bsAia>{pcaglWCFX)~W5){Ppk(Di;<^T$&)%&okFk<0=g*3_^
ztleOaSb@?qzHRO;03m(WX3Y@86U0wNHDLZn4%P`umRv9xePMPlhlA}w$WyBYWj<JV
z3PFnM?AG#ovB>}+AQ6jYs7@=+%TvRyfQ^9(*8BT6+kyW6g8F*P-Me=`@7Vi!Qw`=}
zC<CEXd%l3j`<q8*eEj!>01O6Go9KI;LZNsA-C0B=8Y6(J6qIq0w_)H3Nl5f9XR&d~
zdl!sOy2GU)9_TpJ=Wu4rH`fGZo{|7{ZjBvl`o*CUrb-v6m_&_Mw=|`Q6S^}MrryZ7
z0X62;n|7B*rh_W<b6A%jN@pb*kxVd{LOXo&HViRWDD^D$Tin`0=82+fLDPn{a6W8g
zWi_|aw=Fj5dh_NW5LLxpLGxZH2B5G7(5GEMW^xk@8#&qnnMytC_g(A+Mr>ecs1R71
z>UYJ(#ZpkesFQNxjE<0&6*LFpknRkhLAnE^e4a|u0nF-eRaz5o0D(s^kJJXO=S^_I
zDeeQBlzSW-;0^@8i<_JFrUaC{9c5=P!sGRuV3|-!J3qpQV5X&uP0+8fIRIIOOQ-R%
z@G4nC^y)-P_lzPB4r*dSwD<5|!{5wI0EM`+&K!q^;t;!WX-vj;s}sZ_y@8f3#^JOP
zJDvrG*PG-8n7XuUM`w}f3hC}J;ZK9i?o&1r+@{ym{La7zg^=xfWTgkDYkde}6dcI$
zLdSQ*x&Z|@Wo@n5xRQH5g^vMNLWueJ?Jcu9Uw69^c&G5`)6F0<?F1n@5!Af-l;pMm
zS;J_@%9nL9?{jSg{_PX+eQppR_>R9n46%Q(6J(K$&COH4$9BAQ3;<|V2YcPf=p$58
z&H*`0bnN74@9L_8g-gL}@=3}=p;5?<xeXLuCxTN|oIMbD+Vvx)lYv1?aak4jckZP?
z)awLYgaG9|Z5JdY=3ucxsn_!?OG!$aUcP+)>Z!v>caEEvBe8ZLL@S+FkLFt3;#=8H
zWMwLSup@^T(5R}I!12>(Kk%9H9l;}j@07K1Ti&&-%=fo8vf7(aA(JUiZXkUgvBkUD
z9lklhud|+L!feM*3IroAB9y(8eMS&8mjS>rE%n$tH%CWsI**42u3dsvhN}E?;~KgC
z<v85edQbywFV0S`N?-HxB7A~tkMK)LNg+Z~aOUgRUoIG{T-!LrCHuK<bS7=(<;3#s
z+#NYh6Fct-eGrqV+tZ}+T1pQ>&&f&0sNW^tt?$eq(Hi5uo0OJT4Dpy>aH(4ILn#|o
z)ld!&4kJrT9LP}kk@mR~O@;Gd$QX8Zb_xmz=!4)Sz5eCoGK8yPVSA9c_{^CznIdnR
zqXU^@gV|0%T+XzkIjtLP*Z$?X$v<p$|Cha-{K?d-(r;FbxxbA(G}KkyE2Szo{`e2B
CK@ODw

literal 0
HcmV?d00001

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bivar_pcolormesh.png b/lib/matplotlib/tests/baseline_images/test_axes/bivar_pcolormesh.png
new file mode 100644
index 0000000000000000000000000000000000000000..051a32c265d4b4382daf255195014d81cfee5e18
GIT binary patch
literal 50734
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
WxgM8U#hb_tLtoa{C{(-t@IL^xoI0ui

literal 0
HcmV?d00001

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index f7e5ffe87cb2..0495d1b7c7e2 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -28,6 +28,7 @@
 from numpy.testing import assert_allclose, assert_array_equal
 from matplotlib.cbook import IgnoredKeywordWarning
 from matplotlib.cbook._backports import broadcast_to
+from matplotlib.cbook import get_sample_data
 
 # Note: Some test cases are run twice: once normally and once with labeled data
 #       These two must be defined in the same test function or need to have
@@ -5271,3 +5272,30 @@ def test_twinx_knows_limits():
 def test_zero_linewidth():
     # Check that setting a zero linewidth doesn't error
     plt.plot([0, 1], [0, 1], ls='--', lw=0)
+
+
+@image_comparison(
+    baseline_images=['bivar_imshow', 'bivar_pcolor', 'bivar_pcolormesh',
+                     'bivar_pcolorfast'],
+    extensions=['png']
+)
+def test_bivariates():
+    air_temp = np.load(get_sample_data('air_temperature.npy'))
+    surf_pres = np.load(get_sample_data('surface_pressure.npy'))
+    bivariate = [air_temp, surf_pres]
+
+    fig1, ax1 = plt.subplots()
+    cax1 = ax1.imshow(bivariate)
+    cbar = fig1.colorbar(cax1, xlabel='air_temp', ylabel='surf_pres')
+
+    fig2, ax2 = plt.subplots()
+    cax2 = ax2.pcolor(bivariate)
+    cbar = fig2.colorbar(cax2, xlabel='air_temp', ylabel='surf_pres')
+
+    fig3, ax3 = plt.subplots()
+    cax3 = ax3.pcolormesh(bivariate)
+    cbar = fig3.colorbar(cax3, xlabel='air_temp', ylabel='surf_pres')
+
+    fig4, ax4 = plt.subplots()
+    cax4 = ax4.pcolorfast(bivariate)
+    cbar = fig4.colorbar(cax4, xlabel='air_temp', ylabel='surf_pres')

From f98978faddee1a236beee8ee7e5bcc48232d4e5e Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Sat, 26 Aug 2017 11:34:44 +0530
Subject: [PATCH 32/35] Update is_bivar condition to expect either
 BivariateNorm or BivariateColormap

---
 .../bivariate_demo.py                         |  2 ++
 lib/matplotlib/axes/_axes.py                  | 30 ++++++++++++-------
 lib/matplotlib/tests/test_axes.py             |  8 ++---
 3 files changed, 26 insertions(+), 14 deletions(-)

diff --git a/examples/images_contours_and_fields/bivariate_demo.py b/examples/images_contours_and_fields/bivariate_demo.py
index d4e41d227b14..7b390dbc08c2 100644
--- a/examples/images_contours_and_fields/bivariate_demo.py
+++ b/examples/images_contours_and_fields/bivariate_demo.py
@@ -28,6 +28,8 @@
 
 bivariate = [air_temp, surf_pres]
 
+# to distinguish bivariate data either BivariateNorm or BivariateColormap must
+# be passed in as argument
 cax = ax.imshow(bivariate, norm=colors.BivariateNorm(),
                 cmap=colors.BivariateColormap())
 
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 3bcc8f55d2e9..529888e92c3c 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5151,8 +5151,11 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
             raise ValueError(msg)
 
         temp = np.asarray(X)
-        is_bivari = (temp.ndim == 3 or temp.shape[0] == 2)
+        is_bivari = (isinstance(norm, mcolors.BivariateNorm) or
+                     isinstance(cmap, mcolors.BivariateColormap))
         if is_bivari:
+            if temp.ndim != 3 and temp.shape[0] != 2:
+                raise TypeError("Expected shape like (2, n, m)")
             if cmap is None:
                 cmap = mcolors.BivariateColormap()
             if norm is None:
@@ -5205,7 +5208,8 @@ def _pcolorargs(funcname, *args, **kw):
 
         if len(args) == 1:
             C = np.asanyarray(args[0])
-            is_bivari = (C.ndim == 3 or C.shape[0] == 2)
+            is_bivari = (isinstance(norm, mcolors.BivariateNorm) or
+                         isinstance(cmap, mcolors.BivariateColormap))
             if is_bivari:
                 numRows, numCols = C.shape[1:]
             else:
@@ -5220,12 +5224,9 @@ def _pcolorargs(funcname, *args, **kw):
 
         if len(args) == 3:
             X, Y, C = [np.asanyarray(a) for a in args]
-            is_bivari = (C.ndim == 3 or C.shape[0] == 2)
+            is_bivari = (isinstance(norm, mcolors.BivariateNorm) or
+                         isinstance(cmap, mcolors.BivariateColormap))
             if is_bivari:
-                if cmap is None:
-                    cmap = mcolors.BivariateColormap()
-                if norm is None:
-                    norm = mcolors.BivariateNorm()
                 numRows, numCols = C.shape[1:]
             else:
                 numRows, numCols = C.shape
@@ -5414,8 +5415,11 @@ def pcolor(self, *args, **kwargs):
         X, Y, C = self._pcolorargs('pcolor', *args, **kw)
         Ny, Nx = X.shape
 
-        is_bivari = (C.ndim == 3 or C.shape[0] == 2)
+        is_bivari = (isinstance(norm, mcolors.BivariateNorm) or
+                     isinstance(cmap, mcolors.BivariateColormap))
         if is_bivari:
+            if C.ndim != 3 and C.shape[0] != 2:
+                raise TypeError("Expected shape like (2, n, m)")
             if cmap is None:
                 cmap = mcolors.BivariateColormap()
             if norm is None:
@@ -5638,8 +5642,11 @@ def pcolormesh(self, *args, **kwargs):
         X, Y, C = self._pcolorargs('pcolormesh', *args, **kw)
         Ny, Nx = X.shape
 
-        is_bivari = (C.ndim == 3 or C.shape[0] == 2)
+        is_bivari = (isinstance(norm, mcolors.BivariateNorm) or
+                     isinstance(cmap, mcolors.BivariateColormap))
         if is_bivari:
+            if C.ndim != 3 and C.shape[0] != 2:
+                raise TypeError("Expected shape like (2, n, m)")
             if cmap is None:
                 cmap = mcolors.BivariateColormap()
             if norm is None:
@@ -5798,8 +5805,11 @@ def pcolorfast(self, *args, **kwargs):
 
         C = np.asarray(args[-1])
 
-        is_bivari = (C.ndim == 3 or C.shape[0] == 2)
+        is_bivari = (isinstance(norm, mcolors.BivariateNorm) or
+                     isinstance(cmap, mcolors.BivariateColormap))
         if is_bivari:
+            if C.ndim != 3 and C.shape[0] != 2:
+                raise TypeError("Expected shape like (2, n, m)")
             if cmap is None:
                 cmap = mcolors.BivariateColormap()
             if norm is None:
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 0495d1b7c7e2..294c6e4ae0cb 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -5285,17 +5285,17 @@ def test_bivariates():
     bivariate = [air_temp, surf_pres]
 
     fig1, ax1 = plt.subplots()
-    cax1 = ax1.imshow(bivariate)
+    cax1 = ax1.imshow(bivariate, norm=mcolors.BivariateNorm())
     cbar = fig1.colorbar(cax1, xlabel='air_temp', ylabel='surf_pres')
 
     fig2, ax2 = plt.subplots()
-    cax2 = ax2.pcolor(bivariate)
+    cax2 = ax2.pcolor(bivariate, norm=mcolors.BivariateNorm())
     cbar = fig2.colorbar(cax2, xlabel='air_temp', ylabel='surf_pres')
 
     fig3, ax3 = plt.subplots()
-    cax3 = ax3.pcolormesh(bivariate)
+    cax3 = ax3.pcolormesh(bivariate, norm=mcolors.BivariateNorm())
     cbar = fig3.colorbar(cax3, xlabel='air_temp', ylabel='surf_pres')
 
     fig4, ax4 = plt.subplots()
-    cax4 = ax4.pcolorfast(bivariate)
+    cax4 = ax4.pcolorfast(bivariate, norm=mcolors.BivariateNorm())
     cbar = fig4.colorbar(cax4, xlabel='air_temp', ylabel='surf_pres')

From 75a289fcbfcf8f772b80de689c3faaa71191cbdb Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Mon, 28 Aug 2017 00:49:18 +0530
Subject: [PATCH 33/35] Add line continuation in docstrings

---
 lib/matplotlib/axes/_axes.py | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 529888e92c3c..50cb9a11554a 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5054,7 +5054,7 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
             to colors based on the `norm` (mapping scalar to scalar)
             and the `cmap` (mapping the normed scalar to a color).
 
-        cmap : `~matplotlib.colors.Colormap`,
+        cmap : `~matplotlib.colors.Colormap`, \
             `~matplotlib.colors.BivariateColormap`optional, default: None
             If None, default to rc `image.cmap` value. `cmap` is ignored
             if `X` is 3-D but not bivariate, directly specifying RGB(A) values.
@@ -5081,7 +5081,7 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
             on the Agg, ps and pdf backends. Other backends will fall back to
             'nearest'.
 
-        norm : `~matplotlib.colors.Normalize`,
+        norm : `~matplotlib.colors.Normalize`, \
             `matplotlib.colors.BivariateNorm` optional, default: None
             A `~matplotlib.colors.Normalize` instance is used to scale
             a 2-D float `X` input to the (0, 1) range for input to the
@@ -5302,10 +5302,12 @@ def pcolor(self, *args, **kwargs):
             vectors, they will be expanded as needed into the appropriate 2-D
             arrays, making a rectangular grid.
 
-        cmap : `~matplotlib.colors.Colormap`, optional, default: None
+        cmap : `~matplotlib.colors.Colormap` or \
+            `matplotlib.colors.BivariateColormap` optional, default: None
             If `None`, default to rc settings.
 
-        norm : `matplotlib.colors.Normalize`, optional, default: None
+        norm : `matplotlib.colors.Normalize` or \
+            `matplotlib.colors.BivariateNorm` optional, default: None
             An instance is used to scale luminance data to (0, 1).
             If `None`, defaults to :func:`normalize`.
 
@@ -5572,12 +5574,12 @@ def pcolormesh(self, *args, **kwargs):
         Keyword arguments:
 
           *cmap*: [ *None* | Colormap ]
-            A :class:`matplotlib.colors.Colormap` or
+            A :class:`matplotlib.colors.Colormap` or \
             :class:`matplotlib.colors.BivariateColormap`instance. If *None*,
             use rc settings.
 
           *norm*: [ *None* | Normalize ]
-            A :class:`matplotlib.colors.Normalize` or
+            A :class:`matplotlib.colors.Normalize` or \
             :class:`matplotlib.colors.BivariateNorm` instance is used to
             scale luminance data to 0,1. If *None*, defaults to
             :func:`normalize`.
@@ -5765,12 +5767,12 @@ def pcolorfast(self, *args, **kwargs):
         Optional keyword arguments:
 
           *cmap*: [ *None* | Colormap ]
-            A :class:`matplotlib.colors.Colormap` or
+            A :class:`matplotlib.colors.Colormap` or \
             :class:`matplotlib.colors.BivariateColormap` instance from cm.
             If *None*, use rc settings.
 
           *norm*: [ *None* | Normalize ]
-            A :class:`matplotlib.colors.Normalize` or
+            A :class:`matplotlib.colors.Normalize` or \
             :class:`matplotlib.colors.BivariateNorm` instance is used to scale
             luminance data to 0,1. If *None*, defaults to normalize()
 

From 7803974ca54df4fde7df1d1c003a9abbc4bbe2e8 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Mon, 28 Aug 2017 22:16:46 +0530
Subject: [PATCH 34/35] Debug doc build fail

---
 lib/matplotlib/axes/_axes.py | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 50cb9a11554a..2e025c351c1b 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5055,7 +5055,7 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
             and the `cmap` (mapping the normed scalar to a color).
 
         cmap : `~matplotlib.colors.Colormap`, \
-            `~matplotlib.colors.BivariateColormap`optional, default: None
+            `~matplotlib.colors.BivariateColormap`, optional, default: None
             If None, default to rc `image.cmap` value. `cmap` is ignored
             if `X` is 3-D but not bivariate, directly specifying RGB(A) values.
 
@@ -5082,7 +5082,7 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
             'nearest'.
 
         norm : `~matplotlib.colors.Normalize`, \
-            `matplotlib.colors.BivariateNorm` optional, default: None
+            `matplotlib.colors.BivariateNorm`, optional, default: None
             A `~matplotlib.colors.Normalize` instance is used to scale
             a 2-D float `X` input to the (0, 1) range for input to the
             `cmap`. If `norm` is None, use the default func:`normalize`.
@@ -5302,12 +5302,12 @@ def pcolor(self, *args, **kwargs):
             vectors, they will be expanded as needed into the appropriate 2-D
             arrays, making a rectangular grid.
 
-        cmap : `~matplotlib.colors.Colormap` or \
-            `matplotlib.colors.BivariateColormap` optional, default: None
+        cmap : `~matplotlib.colors.Colormap` or
+            `matplotlib.colors.BivariateColormap`, optional, default: None
             If `None`, default to rc settings.
 
-        norm : `matplotlib.colors.Normalize` or \
-            `matplotlib.colors.BivariateNorm` optional, default: None
+        norm : `matplotlib.colors.Normalize` or
+            `matplotlib.colors.BivariateNorm`, optional, default: None
             An instance is used to scale luminance data to (0, 1).
             If `None`, defaults to :func:`normalize`.
 
@@ -5574,12 +5574,12 @@ def pcolormesh(self, *args, **kwargs):
         Keyword arguments:
 
           *cmap*: [ *None* | Colormap ]
-            A :class:`matplotlib.colors.Colormap` or \
+            A :class:`matplotlib.colors.Colormap` or
             :class:`matplotlib.colors.BivariateColormap`instance. If *None*,
             use rc settings.
 
           *norm*: [ *None* | Normalize ]
-            A :class:`matplotlib.colors.Normalize` or \
+            A :class:`matplotlib.colors.Normalize` or
             :class:`matplotlib.colors.BivariateNorm` instance is used to
             scale luminance data to 0,1. If *None*, defaults to
             :func:`normalize`.
@@ -5767,12 +5767,12 @@ def pcolorfast(self, *args, **kwargs):
         Optional keyword arguments:
 
           *cmap*: [ *None* | Colormap ]
-            A :class:`matplotlib.colors.Colormap` or \
+            A :class:`matplotlib.colors.Colormap` or
             :class:`matplotlib.colors.BivariateColormap` instance from cm.
             If *None*, use rc settings.
 
           *norm*: [ *None* | Normalize ]
-            A :class:`matplotlib.colors.Normalize` or \
+            A :class:`matplotlib.colors.Normalize` or
             :class:`matplotlib.colors.BivariateNorm` instance is used to scale
             luminance data to 0,1. If *None*, defaults to normalize()
 

From e40c87b66c9a255a807ea1bdb7702a15426c1e08 Mon Sep 17 00:00:00 2001
From: patniharshit <patniharshit@gmail.com>
Date: Mon, 28 Aug 2017 22:44:59 +0530
Subject: [PATCH 35/35] Add missing symbols in docs

---
 .../images_contours_and_fields/bivariate_demo.py     | 12 ++++++++----
 lib/matplotlib/axes/_axes.py                         |  6 +++---
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/examples/images_contours_and_fields/bivariate_demo.py b/examples/images_contours_and_fields/bivariate_demo.py
index 7b390dbc08c2..fead56aaae61 100644
--- a/examples/images_contours_and_fields/bivariate_demo.py
+++ b/examples/images_contours_and_fields/bivariate_demo.py
@@ -1,7 +1,7 @@
 """
-===========
+==============
 Bivariate Demo
-===========
+==============
 
 Plotting bivariate data.
 
@@ -28,13 +28,17 @@
 
 bivariate = [air_temp, surf_pres]
 
-# to distinguish bivariate data either BivariateNorm or BivariateColormap must
+###############################################################################
+# To distinguish bivariate data either BivariateNorm or BivariateColormap must
 # be passed in as argument
+
 cax = ax.imshow(bivariate, norm=colors.BivariateNorm(),
                 cmap=colors.BivariateColormap())
 
-# if input data is bivariate then colorbar automatically draws colorsquare
+###############################################################################
+# If input data is bivariate then colorbar automatically draws colorsquare
 # instead of colorbar
+
 cbar = fig.colorbar(cax, xlabel='air_temp', ylabel='surf_pres')
 
 plt.show()
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 2e025c351c1b..404275d0c5e9 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5302,11 +5302,11 @@ def pcolor(self, *args, **kwargs):
             vectors, they will be expanded as needed into the appropriate 2-D
             arrays, making a rectangular grid.
 
-        cmap : `~matplotlib.colors.Colormap` or
+        cmap : `~matplotlib.colors.Colormap` or \
             `matplotlib.colors.BivariateColormap`, optional, default: None
             If `None`, default to rc settings.
 
-        norm : `matplotlib.colors.Normalize` or
+        norm : `matplotlib.colors.Normalize` or \
             `matplotlib.colors.BivariateNorm`, optional, default: None
             An instance is used to scale luminance data to (0, 1).
             If `None`, defaults to :func:`normalize`.
@@ -5575,7 +5575,7 @@ def pcolormesh(self, *args, **kwargs):
 
           *cmap*: [ *None* | Colormap ]
             A :class:`matplotlib.colors.Colormap` or
-            :class:`matplotlib.colors.BivariateColormap`instance. If *None*,
+            :class:`matplotlib.colors.BivariateColormap` instance. If *None*,
             use rc settings.
 
           *norm*: [ *None* | Normalize ]