From 62d9cbcb1b444d32ad0ddb1d8346f886762f8480 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Tue, 26 Apr 2022 14:29:46 +0200
Subject: [PATCH 01/20] Fixed pass through of permutation to line

Ensured that TernaryAxesSubplot.line passes the self._permutation
through to ternary.lines.line
---
 ternary/ternary_axes_subplot.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index dd56f9b..24ecb0f 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -295,7 +295,8 @@ def gridlines(self, multiple=None, horizontal_kwargs=None, left_kwargs=None,
 
     def line(self, p1, p2, **kwargs):
         ax = self.get_axes()
-        lines.line(ax, p1, p2, **kwargs)
+        permutation = self._permutation
+        lines.line(ax, p1, p2, permutation=permutation, **kwargs)
 
     def horizontal_line(self, i, **kwargs):
         ax = self.get_axes()

From d0d4da0ca3bd8acbd0c9f714822a204689b76c00 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Tue, 26 Apr 2022 15:36:28 +0200
Subject: [PATCH 02/20] Added functions for truncating the simplex

Some plots are mostly in one region of the simplex and using truncation,
we can cut off one or more corners of the simplex to save whitespace.
---
 ternary/helpers.py              |  21 ++++
 ternary/lines.py                | 167 +++++++++++++++++++++++++++-----
 ternary/ternary_axes_subplot.py |  89 ++++++++++++++---
 3 files changed, 242 insertions(+), 35 deletions(-)

diff --git a/ternary/helpers.py b/ternary/helpers.py
index 660c046..efad7bf 100644
--- a/ternary/helpers.py
+++ b/ternary/helpers.py
@@ -218,3 +218,24 @@ def convert_coordinates_sequence(qs, scale, limits, axisorder):
     conversion = get_conversion(scale, limits)
     
     return [convert_coordinates(q, conversion, axisorder) for q in qs]
+
+
+def get_axis_min_max(truncation, scale):
+    """
+    Get the min and max values in scale coords given various
+    truncation points.
+
+    !! Assumes the truncation lines do NOT cross each other!!
+
+    truncation: dict (see main module)
+    """
+    axis_min_max = {'b' : [0,scale],
+           'r' : [0,scale],
+           'l' : [0,scale]
+           }
+
+    for k in truncation.keys():
+        axis_min_max[k[0]][1] = truncation[k]
+        axis_min_max[k[1]][0] = scale-truncation[k]
+
+    return axis_min_max
diff --git a/ternary/lines.py b/ternary/lines.py
index 436798c..b2c0fcf 100644
--- a/ternary/lines.py
+++ b/ternary/lines.py
@@ -31,7 +31,7 @@ def line(ax, p1, p2, permutation=None, **kwargs):
     ax.add_line(Line2D((pp1[0], pp2[0]), (pp1[1], pp2[1]), **kwargs))
 
 
-def horizontal_line(ax, scale, i, **kwargs):
+def horizontal_line(ax, scale, i, axis_min_max=None, **kwargs):
     """
     Draws the i-th horizontal line parallel to the lower axis.
 
@@ -43,16 +43,36 @@ def horizontal_line(ax, scale, i, **kwargs):
         Simplex scale size.
     i: float
         The index of the line to draw
+    axis_min_max: dict
+        giving the min max values of the axes in the case of truncation
     kwargs: Dictionary
         Any kwargs to pass through to Matplotlib.
     """
+    if not axis_min_max:
+        p1 = (0, i, scale - i)
+        p2 = (scale - i, i, 0)
+        line(ax, p1, p2, **kwargs)
 
-    p1 = (0, i, scale - i)
-    p2 = (scale - i, i, 0)
-    line(ax, p1, p2, **kwargs)
+    else:
+        if i <= axis_min_max['r'][1]:
+            if i < scale-axis_min_max['l'][1]:
+                p1 = (axis_min_max['b'][0] - i,
+                      i,
+                      axis_min_max['l'][1])
+            else:
+                p1 = (0, i, scale-i)
+
+            if i < axis_min_max['r'][0]:
+                p2 = (axis_min_max['b'][1],
+                      i,
+                      scale - axis_min_max['b'][1] - i)
+            else:
+                p2 = (scale - i, i, 0)
 
+            line(ax, p1, p2, **kwargs)
+        
 
-def left_parallel_line(ax, scale, i,  **kwargs):
+def left_parallel_line(ax, scale, i,  axis_min_max=None, **kwargs):
     """
     Draws the i-th line parallel to the left axis.
 
@@ -64,16 +84,36 @@ def left_parallel_line(ax, scale, i,  **kwargs):
         Simplex scale size.
     i: float
         The index of the line to draw
+    axis_min_max: dict
+        giving the min max values of the axes in the case of truncation
     kwargs: Dictionary
         Any kwargs to pass through to Matplotlib.
     """
+    if not axis_min_max:
+        p1 = (i, scale - i, 0)
+        p2 = (i, 0, scale - i)
+        line(ax, p1, p2, **kwargs)
+
+    else:
+        if i <= axis_min_max['b'][1]:
+            if i < scale-axis_min_max['r'][1]:
+                p1 = (i,
+                      axis_min_max['r'][1],
+                      axis_min_max['l'][0] - i)
+            else:
+                p1 = (i, scale - i, 0)
+
+            if i < axis_min_max['b'][0]:
+                p2 = (i,
+                      scale - axis_min_max['l'][1] - i,
+                      axis_min_max['l'][1])
+            else:
+                p2 = (i, 0, scale - i)
 
-    p1 = (i, scale - i, 0)
-    p2 = (i, 0, scale - i)
-    line(ax, p1, p2, **kwargs)
+            line(ax, p1, p2, **kwargs)
 
 
-def right_parallel_line(ax, scale, i, **kwargs):
+def right_parallel_line(ax, scale, i, axis_min_max=None, **kwargs):
     """
     Draws the i-th line parallel to the right axis.
 
@@ -85,18 +125,39 @@ def right_parallel_line(ax, scale, i, **kwargs):
         Simplex scale size.
     i: float
         The index of the line to draw
+    axis_min_max: dict
+        giving the min max values of the axes in the case of truncation
     kwargs: Dictionary
         Any kwargs to pass through to Matplotlib.
     """
+    if not axis_min_max:   
+        p1 = (0, scale - i, i)
+        p2 = (scale - i, 0, i)
+        line(ax, p1, p2, **kwargs)
 
-    p1 = (0, scale - i, i)
-    p2 = (scale - i, 0, i)
-    line(ax, p1, p2, **kwargs)
+
+    else:
+        if i <= axis_min_max['l'][1]:
+            if i < axis_min_max['l'][0]:
+                p1 = (scale - axis_min_max['r'][1] - i,
+                      axis_min_max['r'][1],
+                      i)
+            else:
+                p1 = (0, scale - i, i)
+
+            if i < scale - axis_min_max['b'][1]:
+                p2 = (axis_min_max['b'][1],
+                      scale - axis_min_max['b'][1] - i,
+                      i)
+            else:
+                p2 = (scale - i, 0, i)
+
+            line(ax, p1, p2, **kwargs)
 
 
 ## Boundary, Gridlines ##
 
-def boundary(ax, scale, axes_colors=None, **kwargs):
+def boundary(ax, scale, axis_min_max=None, axes_colors=None, **kwargs):
     """
     Plots the boundary of the simplex. Creates and returns matplotlib axis if
     none given.
@@ -107,23 +168,44 @@ def boundary(ax, scale, axes_colors=None, **kwargs):
         The subplot to draw on.
     scale: float
         Simplex scale size.
-    kwargs:
-        Any kwargs to pass through to matplotlib.
+    axis_min_max: dict
+        giving the min max values of the axes in the case of truncation
     axes_colors: dict
         Option for coloring boundaries different colors.
         e.g. {'l': 'g'} for coloring the left axis boundary green
+    kwargs:
+        Any kwargs to pass through to matplotlib.
     """
 
-    # Set default color as black.
+    # set default color as black
     if axes_colors is None:
         axes_colors = dict()
     for _axis in ['l', 'r', 'b']:
         if _axis not in axes_colors.keys():
             axes_colors[_axis] = 'black'
 
-    horizontal_line(ax, scale, 0, color=axes_colors['b'], **kwargs)
-    left_parallel_line(ax, scale, 0, color=axes_colors['l'], **kwargs)
-    right_parallel_line(ax, scale, 0, color=axes_colors['r'], **kwargs)
+    horizontal_line(ax, scale, 0, axis_min_max=axis_min_max,
+                    color=axes_colors['b'], **kwargs)
+    left_parallel_line(ax, scale, 0, axis_min_max=axis_min_max,
+                       color=axes_colors['l'], **kwargs)
+    right_parallel_line(ax, scale, 0, axis_min_max=axis_min_max,
+                        color=axes_colors['r'], **kwargs)
+
+    if axis_min_max:
+        if axis_min_max['r'][1] < scale:
+            horizontal_line(ax, scale, axis_min_max['r'][1],
+                            axis_min_max=axis_min_max,
+                            color=axes_colors['r'], **kwargs)
+        if axis_min_max['b'][1] < scale:
+            left_parallel_line(ax, scale, axis_min_max['b'][1],
+                               axis_min_max=axis_min_max,
+                               color=axes_colors['b'], **kwargs)
+        if axis_min_max['l'][1] < scale:
+            right_parallel_line(ax, scale, axis_min_max['l'][1],
+                                axis_min_max=axis_min_max,
+                                color=axes_colors['l'], **kwargs)
+                
+        
     return ax
 
 
@@ -147,8 +229,9 @@ def merge_dicts(base, updates):
     return z
 
 
-def gridlines(ax, scale, multiple=None, horizontal_kwargs=None,
-              left_kwargs=None, right_kwargs=None, **kwargs):
+def gridlines(ax, scale, axis_min_max=None, multiple=None,
+              horizontal_kwargs=None, left_kwargs=None, right_kwargs=None,
+              **kwargs):
     """
     Plots grid lines excluding boundary.
 
@@ -158,6 +241,8 @@ def gridlines(ax, scale, multiple=None, horizontal_kwargs=None,
         The subplot to draw on.
     scale: float
         Simplex scale size.
+    axis_min_max: dict
+        giving the min max values of the axes in the case of truncation
     multiple: float, None
         Specifies which inner gridelines to draw. For example, if scale=30 and
         multiple=6, only 5 inner gridlines will be drawn.
@@ -184,11 +269,14 @@ def gridlines(ax, scale, multiple=None, horizontal_kwargs=None,
     ## Draw grid-lines
     # Parallel to horizontal axis
     for i in arange(0, scale, multiple):
-        horizontal_line(ax, scale, i, **horizontal_kwargs)
+        horizontal_line(ax, scale, i, axis_min_max=axis_min_max,
+                        **horizontal_kwargs)
     # Parallel to left and right axes
     for i in arange(0, scale + multiple, multiple):
-        left_parallel_line(ax, scale, i, **left_kwargs)
-        right_parallel_line(ax, scale, i, **right_kwargs)
+        left_parallel_line(ax, scale, i, axis_min_max=axis_min_max,
+                           **left_kwargs)
+        right_parallel_line(ax, scale, i, axis_min_max=axis_min_max,
+                            **right_kwargs)
     return ax
 
 
@@ -337,3 +425,34 @@ def ticks(ax, scale, ticks=None, locations=None, multiple=1, axis='b',
                 s = tick_formats['b'] % tick
             ax.text(x, y, s, horizontalalignment="center",
                     color=axes_colors['b'], fontsize=fontsize)
+
+
+def add_extra_tick(ax, axis, loc1, offset, scale, tick ,fontsize, **kwargs):
+    """
+    Add an extra tick on an axis but not necessarily on
+    the simplex. This may be useful if a truncation is applied.
+    """
+    toff = offset * scale
+    
+    if axis == 'r':   
+        loc2 = (loc1[0] + toff, loc1[1], loc1[2]-toff)       
+        text_location = (loc1[0] + 2.6 * toff,
+                         loc1[1] - 0.5 * toff,
+                         loc1[2] - 2.6 * toff)
+
+    elif axis == 'l':
+        loc2 = (loc1[0] - toff, loc1[1] + toff, loc1[2])
+        text_location = (loc1[0] - 2 * toff,
+                         loc1[1] + 1.5 * toff,
+                         loc1[2] + 2 * toff)
+
+    elif axis == 'b':
+        loc2 = (loc1[0], loc1[1] - toff, loc1[2] + toff)
+        text_location = (loc1[0] - 0.5 * toff,
+                         loc1[1] - 3.5 * toff,
+                         loc1[2] + 2 * toff)
+
+
+    line(ax, loc1, loc2, **kwargs)
+    x, y = project_point(text_location)
+    ax.text(x,y,tick,horizontalalignment='center',fontsize=fontsize)
diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index 24ecb0f..298a6f3 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -121,6 +121,33 @@ def set_axis_limits(self, axis_limits=None):
     def get_axis_limits(self):
         return self._axis_limits
 
+
+    def set_truncation(self, truncation):
+        """
+        Set one or more truncation points which will be used to truncate
+        the simplex i.e. cut the corners off to zoom in on a particular
+        region.
+
+        truncation = dict
+            keys are 'br', 'rl' and/or 'lb'
+            vals are a value in data coords giving the maximum of the
+                 first axis mentioned in the key.
+        """
+        self._truncation = {}
+        if len(self._axis_limits.keys()) > 0:
+            for k in truncation.keys():
+                step = (self._axis_limits[k[0]][1]-
+                        self._axis_limits[k[0]][0])/float(self._boundary_scale)
+                self._truncation[k] = int((truncation[k]-
+                                           self._axis_limits[k[0]][0])/step)
+
+        else:
+            self._truncation = truncation
+
+        self._axis_min_max = get_axis_min_max(self._truncation,
+                                              self._boundary_scale)
+
+        
     # Title and Axis Labels
 
     def set_title(self, title, **kwargs):
@@ -354,17 +381,51 @@ def get_ticks_from_axis_limits(self, multiple=1):
                 int(self._boundary_scale / float(multiple) + 1)
             ).tolist()
 
-    def set_custom_ticks(self, locations=None, clockwise=False, multiple=1,
-                         axes_colors=None, tick_formats=None, **kwargs):
+
+    def get_ticks_from_truncation(self):
+        """
+        Taking self._truncation and self._boundary_scale get the scaled ticks
+        for all three axes and store them in self._ticks under the keys
+        'b' for bottom, 'l' for left and 'r' for right axes.
+        """
+        self._ticklocs = {}
+        for k in ['b','l','r']:
+
+            gg = self._axis_min_max[k][1] - self._axis_min_max[k][0] + 1
+            self._ticklocs[k] = numpy.linspace(self._axis_min_max[k][0],
+                                               self._axis_min_max[k][1],
+                                               gg).astype("int").tolist()
+
+            q = numpy.linspace(self._axis_limits[k][0],
+                               self._axis_limits[k][1],
+                               self._boundary_scale+1).astype("int").tolist()
+
+            self._ticks[k] = q[self._axis_min_max[k][0]:
+                               self._axis_min_max[k][1]+1]
+
+        self._ticklocs['l'] = [self._boundary_scale - i for i in self._ticklocs['l']]
+        self._ticks['l'].reverse()
+
+        
+    def set_custom_ticks(self, locations=None, truncation=False,
+                         clockwise=False, multiple=1, axes_colors=None,
+                         tick_formats=None, **kwargs):
         """
         Having called get_ticks_from_axis_limits, set the custom ticks on the
         plot.
         """
-        for k in ['b', 'l', 'r']:
-            self.ticks(ticks=self._ticks[k], locations=locations,
-                       axis=k, clockwise=clockwise, multiple=multiple,
-                       axes_colors=axes_colors, tick_formats=tick_formats,
-                       **kwargs)
+        if not truncation:
+            for k in ['b','l','r']:
+                self.ticks(ticks=self._ticks[k], locations=locations,
+                           axis=k, clockwise=clockwise, multiple=multiple,
+                           axes_colors=axes_colors, tick_formats=tick_formats,
+                           **kwargs)
+        else:
+            for k in ['b','l','r']:
+                self.ticks(ticks=self._ticks[k], locations=self._ticklocs[k],
+                           axis=k, clockwise=clockwise, multiple=multiple,
+                           axes_colors=axes_colors, tick_formats=tick_formats,
+                           **kwargs)
 
     def ticks(self, ticks=None, locations=None, multiple=1, axis='blr',
               clockwise=False, axes_colors=None, tick_formats=None, **kwargs):
@@ -384,7 +445,10 @@ def resize_drawing_canvas(self, scale=None):
         plotting.resize_drawing_canvas(ax, scale=scale)
 
     def _redraw_labels(self):
-        """Redraw axis labels, typically after draw or resize events."""
+        """
+        Redraw axis labels, typically after draw or resize events.
+        """
+
         ax = self.get_axes()
         # Remove any previous labels
         for mpl_object in self._to_remove:
@@ -394,12 +458,15 @@ def _redraw_labels(self):
         label_data = list(self._labels.values())
         label_data.extend(self._corner_labels.values())
         for (label, position, rotation, kwargs) in label_data:
-            transform = ax.transAxes
+            if not hasattr(self,"_truncation"):
+                transform = ax.transAxes
+            else:
+                transform = ax.transData
             x, y = project_point(position)
             # Calculate the new angle.
-            position = np.array([x, y])
+            position = numpy.array([x, y])
             new_rotation = ax.transData.transform_angles(
-                np.array((rotation,)), position.reshape((1, 2)))[0]
+                numpy.array((rotation,)), position.reshape((1, 2)))[0]
             text = ax.text(x, y, label, rotation=new_rotation,
                            transform=transform, horizontalalignment="center",
                            **kwargs)

From 3b5c2e0309861ca70f120b54586999d75a1d56f5 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Tue, 26 Apr 2022 15:45:21 +0200
Subject: [PATCH 03/20] Updated .gitignore

---
 .gitignore | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.gitignore b/.gitignore
index 0d20b64..2c08ef6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,10 @@
 *.pyc
+
+# general things to ignore
+build/
+dist/
+*.egg-info/
+*.egg
+*.py[cod]
+__pycache__/
+*.ipynb_checkpoints/

From 855359d6baf66484a2cebfc6dfd876f52cdef89d Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Tue, 26 Apr 2022 15:52:40 +0200
Subject: [PATCH 04/20] Modified TernaryAxesSubplot.boundary & .gridlines

These functions now handle truncation too.
---
 ternary/ternary_axes_subplot.py | 35 +++++++++++++++++++++++++--------
 1 file changed, 27 insertions(+), 8 deletions(-)

diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index 298a6f3..5cf34b1 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -301,22 +301,41 @@ def annotate(self, text, position, **kwargs):
 
     # Boundary and Gridlines
 
-    def boundary(self, scale=None, axes_colors=None, **kwargs):
+    def boundary(self, scale=None, truncation=None,
+                 axes_colors=None, **kwargs):
         # Sometimes you want to draw a bigger boundary
         if not scale:
-            scale = self._boundary_scale  # defaults to self._scale
+            scale = self._boundary_scale # defaults to self._scale
         ax = self.get_axes()
         self.resize_drawing_canvas(scale)
-        lines.boundary(scale=scale, ax=ax, axes_colors=axes_colors, **kwargs)
+        if not truncation:
+            lines.boundary(scale=scale, ax=ax, axis_min_max=None,
+                           axes_colors=axes_colors, **kwargs)
+
+        else:
+            lines.boundary(scale=scale, ax=ax, axis_min_max=self._axis_min_max,
+                           axes_colors=axes_colors, **kwargs)
 
-    def gridlines(self, multiple=None, horizontal_kwargs=None, left_kwargs=None,
+    def gridlines(self, multiple=None, truncation=None,
+                  horizontal_kwargs=None, left_kwargs=None,
                   right_kwargs=None, **kwargs):
         ax = self.get_axes()
         scale = self.get_scale()
-        lines.gridlines(scale=scale, multiple=multiple,
-                        ax=ax, horizontal_kwargs=horizontal_kwargs,
-                        left_kwargs=left_kwargs, right_kwargs=right_kwargs,
-                        **kwargs)
+        if not truncation:
+            lines.gridlines(scale=scale, axis_min_max=None,
+                            multiple=multiple, ax=ax,
+                            horizontal_kwargs=horizontal_kwargs,
+                            left_kwargs=left_kwargs,
+                            right_kwargs=right_kwargs,
+                            **kwargs)
+
+        else:
+            lines.gridlines(scale=scale, axis_min_max=self._axis_min_max,
+                            multiple=multiple, ax=ax,
+                            horizontal_kwargs=horizontal_kwargs,
+                            left_kwargs=left_kwargs,
+                            right_kwargs=right_kwargs,
+                            **kwargs)
 
     # Various Lines
 

From 7fdc61666eb39fd5ab628d36317a8395f2176ab2 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Tue, 26 Apr 2022 15:56:18 +0200
Subject: [PATCH 05/20] Updated reference to numpy as np

---
 ternary/ternary_axes_subplot.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index 5cf34b1..9d3d6b3 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -411,11 +411,11 @@ def get_ticks_from_truncation(self):
         for k in ['b','l','r']:
 
             gg = self._axis_min_max[k][1] - self._axis_min_max[k][0] + 1
-            self._ticklocs[k] = numpy.linspace(self._axis_min_max[k][0],
+            self._ticklocs[k] = np.linspace(self._axis_min_max[k][0],
                                                self._axis_min_max[k][1],
                                                gg).astype("int").tolist()
 
-            q = numpy.linspace(self._axis_limits[k][0],
+            q = np.linspace(self._axis_limits[k][0],
                                self._axis_limits[k][1],
                                self._boundary_scale+1).astype("int").tolist()
 
@@ -483,9 +483,9 @@ def _redraw_labels(self):
                 transform = ax.transData
             x, y = project_point(position)
             # Calculate the new angle.
-            position = numpy.array([x, y])
+            position = np.array([x, y])
             new_rotation = ax.transData.transform_angles(
-                numpy.array((rotation,)), position.reshape((1, 2)))[0]
+                np.array((rotation,)), position.reshape((1, 2)))[0]
             text = ax.text(x, y, label, rotation=new_rotation,
                            transform=transform, horizontalalignment="center",
                            **kwargs)

From 5d59d3cb965134fae8b396c2e2b0f52ff7457009 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Wed, 27 Apr 2022 17:31:40 +0200
Subject: [PATCH 06/20] Further code changes to enable truncation

---
 ternary/heatmapping.py          |  17 +++-
 ternary/helpers.py              |  18 ++---
 ternary/ternary_axes_subplot.py | 138 ++++++++++++++++++++------------
 3 files changed, 110 insertions(+), 63 deletions(-)

diff --git a/ternary/heatmapping.py b/ternary/heatmapping.py
index 7487f69..63d051d 100644
--- a/ternary/heatmapping.py
+++ b/ternary/heatmapping.py
@@ -318,7 +318,7 @@ def heatmapf(func, scale=10, boundary=True, cmap=None, ax=None,
     # Pass everything to the heatmapper
     ax = heatmap(data, scale, cmap=cmap, ax=ax, style=style,
                  scientific=scientific, colorbar=colorbar,
-                 permutation=permutation, vmin=vmin, vmax=vmax, 
+                 permutation=permutation, vmin=vmin, vmax=vmax,
                  cbarlabel=cbarlabel, cb_kwargs=cb_kwargs)
     return ax
 
@@ -411,9 +411,20 @@ def svg_heatmap(data, scale, filename, vmax=None, vmin=None, style='h',
     output_file.write('</svg>\n')
 
 
-def background_color(ax, color, scale, zorder=-1000, alpha=None):
+def background_color(ax, color, scale, axis_min_max, zorder=-1000, alpha=None):
     """Draws a triangle behind the plot to serve as the background color."""
-    vertices = [(scale, 0, 0), (0, scale, 0), (0, 0, scale)]
+    vertices = [(axis_min_max["b"][1], 0, scale - axis_min_max["b"][1]),
+                (axis_min_max["b"][1], axis_min_max["r"][0], 0),
+                (scale - axis_min_max["r"][1], axis_min_max["r"][1], 0),
+                (0, axis_min_max["r"][1], axis_min_max["l"][0]),
+                (0, scale - axis_min_max["l"][1], axis_min_max["l"][1]),
+                (axis_min_max["b"][0], 0, axis_min_max["l"][1])
+                ]
+
+    _, idx = np.unique(vertices, return_index=True, axis=0)
+    idx.sort()
+    vertices = [vertices[i] for i in idx]
+
     vertices = map(project_point, vertices)
     xs, ys = unzip(vertices)
     poly = ax.fill(xs, ys, facecolor=color, edgecolor=color, zorder=zorder, alpha=alpha)
diff --git a/ternary/helpers.py b/ternary/helpers.py
index efad7bf..bc2f0fb 100644
--- a/ternary/helpers.py
+++ b/ternary/helpers.py
@@ -112,7 +112,7 @@ def planar_to_coordinates(p, scale):
     ----------
     p: 2-tuple
         The planar simplex (x, y) point to be transformed to maps (x,y,z) coordinates
-    
+
     scale: Int
         The normalized scale of the simplex, i.e. N such that points (x,y,z)
         satisfy x + y + z == N
@@ -122,8 +122,8 @@ def planar_to_coordinates(p, scale):
     x = p[0] - y / 2.
     z = scale - x - y
     return np.array([x, y, z])
-    
-    
+
+
 def project_sequence(s, permutation=None):
     """
     Projects a point or sequence of points using `project_point` to lists xs, ys
@@ -136,7 +136,7 @@ def project_sequence(s, permutation=None):
 
     Returns
     -------
-    xs, ys: The sequence of projected points in coordinates as two lists 
+    xs, ys: The sequence of projected points in coordinates as two lists
     """
 
     xs, ys = unzip([project_point(p, permutation=permutation) for p in s])
@@ -188,7 +188,7 @@ def get_conversion(scale, limits):
                   "r": lambda x: (x - limits['r'][0]) * fr}
 
     return conversion
-    
+
 
 def convert_coordinates_sequence(qs, scale, limits, axisorder):
     """
@@ -216,7 +216,7 @@ def convert_coordinates_sequence(qs, scale, limits, axisorder):
        the points converted to simplex coordinates
     """
     conversion = get_conversion(scale, limits)
-    
+
     return [convert_coordinates(q, conversion, axisorder) for q in qs]
 
 
@@ -230,9 +230,9 @@ def get_axis_min_max(truncation, scale):
     truncation: dict (see main module)
     """
     axis_min_max = {'b' : [0,scale],
-           'r' : [0,scale],
-           'l' : [0,scale]
-           }
+                    'r' : [0,scale],
+                    'l' : [0,scale]
+                    }
 
     for k in truncation.keys():
         axis_min_max[k[0]][1] = truncation[k]
diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index 9d3d6b3..bc93742 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -11,7 +11,7 @@
 from . import heatmapping
 from . import lines
 from . import plotting
-from .helpers import project_point, convert_coordinates_sequence
+from .helpers import project_point, convert_coordinates_sequence, get_axis_min_max
 
 
 BackgroundParameters = namedtuple('BackgroundParameters', ['color', 'alpha', 'zorder'])
@@ -71,6 +71,17 @@ def __init__(self, ax=None, scale=None, permutation=None):
         self._labels = dict()
         self._corner_labels = dict()
         self._ticks = dict()
+        # Container for data limits for the axes. Custom limits can
+        # be set by the user
+        self.set_axis_limits({"b" : [0, self._scale],
+                              "r" : [0, self._scale],
+                              "l" : [0, self._scale]})
+
+        # Container for parameters describing a possible truncation
+        self._truncation = dict()
+        self._axis_min_max = {"b" : [0, self._scale],
+                              "r" : [0, self._scale],
+                              "l" : [0, self._scale]}
         # Container for the redrawing of labels
         self._to_remove = []
         self._connect_callbacks()
@@ -111,6 +122,8 @@ def set_axis_limits(self, axis_limits=None):
         """
         Set min and max data limits for each of the three axes.
 
+        max-min for each axis must be the same as the self._scale
+
         axis_limits = dict
             keys are 'b','l' and 'r' for the three axes
             vals are lists of the min and max values for the axis in
@@ -119,35 +132,38 @@ def set_axis_limits(self, axis_limits=None):
         self._axis_limits = axis_limits
 
     def get_axis_limits(self):
+        """Get the data limits for each axis"""
         return self._axis_limits
 
+    def get_axis_min_max(self):
+        """Get the simplex limits for each axis"""
+        return self._axis_min_max
+
 
     def set_truncation(self, truncation):
         """
-        Set one or more truncation points which will be used to truncate
+        Set one or more truncation lines which will be used to truncate
         the simplex i.e. cut the corners off to zoom in on a particular
         region.
 
         truncation = dict
             keys are 'br', 'rl' and/or 'lb'
-            vals are a value in data coords giving the maximum of the
+            values are a value in data coords giving the maximum of the
                  first axis mentioned in the key.
         """
-        self._truncation = {}
-        if len(self._axis_limits.keys()) > 0:
-            for k in truncation.keys():
-                step = (self._axis_limits[k[0]][1]-
-                        self._axis_limits[k[0]][0])/float(self._boundary_scale)
-                self._truncation[k] = int((truncation[k]-
-                                           self._axis_limits[k[0]][0])/step)
-
-        else:
-            self._truncation = truncation
+        for k in truncation.keys():
+            step = (self._axis_limits[k[0]][1]-
+                    self._axis_limits[k[0]][0])/float(self._boundary_scale)
+            self._truncation[k] = int((truncation[k]-
+                                       self._axis_limits[k[0]][0])/step)
 
         self._axis_min_max = get_axis_min_max(self._truncation,
                                               self._boundary_scale)
+        self._draw_background()
+
+    def get_truncation(self):
+        return self._truncation
 
-        
     # Title and Axis Labels
 
     def set_title(self, title, **kwargs):
@@ -155,8 +171,8 @@ def set_title(self, title, **kwargs):
         ax = self.get_axes()
         ax.set_title(title, **kwargs)
 
-    def left_axis_label(self, label, position=None,  rotation=60, offset=0.08,
-                        **kwargs):
+    def left_axis_label(self, label, position=None, rotation=60, offset=0.08,
+                        transform_type="transData", **kwargs):
         """
         Sets the label on the left axis.
 
@@ -176,10 +192,12 @@ def left_axis_label(self, label, position=None,  rotation=60, offset=0.08,
 
         if not position:
             position = (-offset, 3./5, 2./5)
-        self._labels["left"] = (label, position, rotation, kwargs)
+            transform_type = "transAxes"
+        self._labels["left"] = (label, position, rotation,
+                                transform_type, kwargs)
 
     def right_axis_label(self, label, position=None, rotation=-60, offset=0.08,
-                         **kwargs):
+                         transform_type="transData", **kwargs):
 
         """
         Sets the label on the right axis.
@@ -200,10 +218,12 @@ def right_axis_label(self, label, position=None, rotation=-60, offset=0.08,
 
         if not position:
             position = (2. / 5 + offset, 3. / 5, 0)
-        self._labels["right"] = (label, position, rotation, kwargs)
+            transform_type = "transAxes"
+        self._labels["right"] = (label, position, rotation,
+                                 transform_type, kwargs)
 
     def bottom_axis_label(self, label, position=None, rotation=0, offset=0.02,
-                          **kwargs):
+                          transform_type="transData", **kwargs):
         """
         Sets the label on the bottom axis.
 
@@ -223,10 +243,12 @@ def bottom_axis_label(self, label, position=None, rotation=0, offset=0.02,
 
         if not position:
             position = (0.5, -offset / 2., 0.5)
-        self._labels["bottom"] = (label, position, rotation, kwargs)
+            transform_type = "transAxes"
+        self._labels["bottom"] = (label, position, rotation,
+                                  transform_type, kwargs)
 
     def right_corner_label(self, label, position=None, rotation=0, offset=0.08,
-                           **kwargs):
+                           transform_type="transData", **kwargs):
         """
         Sets the label on the right corner (complements left axis).
 
@@ -246,10 +268,12 @@ def right_corner_label(self, label, position=None, rotation=0, offset=0.08,
 
         if not position:
             position = (1, offset / 2, 0)
-        self._corner_labels["right"] = (label, position, rotation, kwargs)
+            transform_type = "transAxes"
+        self._corner_labels["right"] = (label, position, rotation,
+                                        transform_type, kwargs)
 
     def left_corner_label(self, label, position=None, rotation=0, offset=0.08,
-                          **kwargs):
+                          transform_type="transData", **kwargs):
         """
         Sets the label on the left corner (complements right axis.)
 
@@ -269,10 +293,12 @@ def left_corner_label(self, label, position=None, rotation=0, offset=0.08,
 
         if not position:
             position = (-offset / 2, offset / 2, 0)
-        self._corner_labels["left"] = (label, position, rotation, kwargs)
+            transform_type="transAxes"
+        self._corner_labels["left"] = (label, position, rotation,
+                                       transform_type, kwargs)
 
     def top_corner_label(self, label, position=None, rotation=0, offset=0.2,
-                         **kwargs):
+                         transform_type="transData", **kwargs):
         """
         Sets the label on the bottom axis.
 
@@ -292,7 +318,9 @@ def top_corner_label(self, label, position=None, rotation=0, offset=0.2,
 
         if not position:
             position = (-offset / 2, 1 + offset, 0)
-        self._corner_labels["top"] = (label, position, rotation, kwargs)
+            transform_type="transAxes"
+        self._corner_labels["top"] = (label, position, rotation,
+                                      transform_type, kwargs)
 
     def annotate(self, text, position, **kwargs):
         ax = self.get_axes()
@@ -301,14 +329,13 @@ def annotate(self, text, position, **kwargs):
 
     # Boundary and Gridlines
 
-    def boundary(self, scale=None, truncation=None,
-                 axes_colors=None, **kwargs):
+    def boundary(self, scale=None, axes_colors=None, **kwargs):
         # Sometimes you want to draw a bigger boundary
         if not scale:
             scale = self._boundary_scale # defaults to self._scale
         ax = self.get_axes()
         self.resize_drawing_canvas(scale)
-        if not truncation:
+        if not self._truncation:
             lines.boundary(scale=scale, ax=ax, axis_min_max=None,
                            axes_colors=axes_colors, **kwargs)
 
@@ -316,12 +343,11 @@ def boundary(self, scale=None, truncation=None,
             lines.boundary(scale=scale, ax=ax, axis_min_max=self._axis_min_max,
                            axes_colors=axes_colors, **kwargs)
 
-    def gridlines(self, multiple=None, truncation=None,
-                  horizontal_kwargs=None, left_kwargs=None,
-                  right_kwargs=None, **kwargs):
+    def gridlines(self, multiple=None, horizontal_kwargs=None,
+                  left_kwargs=None, right_kwargs=None, **kwargs):
         ax = self.get_axes()
         scale = self.get_scale()
-        if not truncation:
+        if not self._truncation:
             lines.gridlines(scale=scale, axis_min_max=None,
                             multiple=multiple, ax=ax,
                             horizontal_kwargs=horizontal_kwargs,
@@ -403,8 +429,8 @@ def get_ticks_from_axis_limits(self, multiple=1):
 
     def get_ticks_from_truncation(self):
         """
-        Taking self._truncation and self._boundary_scale get the scaled ticks
-        for all three axes and store them in self._ticks under the keys
+        Taking self._axis_min_max and self._boundary_scale get the scaled
+        ticks for all three axes and store them in self._ticks under the keys
         'b' for bottom, 'l' for left and 'r' for right axes.
         """
         self._ticklocs = {}
@@ -412,12 +438,12 @@ def get_ticks_from_truncation(self):
 
             gg = self._axis_min_max[k][1] - self._axis_min_max[k][0] + 1
             self._ticklocs[k] = np.linspace(self._axis_min_max[k][0],
-                                               self._axis_min_max[k][1],
-                                               gg).astype("int").tolist()
+                                            self._axis_min_max[k][1],
+                                            gg).astype("int").tolist()
 
             q = np.linspace(self._axis_limits[k][0],
-                               self._axis_limits[k][1],
-                               self._boundary_scale+1).astype("int").tolist()
+                            self._axis_limits[k][1],
+                            self._boundary_scale+1).astype("int").tolist()
 
             self._ticks[k] = q[self._axis_min_max[k][0]:
                                self._axis_min_max[k][1]+1]
@@ -425,15 +451,14 @@ def get_ticks_from_truncation(self):
         self._ticklocs['l'] = [self._boundary_scale - i for i in self._ticklocs['l']]
         self._ticks['l'].reverse()
 
-        
-    def set_custom_ticks(self, locations=None, truncation=False,
-                         clockwise=False, multiple=1, axes_colors=None,
-                         tick_formats=None, **kwargs):
+
+    def set_custom_ticks(self, locations=None, clockwise=False, multiple=1,
+                         axes_colors=None, tick_formats=None, **kwargs):
         """
         Having called get_ticks_from_axis_limits, set the custom ticks on the
         plot.
         """
-        if not truncation:
+        if not self._truncation:
             for k in ['b','l','r']:
                 self.ticks(ticks=self._ticks[k], locations=locations,
                            axis=k, clockwise=clockwise, multiple=multiple,
@@ -455,6 +480,12 @@ def ticks(self, ticks=None, locations=None, multiple=1, axis='blr',
                     axes_colors=axes_colors, tick_formats=tick_formats,
                     **kwargs)
 
+    def add_extra_tick(self, axis, loc1, offset, scale, tick, fontsize,
+                       **kwargs):
+        ax = self.get_axes()
+        lines.add_extra_tick(ax, axis, loc1, offset, scale, tick, fontsize,
+                             **kwargs)
+
     # Redrawing and resizing
 
     def resize_drawing_canvas(self, scale=None):
@@ -476,16 +507,17 @@ def _redraw_labels(self):
         # Redraw the labels with the appropriate angles
         label_data = list(self._labels.values())
         label_data.extend(self._corner_labels.values())
-        for (label, position, rotation, kwargs) in label_data:
-            if not hasattr(self,"_truncation"):
+        for (label, position, rotation, transform_type, kwargs) in label_data:
+            if transform_type == "transAxes":
                 transform = ax.transAxes
-            else:
+            elif transform_type == "transData":
                 transform = ax.transData
+
             x, y = project_point(position)
             # Calculate the new angle.
             position = np.array([x, y])
-            new_rotation = ax.transData.transform_angles(
-                np.array((rotation,)), position.reshape((1, 2)))[0]
+            new_rotation = ax.transData.transform_angles(np.array((rotation,)),
+                                                          position.reshape((1, 2)))[0]
             text = ax.text(x, y, label, rotation=new_rotation,
                            transform=transform, horizontalalignment="center",
                            **kwargs)
@@ -559,10 +591,14 @@ def _draw_background(self):
         color, alpha, zorder = self._background_parameters
         scale = self.get_scale()
         ax = self.get_axes()
+        axis_min_max = self.get_axis_min_max()
 
         # Remove any existing background
         if self._background_triangle:
             self._background_triangle.remove()
 
         # Draw the background
-        self._background_triangle = heatmapping.background_color(ax, color, scale, alpha=alpha, zorder=zorder)[0]
+        self._background_triangle = heatmapping.background_color(ax, color, scale,
+                                                                 axis_min_max,
+                                                                 alpha=alpha,
+                                                                 zorder=zorder)[0]

From 49eaae0c448fa5bde33b1e963c7044884bcd0547 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Wed, 27 Apr 2022 17:44:07 +0200
Subject: [PATCH 07/20] Added truncated_simplex_example.py to examples

---
 examples/truncated_simplex_example.py | 111 ++++++++++++++++++++++++++
 1 file changed, 111 insertions(+)
 create mode 100644 examples/truncated_simplex_example.py

diff --git a/examples/truncated_simplex_example.py b/examples/truncated_simplex_example.py
new file mode 100644
index 0000000..a44e115
--- /dev/null
+++ b/examples/truncated_simplex_example.py
@@ -0,0 +1,111 @@
+import ternary
+
+## Simple example with one corner truncated
+## Boundary and Gridlines
+scale = 10
+figure, tax = ternary.figure(scale=scale)
+#tax.set_truncation({'rl' : 8})
+tax.ax.axis("off")
+
+
+# Draw Boundary and Gridlines
+tax.boundary(linewidth=0.25)
+tax.gridlines(color="black", multiple=1, linewidth=0.25, ls='-')
+
+# Set Axis labels and Title
+
+tax.left_axis_label(r"$\longleftarrow$ Hogs", fontsize=10)
+tax.right_axis_label(r"$\longleftarrow$ Dogs", fontsize=10)
+tax.bottom_axis_label(r"Logs $\longrightarrow$", fontsize=10, offset=0.08)
+
+
+# Set custom ticks
+#tax.get_ticks_from_truncation(multiple=3)
+# tax.get_ticks_from_truncation()
+# offset=0.013
+# tax.set_custom_ticks(fontsize=8, offset=offset,
+#                       tick_formats="%.1f", linewidth=0.25)
+
+
+tax.ax.axis("scaled")
+tax._redraw_labels()
+
+
+
+
+
+
+## Boundary and Gridlines
+scale = 14
+figure, tax = ternary.figure(scale=scale)
+figure.set_facecolor('w')
+w_i,h_i = 3.15, 2.36
+figure.set_size_inches((w_i,h_i))
+figure.set_dpi(150)
+tax.set_axis_limits({'b':[52,59],'l':[41,48],'r':[0,7]})
+tax.set_truncation({'br' : 57.5, 'rl' : 4, 'lb' : 46.5})
+tax.ax.axis("off")
+left = 0
+right = 1
+bottom = 0
+top = 1
+figure.subplots_adjust(left=left,right=right,bottom=bottom,top=top)
+
+# Draw Boundary and Gridlines
+tax.boundary(linewidth=0.25)
+tax.gridlines(color="black", multiple=1, linewidth=0.25, ls='-')
+
+# Set Axis labels and Title
+fontsize = 10
+qs = [(55.9, -0.62, 44.5),(56.1, 3.30, 40.5),(51.5, 3.35, 45.0)]
+
+pos = ternary.helpers.convert_coordinates_sequence(qs,tax._boundary_scale,
+                                                   tax._axis_limits,
+                                                   axisorder='brl')
+tax.left_axis_label(r"$\longleftarrow$ Hogs",
+                    position=pos[2],fontsize=fontsize)
+tax.right_axis_label(r"$\longleftarrow$ Dogs",
+                     position=pos[1],fontsize=fontsize)
+tax.bottom_axis_label(r"Logs $\longrightarrow$",
+                      position=pos[0],fontsize=fontsize)
+
+
+# Set custom ticks
+#tax.get_ticks_from_truncation()
+#tax.get_ticks_from_axis_limits()
+ticks = {'b' : [54,55,56,57],
+         'r' : [2,3,4],
+         'l' : [46,45,44]}
+ticklocs = {'b' : [4,6,8,10],
+            'r' : [4,6,8],
+            'l' : [8,6,4]}
+tax._ticks = ticks
+tax._ticklocs = ticklocs
+
+offset=0.013
+tax.set_custom_ticks(fontsize=8, offset=offset,
+                     tick_formats=None, linewidth=0.25)
+
+
+tax.add_extra_tick('r',(11,2,1),offset,scale,'1',fontsize=8,color='k',
+                     linewidth=0.25)
+tax.add_extra_tick('r',(11,0,3),offset,scale,'0',fontsize=8,color='k',
+                     linewidth=0.25)
+
+tax.add_extra_tick('l',(2,8,4),offset,scale,'43',fontsize=8,color='k',
+                     linewidth=0.25)
+tax.add_extra_tick('l',(4,8,2),offset,scale,'42',fontsize=8,color='k',
+                     linewidth=0.25)
+tax.add_extra_tick('l',(6,8,0),offset,scale,'41',fontsize=8,color='k',
+                     linewidth=0.25)
+
+tax.add_extra_tick('b',(2,1,11),offset,scale,'53',fontsize=8,color='k',
+                     linewidth=0.25)
+
+
+tax.ax.axis("scaled")
+tax.ax.axis([1.1, 12.8, -0.7, 7.4])
+tax.ax.set_position([0,0.02,1,1])
+tax._redraw_labels()
+
+ternary.plt.show()

From 6deedfb88a08048e47bda371e341effb4f44ebb9 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Fri, 12 Aug 2022 16:09:50 +0200
Subject: [PATCH 08/20] Changes to boundary and gridlines

We now have axis_min_max as n attribute during init, therefore we don't
need to check for it in the functions for droawing the boundary and the
gridlines both in lines and in ternary_axes_subplot.

Also updated or added some docstrings to some functions.
---
 examples/truncated_simplex_example.py |  12 +-
 ternary/helpers.py                    |   6 +-
 ternary/lines.py                      | 186 ++++++++++++--------------
 ternary/ternary_axes_subplot.py       |  77 ++++++++---
 4 files changed, 152 insertions(+), 129 deletions(-)

diff --git a/examples/truncated_simplex_example.py b/examples/truncated_simplex_example.py
index a44e115..b388bdf 100644
--- a/examples/truncated_simplex_example.py
+++ b/examples/truncated_simplex_example.py
@@ -4,7 +4,7 @@
 ## Boundary and Gridlines
 scale = 10
 figure, tax = ternary.figure(scale=scale)
-#tax.set_truncation({'rl' : 8})
+tax.set_truncation({'rl' : 8})
 tax.ax.axis("off")
 
 
@@ -20,11 +20,11 @@
 
 
 # Set custom ticks
-#tax.get_ticks_from_truncation(multiple=3)
-# tax.get_ticks_from_truncation()
-# offset=0.013
-# tax.set_custom_ticks(fontsize=8, offset=offset,
-#                       tick_formats="%.1f", linewidth=0.25)
+tax.get_ticks_from_truncation(multiple=3)
+tax.get_ticks_from_truncation()
+offset=0.013
+tax.set_custom_ticks(fontsize=8, offset=offset,
+                      tick_formats="%.1f", linewidth=0.25)
 
 
 tax.ax.axis("scaled")
diff --git a/ternary/helpers.py b/ternary/helpers.py
index bc2f0fb..2fe1734 100644
--- a/ternary/helpers.py
+++ b/ternary/helpers.py
@@ -229,9 +229,9 @@ def get_axis_min_max(truncation, scale):
 
     truncation: dict (see main module)
     """
-    axis_min_max = {'b' : [0,scale],
-                    'r' : [0,scale],
-                    'l' : [0,scale]
+    axis_min_max = {'b' : [0, scale],
+                    'r' : [0, scale],
+                    'l' : [0, scale]
                     }
 
     for k in truncation.keys():
diff --git a/ternary/lines.py b/ternary/lines.py
index b2c0fcf..80c02c5 100644
--- a/ternary/lines.py
+++ b/ternary/lines.py
@@ -31,7 +31,7 @@ def line(ax, p1, p2, permutation=None, **kwargs):
     ax.add_line(Line2D((pp1[0], pp2[0]), (pp1[1], pp2[1]), **kwargs))
 
 
-def horizontal_line(ax, scale, i, axis_min_max=None, **kwargs):
+def horizontal_line(ax, scale, i, axis_min_max, **kwargs):
     """
     Draws the i-th horizontal line parallel to the lower axis.
 
@@ -44,35 +44,31 @@ def horizontal_line(ax, scale, i, axis_min_max=None, **kwargs):
     i: float
         The index of the line to draw
     axis_min_max: dict
-        giving the min max values of the axes in the case of truncation
+        The min and max values of the axes in simplex coordinates.
+        These may not be equal to (0, scale) if a truncation has been
+        applied.
     kwargs: Dictionary
         Any kwargs to pass through to Matplotlib.
     """
-    if not axis_min_max:
-        p1 = (0, i, scale - i)
-        p2 = (scale - i, i, 0)
-        line(ax, p1, p2, **kwargs)
-
-    else:
-        if i <= axis_min_max['r'][1]:
-            if i < scale-axis_min_max['l'][1]:
-                p1 = (axis_min_max['b'][0] - i,
-                      i,
-                      axis_min_max['l'][1])
-            else:
-                p1 = (0, i, scale-i)
+    if i <= axis_min_max['r'][1]:
+        if i < scale-axis_min_max['l'][1]:
+            p1 = (axis_min_max['b'][0] - i,
+                  i,
+                  axis_min_max['l'][1])
+        else:
+            p1 = (0, i, scale-i)
+
+        if i < axis_min_max['r'][0]:
+            p2 = (axis_min_max['b'][1],
+                  i,
+                  scale - axis_min_max['b'][1] - i)
+        else:
+            p2 = (scale - i, i, 0)
 
-            if i < axis_min_max['r'][0]:
-                p2 = (axis_min_max['b'][1],
-                      i,
-                      scale - axis_min_max['b'][1] - i)
-            else:
-                p2 = (scale - i, i, 0)
+        line(ax, p1, p2, **kwargs)
 
-            line(ax, p1, p2, **kwargs)
-        
 
-def left_parallel_line(ax, scale, i,  axis_min_max=None, **kwargs):
+def left_parallel_line(ax, scale, i,  axis_min_max, **kwargs):
     """
     Draws the i-th line parallel to the left axis.
 
@@ -85,32 +81,28 @@ def left_parallel_line(ax, scale, i,  axis_min_max=None, **kwargs):
     i: float
         The index of the line to draw
     axis_min_max: dict
-        giving the min max values of the axes in the case of truncation
+        The min and max values of the axes in simplex coordinates.
+        These may not be equal to (0, scale) if a truncation has been
+        applied.
     kwargs: Dictionary
         Any kwargs to pass through to Matplotlib.
     """
-    if not axis_min_max:
-        p1 = (i, scale - i, 0)
-        p2 = (i, 0, scale - i)
-        line(ax, p1, p2, **kwargs)
+    if i <= axis_min_max['b'][1]:
+        if i < scale-axis_min_max['r'][1]:
+            p1 = (i,
+                  axis_min_max['r'][1],
+                  axis_min_max['l'][0] - i)
+        else:
+            p1 = (i, scale - i, 0)
+
+        if i < axis_min_max['b'][0]:
+            p2 = (i,
+                  scale - axis_min_max['l'][1] - i,
+                  axis_min_max['l'][1])
+        else:
+            p2 = (i, 0, scale - i)
 
-    else:
-        if i <= axis_min_max['b'][1]:
-            if i < scale-axis_min_max['r'][1]:
-                p1 = (i,
-                      axis_min_max['r'][1],
-                      axis_min_max['l'][0] - i)
-            else:
-                p1 = (i, scale - i, 0)
-
-            if i < axis_min_max['b'][0]:
-                p2 = (i,
-                      scale - axis_min_max['l'][1] - i,
-                      axis_min_max['l'][1])
-            else:
-                p2 = (i, 0, scale - i)
-
-            line(ax, p1, p2, **kwargs)
+        line(ax, p1, p2, **kwargs)
 
 
 def right_parallel_line(ax, scale, i, axis_min_max=None, **kwargs):
@@ -126,38 +118,33 @@ def right_parallel_line(ax, scale, i, axis_min_max=None, **kwargs):
     i: float
         The index of the line to draw
     axis_min_max: dict
-        giving the min max values of the axes in the case of truncation
+        The min and max values of the axes in simplex coordinates.
+        These may not be equal to (0, scale) if a truncation has been
+        applied.
     kwargs: Dictionary
         Any kwargs to pass through to Matplotlib.
     """
-    if not axis_min_max:   
-        p1 = (0, scale - i, i)
-        p2 = (scale - i, 0, i)
-        line(ax, p1, p2, **kwargs)
-
-
-    else:
-        if i <= axis_min_max['l'][1]:
-            if i < axis_min_max['l'][0]:
-                p1 = (scale - axis_min_max['r'][1] - i,
-                      axis_min_max['r'][1],
-                      i)
-            else:
-                p1 = (0, scale - i, i)
-
-            if i < scale - axis_min_max['b'][1]:
-                p2 = (axis_min_max['b'][1],
-                      scale - axis_min_max['b'][1] - i,
-                      i)
-            else:
-                p2 = (scale - i, 0, i)
+    if i <= axis_min_max['l'][1]:
+        if i < axis_min_max['l'][0]:
+            p1 = (scale - axis_min_max['r'][1] - i,
+                  axis_min_max['r'][1],
+                  i)
+        else:
+            p1 = (0, scale - i, i)
+
+        if i < scale - axis_min_max['b'][1]:
+            p2 = (axis_min_max['b'][1],
+                  scale - axis_min_max['b'][1] - i,
+                  i)
+        else:
+            p2 = (scale - i, 0, i)
 
-            line(ax, p1, p2, **kwargs)
+        line(ax, p1, p2, **kwargs)
 
 
 ## Boundary, Gridlines ##
 
-def boundary(ax, scale, axis_min_max=None, axes_colors=None, **kwargs):
+def boundary(ax, scale, axis_min_max, axes_colors=None, **kwargs):
     """
     Plots the boundary of the simplex. Creates and returns matplotlib axis if
     none given.
@@ -169,7 +156,9 @@ def boundary(ax, scale, axis_min_max=None, axes_colors=None, **kwargs):
     scale: float
         Simplex scale size.
     axis_min_max: dict
-        giving the min max values of the axes in the case of truncation
+        The min and max values of the axes in simplex coordinates.
+        These may not be equal to (0, scale) if a truncation has been
+        applied.
     axes_colors: dict
         Option for coloring boundaries different colors.
         e.g. {'l': 'g'} for coloring the left axis boundary green
@@ -184,28 +173,27 @@ def boundary(ax, scale, axis_min_max=None, axes_colors=None, **kwargs):
         if _axis not in axes_colors.keys():
             axes_colors[_axis] = 'black'
 
-    horizontal_line(ax, scale, 0, axis_min_max=axis_min_max,
+    horizontal_line(ax, scale, 0, axis_min_max,
                     color=axes_colors['b'], **kwargs)
-    left_parallel_line(ax, scale, 0, axis_min_max=axis_min_max,
+    left_parallel_line(ax, scale, 0, axis_min_max,
                        color=axes_colors['l'], **kwargs)
-    right_parallel_line(ax, scale, 0, axis_min_max=axis_min_max,
+    right_parallel_line(ax, scale, 0, axis_min_max,
                         color=axes_colors['r'], **kwargs)
 
-    if axis_min_max:
-        if axis_min_max['r'][1] < scale:
-            horizontal_line(ax, scale, axis_min_max['r'][1],
+    if axis_min_max['r'][1] < scale:
+        horizontal_line(ax, scale, axis_min_max['r'][1],
+                        axis_min_max=axis_min_max,
+                        color=axes_colors['r'], **kwargs)
+    if axis_min_max['b'][1] < scale:
+        left_parallel_line(ax, scale, axis_min_max['b'][1],
+                           axis_min_max=axis_min_max,
+                           color=axes_colors['b'], **kwargs)
+    if axis_min_max['l'][1] < scale:
+        right_parallel_line(ax, scale, axis_min_max['l'][1],
                             axis_min_max=axis_min_max,
-                            color=axes_colors['r'], **kwargs)
-        if axis_min_max['b'][1] < scale:
-            left_parallel_line(ax, scale, axis_min_max['b'][1],
-                               axis_min_max=axis_min_max,
-                               color=axes_colors['b'], **kwargs)
-        if axis_min_max['l'][1] < scale:
-            right_parallel_line(ax, scale, axis_min_max['l'][1],
-                                axis_min_max=axis_min_max,
-                                color=axes_colors['l'], **kwargs)
-                
-        
+                            color=axes_colors['l'], **kwargs)
+
+
     return ax
 
 
@@ -229,7 +217,7 @@ def merge_dicts(base, updates):
     return z
 
 
-def gridlines(ax, scale, axis_min_max=None, multiple=None,
+def gridlines(ax, scale, axis_min_max, multiple=None,
               horizontal_kwargs=None, left_kwargs=None, right_kwargs=None,
               **kwargs):
     """
@@ -242,7 +230,9 @@ def gridlines(ax, scale, axis_min_max=None, multiple=None,
     scale: float
         Simplex scale size.
     axis_min_max: dict
-        giving the min max values of the axes in the case of truncation
+        The min and max values of the axes in simplex coordinates.
+        These may not be equal to (0, scale) if a truncation has been
+        applied.
     multiple: float, None
         Specifies which inner gridelines to draw. For example, if scale=30 and
         multiple=6, only 5 inner gridlines will be drawn.
@@ -269,14 +259,12 @@ def gridlines(ax, scale, axis_min_max=None, multiple=None,
     ## Draw grid-lines
     # Parallel to horizontal axis
     for i in arange(0, scale, multiple):
-        horizontal_line(ax, scale, i, axis_min_max=axis_min_max,
-                        **horizontal_kwargs)
+        horizontal_line(ax, scale, i, axis_min_max, **horizontal_kwargs)
     # Parallel to left and right axes
     for i in arange(0, scale + multiple, multiple):
-        left_parallel_line(ax, scale, i, axis_min_max=axis_min_max,
-                           **left_kwargs)
-        right_parallel_line(ax, scale, i, axis_min_max=axis_min_max,
-                            **right_kwargs)
+        left_parallel_line(ax, scale, i, axis_min_max, **left_kwargs)
+        right_parallel_line(ax, scale, i, axis_min_max, **right_kwargs)
+
     return ax
 
 
@@ -433,9 +421,9 @@ def add_extra_tick(ax, axis, loc1, offset, scale, tick ,fontsize, **kwargs):
     the simplex. This may be useful if a truncation is applied.
     """
     toff = offset * scale
-    
-    if axis == 'r':   
-        loc2 = (loc1[0] + toff, loc1[1], loc1[2]-toff)       
+
+    if axis == 'r':
+        loc2 = (loc1[0] + toff, loc1[1], loc1[2]-toff)
         text_location = (loc1[0] + 2.6 * toff,
                          loc1[1] - 0.5 * toff,
                          loc1[2] - 2.6 * toff)
diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index bc93742..9199779 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -330,38 +330,73 @@ def annotate(self, text, position, **kwargs):
     # Boundary and Gridlines
 
     def boundary(self, scale=None, axes_colors=None, **kwargs):
+        """
+        Draw a boundary around the simplex.
+
+        Parameters
+        ----------
+        scale : INT, optional
+            An int describing the scale of the boundary to be drawn.
+            Sometimes you may want to draw a bigger boundary than
+            specified in the initialisation of the tax. The default is None.
+        axes_colors: dict
+            Option for coloring boundaries different colors.
+            e.g. {'l': 'g'} for coloring the left axis boundary green
+        **kwargs : dict
+            Any kwargs to pass through to matplotlib..
+
+        Returns
+        -------
+        None.
+
+        """
         # Sometimes you want to draw a bigger boundary
         if not scale:
             scale = self._boundary_scale # defaults to self._scale
         ax = self.get_axes()
         self.resize_drawing_canvas(scale)
-        if not self._truncation:
-            lines.boundary(scale=scale, ax=ax, axis_min_max=None,
-                           axes_colors=axes_colors, **kwargs)
 
-        else:
-            lines.boundary(scale=scale, ax=ax, axis_min_max=self._axis_min_max,
-                           axes_colors=axes_colors, **kwargs)
+        lines.boundary(ax, scale, self._axis_min_max,
+                       axes_colors=axes_colors, **kwargs)
+
 
     def gridlines(self, multiple=None, horizontal_kwargs=None,
                   left_kwargs=None, right_kwargs=None, **kwargs):
+        """
+        Draw gridlines on the simplex.
+
+        Parameters
+        ----------
+        multiple: float, optional
+            Specifies which inner gridelines to draw. For example,
+            if scale=30 and multiple=6, only 5 inner gridlines will be drawn.
+            The default is None.
+        horizontal_kwargs: dict, optional
+            Any kwargs to pass through to matplotlib for horizontal gridlines
+            The default is None.
+        left_kwargs: dict, optional
+            Any kwargs to pass through to matplotlib for left parallel gridlines
+        right_kwargs: dict, optional
+            Any kwargs to pass through to matplotlib for right parallel gridlines
+            The default is None.
+        kwargs:
+            Any kwargs to pass through to matplotlib, if not using
+            horizontal_kwargs, left_kwargs, or right_kwargs
+
+        Returns
+        -------
+        None.
+
+        """
         ax = self.get_axes()
         scale = self.get_scale()
-        if not self._truncation:
-            lines.gridlines(scale=scale, axis_min_max=None,
-                            multiple=multiple, ax=ax,
-                            horizontal_kwargs=horizontal_kwargs,
-                            left_kwargs=left_kwargs,
-                            right_kwargs=right_kwargs,
-                            **kwargs)
 
-        else:
-            lines.gridlines(scale=scale, axis_min_max=self._axis_min_max,
-                            multiple=multiple, ax=ax,
-                            horizontal_kwargs=horizontal_kwargs,
-                            left_kwargs=left_kwargs,
-                            right_kwargs=right_kwargs,
-                            **kwargs)
+        lines.gridlines(ax, scale, self._axis_min_max,
+                        multiple=multiple,
+                        horizontal_kwargs=horizontal_kwargs,
+                        left_kwargs=left_kwargs,
+                        right_kwargs=right_kwargs,
+                        **kwargs)
 
     # Various Lines
 
@@ -529,7 +564,7 @@ def convert_coordinates(self, points, axisorder='blr'):
         Convert data coordinates to simplex coordinates for plotting
         in the case that axis limits have been applied.
         """
-        return convert_coordinates_sequence(points,self._boundary_scale,
+        return convert_coordinates_sequence(points, self._boundary_scale,
                                             self._axis_limits, axisorder)
 
     # Various Plots

From 6a491033277a8931e6d456eeff8605a33d0b5284 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Mon, 15 Aug 2022 13:50:18 +0200
Subject: [PATCH 09/20] Moved function get_truncation

The function get_truncation was previously in one of the minor modules
but I have now moved it to ternary_axes_subplot as it makes much more
sence. This function has been rewritten and is now called
set_truncation, with get_truncation now simply returning
self._truncation, in alignment with other functions.
---
 examples/truncated_simplex_example.py | 36 +++++-----
 ternary/helpers.py                    | 21 ------
 ternary/ternary_axes_subplot.py       | 97 ++++++++++++++++++++-------
 3 files changed, 91 insertions(+), 63 deletions(-)

diff --git a/examples/truncated_simplex_example.py b/examples/truncated_simplex_example.py
index b388bdf..8f652ca 100644
--- a/examples/truncated_simplex_example.py
+++ b/examples/truncated_simplex_example.py
@@ -20,10 +20,10 @@
 
 
 # Set custom ticks
-tax.get_ticks_from_truncation(multiple=3)
-tax.get_ticks_from_truncation()
+tax.get_ticks_from_truncation(multiple=2)
+#tax.get_ticks_from_truncation()
 offset=0.013
-tax.set_custom_ticks(fontsize=8, offset=offset,
+tax.set_custom_ticks(fontsize=8, offset=offset, multiple=2,
                       tick_formats="%.1f", linewidth=0.25)
 
 
@@ -42,8 +42,12 @@
 w_i,h_i = 3.15, 2.36
 figure.set_size_inches((w_i,h_i))
 figure.set_dpi(150)
-tax.set_axis_limits({'b':[52,59],'l':[41,48],'r':[0,7]})
+
+tax.set_axis_limits({'b':[52,59],'r':[0,7],'l':[41,48]})
+
 tax.set_truncation({'br' : 57.5, 'rl' : 4, 'lb' : 46.5})
+
+
 tax.ax.axis("off")
 left = 0
 right = 1
@@ -60,12 +64,12 @@
 qs = [(55.9, -0.62, 44.5),(56.1, 3.30, 40.5),(51.5, 3.35, 45.0)]
 
 pos = ternary.helpers.convert_coordinates_sequence(qs,tax._boundary_scale,
-                                                   tax._axis_limits,
-                                                   axisorder='brl')
+                                                    tax._axis_limits,
+                                                    axisorder='brl')
 tax.left_axis_label(r"$\longleftarrow$ Hogs",
                     position=pos[2],fontsize=fontsize)
 tax.right_axis_label(r"$\longleftarrow$ Dogs",
-                     position=pos[1],fontsize=fontsize)
+                      position=pos[1],fontsize=fontsize)
 tax.bottom_axis_label(r"Logs $\longrightarrow$",
                       position=pos[0],fontsize=fontsize)
 
@@ -74,8 +78,8 @@
 #tax.get_ticks_from_truncation()
 #tax.get_ticks_from_axis_limits()
 ticks = {'b' : [54,55,56,57],
-         'r' : [2,3,4],
-         'l' : [46,45,44]}
+          'r' : [2,3,4],
+          'l' : [46,45,44]}
 ticklocs = {'b' : [4,6,8,10],
             'r' : [4,6,8],
             'l' : [8,6,4]}
@@ -84,23 +88,23 @@
 
 offset=0.013
 tax.set_custom_ticks(fontsize=8, offset=offset,
-                     tick_formats=None, linewidth=0.25)
+                      tick_formats=None, linewidth=0.25)
 
 
 tax.add_extra_tick('r',(11,2,1),offset,scale,'1',fontsize=8,color='k',
-                     linewidth=0.25)
+                      linewidth=0.25)
 tax.add_extra_tick('r',(11,0,3),offset,scale,'0',fontsize=8,color='k',
-                     linewidth=0.25)
+                      linewidth=0.25)
 
 tax.add_extra_tick('l',(2,8,4),offset,scale,'43',fontsize=8,color='k',
-                     linewidth=0.25)
+                      linewidth=0.25)
 tax.add_extra_tick('l',(4,8,2),offset,scale,'42',fontsize=8,color='k',
-                     linewidth=0.25)
+                      linewidth=0.25)
 tax.add_extra_tick('l',(6,8,0),offset,scale,'41',fontsize=8,color='k',
-                     linewidth=0.25)
+                      linewidth=0.25)
 
 tax.add_extra_tick('b',(2,1,11),offset,scale,'53',fontsize=8,color='k',
-                     linewidth=0.25)
+                      linewidth=0.25)
 
 
 tax.ax.axis("scaled")
diff --git a/ternary/helpers.py b/ternary/helpers.py
index 2fe1734..c4e31be 100644
--- a/ternary/helpers.py
+++ b/ternary/helpers.py
@@ -218,24 +218,3 @@ def convert_coordinates_sequence(qs, scale, limits, axisorder):
     conversion = get_conversion(scale, limits)
 
     return [convert_coordinates(q, conversion, axisorder) for q in qs]
-
-
-def get_axis_min_max(truncation, scale):
-    """
-    Get the min and max values in scale coords given various
-    truncation points.
-
-    !! Assumes the truncation lines do NOT cross each other!!
-
-    truncation: dict (see main module)
-    """
-    axis_min_max = {'b' : [0, scale],
-                    'r' : [0, scale],
-                    'l' : [0, scale]
-                    }
-
-    for k in truncation.keys():
-        axis_min_max[k[0]][1] = truncation[k]
-        axis_min_max[k[1]][0] = scale-truncation[k]
-
-    return axis_min_max
diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index 9199779..e4331f0 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -11,7 +11,7 @@
 from . import heatmapping
 from . import lines
 from . import plotting
-from .helpers import project_point, convert_coordinates_sequence, get_axis_min_max
+from .helpers import project_point, convert_coordinates_sequence
 
 
 BackgroundParameters = namedtuple('BackgroundParameters', ['color', 'alpha', 'zorder'])
@@ -71,6 +71,7 @@ def __init__(self, ax=None, scale=None, permutation=None):
         self._labels = dict()
         self._corner_labels = dict()
         self._ticks = dict()
+        self._ticklocs = dict()
         # Container for data limits for the axes. Custom limits can
         # be set by the user
         self.set_axis_limits({"b" : [0, self._scale],
@@ -135,33 +136,76 @@ def get_axis_limits(self):
         """Get the data limits for each axis"""
         return self._axis_limits
 
+    def set_axis_min_max(self, truncation):
+        """
+        Set the min and max values of the axes in SIMPLEX coords
+        (rather than data coords) given various
+        truncation points.
+
+        !! Assumes the truncation lines do NOT cross each other!!
+
+        truncation: dict (see main module)
+        """
+        for k in truncation.keys():
+            self._axis_min_max[k[0]][1] = truncation[k]
+            self._axis_min_max[k[1]][0] = self._scale - truncation[k]
+
+
     def get_axis_min_max(self):
         """Get the simplex limits for each axis"""
         return self._axis_min_max
 
 
-    def set_truncation(self, truncation):
+    def set_truncation(self, truncation_data):
         """
         Set one or more truncation lines which will be used to truncate
-        the simplex i.e. cut the corners off to zoom in on a particular
-        region.
+        the simplex i.e. cut one or more corners off to remove whitespace.
 
-        truncation = dict
+        The self.axis_limits (data limits) and self.axis_min_max (simplex
+        limits) are set by this function.
+
+        Truncation lines may not cross each other!
+
+        Parameters
+        ----------
+        truncation_data : dict
             keys are 'br', 'rl' and/or 'lb'
-            values are a value in data coords giving the maximum of the
-                 first axis mentioned in the key.
+            values are a value in DATA coords giving the maximum of the
+            first axis mentioned in the key. These are then transformed
+            into SIMPLEX coords and stored internally.
+
+        Returns
+        -------
+        None.
+
         """
-        for k in truncation.keys():
-            step = (self._axis_limits[k[0]][1]-
-                    self._axis_limits[k[0]][0])/float(self._boundary_scale)
-            self._truncation[k] = int((truncation[k]-
-                                       self._axis_limits[k[0]][0])/step)
+        steps = {'b' : (self._axis_limits['b'][1] -
+                        self._axis_limits['b'][0]) / float(self._scale),
+                 'r' : (self._axis_limits['r'][1] -
+                        self._axis_limits['r'][0]) / float(self._scale),
+                 'l' : (self._axis_limits['l'][1] -
+                        self._axis_limits['l'][0]) / float(self._scale)}
+
+        axlim = {i:j[:] for i,j in self._axis_limits.items()}
+
+        for k in truncation_data:
+
+            self._truncation[k] = int((truncation_data[k]-
+                                       axlim[k[0]][0])/steps[k[0]])
+
+            self._axis_limits[k[0]][1] = truncation_data[k]
 
-        self._axis_min_max = get_axis_min_max(self._truncation,
-                                              self._boundary_scale)
+            self._axis_limits[k[1]][0] = axlim[k[1]][0] + steps[k[1]] *\
+                                         (self._scale - self._truncation[k])
+
+        self.set_axis_min_max(self._truncation)
         self._draw_background()
 
+
     def get_truncation(self):
+        """
+        This returns the truncation in SIMPLEX coords
+        """
         return self._truncation
 
     # Title and Axis Labels
@@ -363,7 +407,7 @@ def boundary(self, scale=None, axes_colors=None, **kwargs):
     def gridlines(self, multiple=None, horizontal_kwargs=None,
                   left_kwargs=None, right_kwargs=None, **kwargs):
         """
-        Draw gridlines on the simplex.
+        Draw gridlines on the simplex (excluding the boundary).
 
         Parameters
         ----------
@@ -448,6 +492,7 @@ def clear_matplotlib_ticks(self, axis="both"):
         ax = self.get_axes()
         plotting.clear_matplotlib_ticks(ax=ax, axis=axis)
 
+
     def get_ticks_from_axis_limits(self, multiple=1):
         """
         Taking self._axis_limits and self._boundary_scale get the scaled
@@ -458,32 +503,30 @@ def get_ticks_from_axis_limits(self, multiple=1):
             self._ticks[k] = np.linspace(
                 self._axis_limits[k][0],
                 self._axis_limits[k][1],
-                int(self._boundary_scale / float(multiple) + 1)
+                int(self._boundary_scale / multiple + 1)
             ).tolist()
 
 
-    def get_ticks_from_truncation(self):
+    def get_ticks_from_truncation(self, multiple=1):
         """
-        Taking self._axis_min_max and self._boundary_scale get the scaled
+        Taking self._axis_min_max and self._scale get the scaled
         ticks for all three axes and store them in self._ticks under the keys
         'b' for bottom, 'l' for left and 'r' for right axes.
         """
-        self._ticklocs = {}
         for k in ['b','l','r']:
+            gg = self._axis_min_max[k][1] - self._axis_min_max[k][0]
+            gg = int(gg / multiple + 1)
 
-            gg = self._axis_min_max[k][1] - self._axis_min_max[k][0] + 1
             self._ticklocs[k] = np.linspace(self._axis_min_max[k][0],
                                             self._axis_min_max[k][1],
                                             gg).astype("int").tolist()
 
-            q = np.linspace(self._axis_limits[k][0],
-                            self._axis_limits[k][1],
-                            self._boundary_scale+1).astype("int").tolist()
+            self._ticks[k] = np.linspace(self._axis_limits[k][0],
+                                         self._axis_limits[k][1],
+                                         gg).tolist()
 
-            self._ticks[k] = q[self._axis_min_max[k][0]:
-                               self._axis_min_max[k][1]+1]
 
-        self._ticklocs['l'] = [self._boundary_scale - i for i in self._ticklocs['l']]
+        self._ticklocs['l'] = [self._scale - i for i in self._ticklocs['l']]
         self._ticks['l'].reverse()
 
 
@@ -506,6 +549,7 @@ def set_custom_ticks(self, locations=None, clockwise=False, multiple=1,
                            axes_colors=axes_colors, tick_formats=tick_formats,
                            **kwargs)
 
+
     def ticks(self, ticks=None, locations=None, multiple=1, axis='blr',
               clockwise=False, axes_colors=None, tick_formats=None, **kwargs):
         ax = self.get_axes()
@@ -515,6 +559,7 @@ def ticks(self, ticks=None, locations=None, multiple=1, axis='blr',
                     axes_colors=axes_colors, tick_formats=tick_formats,
                     **kwargs)
 
+
     def add_extra_tick(self, axis, loc1, offset, scale, tick, fontsize,
                        **kwargs):
         ax = self.get_axes()

From 134d794334f5abb7eaa5cbee2bbcff7ebefd0484 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Mon, 15 Aug 2022 14:39:33 +0200
Subject: [PATCH 10/20] Refactored set_truncation

---
 ternary/ternary_axes_subplot.py | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index e4331f0..123a56a 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -179,14 +179,10 @@ def set_truncation(self, truncation_data):
         None.
 
         """
-        steps = {'b' : (self._axis_limits['b'][1] -
-                        self._axis_limits['b'][0]) / float(self._scale),
-                 'r' : (self._axis_limits['r'][1] -
-                        self._axis_limits['r'][0]) / float(self._scale),
-                 'l' : (self._axis_limits['l'][1] -
-                        self._axis_limits['l'][0]) / float(self._scale)}
-
-        axlim = {i:j[:] for i,j in self._axis_limits.items()}
+        steps = {i : (j[1] - j[0]) / float(self._scale) for i, j in
+                 self._axis_limits.items()}
+
+        axlim = {i : j[:] for i, j in self._axis_limits.items()}
 
         for k in truncation_data:
 

From a5b377a7bca377b4721a746c1a5b3b96d2853c81 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Mon, 15 Aug 2022 16:56:32 +0200
Subject: [PATCH 11/20] Further refactoring to get_ticks_from_truncation

---
 examples/truncated_simplex_example.py | 20 ++++++++++----------
 ternary/ternary_axes_subplot.py       |  6 ++++--
 2 files changed, 14 insertions(+), 12 deletions(-)

diff --git a/examples/truncated_simplex_example.py b/examples/truncated_simplex_example.py
index 8f652ca..ab8510a 100644
--- a/examples/truncated_simplex_example.py
+++ b/examples/truncated_simplex_example.py
@@ -75,20 +75,20 @@
 
 
 # Set custom ticks
-#tax.get_ticks_from_truncation()
+tax.get_ticks_from_truncation(multiple=1)
 #tax.get_ticks_from_axis_limits()
-ticks = {'b' : [54,55,56,57],
-          'r' : [2,3,4],
-          'l' : [46,45,44]}
-ticklocs = {'b' : [4,6,8,10],
-            'r' : [4,6,8],
-            'l' : [8,6,4]}
-tax._ticks = ticks
-tax._ticklocs = ticklocs
+# ticks = {'b' : [54,55,56,57],
+#           'r' : [2,3,4],
+#           'l' : [46,45,44]}
+# ticklocs = {'b' : [4,6,8,10],
+#             'r' : [4,6,8],
+#             'l' : [8,6,4]}
+# tax._ticks = ticks
+# tax._ticklocs = ticklocs
 
 offset=0.013
 tax.set_custom_ticks(fontsize=8, offset=offset,
-                      tick_formats=None, linewidth=0.25)
+                      tick_formats="%.1f", linewidth=0.25)
 
 
 tax.add_extra_tick('r',(11,2,1),offset,scale,'1',fontsize=8,color='k',
diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index 123a56a..accec78 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -522,8 +522,10 @@ def get_ticks_from_truncation(self, multiple=1):
                                          gg).tolist()
 
 
-        self._ticklocs['l'] = [self._scale - i for i in self._ticklocs['l']]
-        self._ticks['l'].reverse()
+        self._ticklocs['l'] = [i - self._axis_min_max["l"][0] +
+                               (self._scale - self._axis_min_max["l"][1])
+                               for i in self._ticklocs['l']]
+
 
 
     def set_custom_ticks(self, locations=None, clockwise=False, multiple=1,

From dc7e6f3f75be57f6fd738c580b41b79b478a9f8c Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Tue, 16 Aug 2022 10:58:05 +0200
Subject: [PATCH 12/20] Refactoring several functions

Refactorted set_custom_ticks and added docstrings to several functions.
---
 examples/custom_axis_scaling.py       |   4 +-
 examples/truncated_simplex_example.py |  50 +++++-----
 ternary/lines.py                      |  29 +++++-
 ternary/ternary_axes_subplot.py       | 136 +++++++++++++++++---------
 4 files changed, 144 insertions(+), 75 deletions(-)

diff --git a/examples/custom_axis_scaling.py b/examples/custom_axis_scaling.py
index 9559c4f..a18d10d 100644
--- a/examples/custom_axis_scaling.py
+++ b/examples/custom_axis_scaling.py
@@ -114,8 +114,8 @@
 tax2.set_axis_limits({'b': [60, 75], 'l': [15, 30], 'r': [10, 25]})
 tax2.get_ticks_from_axis_limits(multiple=5)
 tick_formats = "%.1f"
-tax2.set_custom_ticks(fontsize=10, offset=0.025, multiple=5,
-                      axes_colors=axes_colors, tick_formats=tick_formats)
+tax2.set_custom_ticks(fontsize=10, offset=0.025, axes_colors=axes_colors,
+                      tick_formats=tick_formats)
 
 # plot some data
 points = [(62, 12, 26), (63.5, 13.5, 23), (65, 14, 21), (61, 15, 24),
diff --git a/examples/truncated_simplex_example.py b/examples/truncated_simplex_example.py
index ab8510a..fc2e324 100644
--- a/examples/truncated_simplex_example.py
+++ b/examples/truncated_simplex_example.py
@@ -20,10 +20,9 @@
 
 
 # Set custom ticks
-tax.get_ticks_from_truncation(multiple=2)
-#tax.get_ticks_from_truncation()
+tax.get_ticks_from_axis_limits(multiple=2)
 offset=0.013
-tax.set_custom_ticks(fontsize=8, offset=offset, multiple=2,
+tax.set_custom_ticks(fontsize=8, offset=offset,
                       tick_formats="%.1f", linewidth=0.25)
 
 
@@ -75,36 +74,35 @@
 
 
 # Set custom ticks
-tax.get_ticks_from_truncation(multiple=1)
-#tax.get_ticks_from_axis_limits()
-# ticks = {'b' : [54,55,56,57],
-#           'r' : [2,3,4],
-#           'l' : [46,45,44]}
-# ticklocs = {'b' : [4,6,8,10],
-#             'r' : [4,6,8],
-#             'l' : [8,6,4]}
-# tax._ticks = ticks
-# tax._ticklocs = ticklocs
+# tax.get_ticks_from_axis_limits(multiple=1)
+# define ticks in data coords:
+tax._ticks = {'b' : [54,55,56,57],
+              'r' : [2,3,4],
+              'l' : [44,45,46]}
+# define tick locations in simplex coords:
+tax._ticklocs = {'b' : [4,6,8,10],
+                 'r' : [4,6,8],
+                 'l' : [4,6,8]}
 
 offset=0.013
 tax.set_custom_ticks(fontsize=8, offset=offset,
-                      tick_formats="%.1f", linewidth=0.25)
+                      tick_formats="%i", linewidth=0.25)
 
 
-tax.add_extra_tick('r',(11,2,1),offset,scale,'1',fontsize=8,color='k',
-                      linewidth=0.25)
-tax.add_extra_tick('r',(11,0,3),offset,scale,'0',fontsize=8,color='k',
-                      linewidth=0.25)
+tax.add_extra_tick('r', (11,2,1), offset, scale, '1', fontsize=8, color='k',
+                   linewidth=0.25)
+tax.add_extra_tick('r', (11,0,3), offset, scale, '0', fontsize=8, color='k',
+                   linewidth=0.25)
 
-tax.add_extra_tick('l',(2,8,4),offset,scale,'43',fontsize=8,color='k',
-                      linewidth=0.25)
-tax.add_extra_tick('l',(4,8,2),offset,scale,'42',fontsize=8,color='k',
-                      linewidth=0.25)
-tax.add_extra_tick('l',(6,8,0),offset,scale,'41',fontsize=8,color='k',
-                      linewidth=0.25)
+tax.add_extra_tick('l', (2,8,4), offset, scale, '43', fontsize=8, color='k',
+                   linewidth=0.25)
+tax.add_extra_tick('l', (4,8,2), offset, scale, '42', fontsize=8, color='k',
+                   linewidth=0.25)
+tax.add_extra_tick('l', (6,8,0), offset, scale, '41', fontsize=8, color='k',
+                   linewidth=0.25)
 
-tax.add_extra_tick('b',(2,1,11),offset,scale,'53',fontsize=8,color='k',
-                      linewidth=0.25)
+tax.add_extra_tick('b', (2,1,11), offset, scale, '53', fontsize=8, color='k',
+                   linewidth=0.25)
 
 
 tax.ax.axis("scaled")
diff --git a/ternary/lines.py b/ternary/lines.py
index 80c02c5..e7215ac 100644
--- a/ternary/lines.py
+++ b/ternary/lines.py
@@ -415,10 +415,35 @@ def ticks(ax, scale, ticks=None, locations=None, multiple=1, axis='b',
                     color=axes_colors['b'], fontsize=fontsize)
 
 
-def add_extra_tick(ax, axis, loc1, offset, scale, tick ,fontsize, **kwargs):
+def add_extra_tick(ax, axis, loc1, offset, scale, tick, fontsize, **kwargs):
     """
     Add an extra tick on an axis but not necessarily on
-    the simplex. This may be useful if a truncation is applied.
+    the boundary of the simplex. This may be useful if a truncation is applied.
+
+    Parameters
+    ----------
+    ax : matplotlib.Axes
+        The matplotlib Axes object containing the plot.
+    axis : STR
+        A string giving the axis on which the extra tick should be drawn.
+        One of 'l', 'b' or 'r'.
+    loc1 : 3-tuple
+        A 3-tuple giving the location of the extra tick in simplex coords.
+    offset : FLOAT
+        Defines an offset of the tick label and the length of the tick
+    scale : INT
+        The self._scale attibute of the simplex
+    tick : STR
+        A string giving the text for the tick label
+    fontsize : INT
+        Describing the font size of the tick label
+    **kwargs : DICT
+        Kwargs to pass through to matplotlib Line2D.
+
+    Returns
+    -------
+    None.
+
     """
     toff = offset * scale
 
diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index accec78..225c4c8 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -407,7 +407,7 @@ def gridlines(self, multiple=None, horizontal_kwargs=None,
 
         Parameters
         ----------
-        multiple: float, optional
+        multiple: int, optional
             Specifies which inner gridelines to draw. For example,
             if scale=30 and multiple=6, only 5 inner gridlines will be drawn.
             The default is None.
@@ -491,35 +491,28 @@ def clear_matplotlib_ticks(self, axis="both"):
 
     def get_ticks_from_axis_limits(self, multiple=1):
         """
-        Taking self._axis_limits and self._boundary_scale get the scaled
+        Taking self._axis_limits, self.axis_min_max and self._scale get the
         ticks for all three axes and store them in self._ticks under the
-        keys 'b' for bottom, 'l' for left and 'r' for right axes.
-        """
-        for k in ['b', 'l', 'r']:
-            self._ticks[k] = np.linspace(
-                self._axis_limits[k][0],
-                self._axis_limits[k][1],
-                int(self._boundary_scale / multiple + 1)
-            ).tolist()
-
+        keys 'b' for bottom, 'l' for left and 'r' for right axes. Get the
+        locations of the tickes and store them under self._ticklocs with the
+        same keys.
 
-    def get_ticks_from_truncation(self, multiple=1):
-        """
-        Taking self._axis_min_max and self._scale get the scaled
-        ticks for all three axes and store them in self._ticks under the keys
-        'b' for bottom, 'l' for left and 'r' for right axes.
+        NB. the tick locations for the left axis have to be shifted if there
+        is a truncation of that axis, otherwise they are projected in the
+        wrong place by lines.line(), which calls helpers.project_point().
         """
         for k in ['b','l','r']:
             gg = self._axis_min_max[k][1] - self._axis_min_max[k][0]
-            gg = int(gg / multiple + 1)
+            ff = self._axis_limits[k][1] - self._axis_limits[k][0]
+            step = ff/gg
 
-            self._ticklocs[k] = np.linspace(self._axis_min_max[k][0],
-                                            self._axis_min_max[k][1],
-                                            gg).astype("int").tolist()
+            self._ticklocs[k] = np.arange(self._axis_min_max[k][0],
+                                          self._axis_min_max[k][1] + step,
+                                          multiple).astype("int").tolist()
 
-            self._ticks[k] = np.linspace(self._axis_limits[k][0],
-                                         self._axis_limits[k][1],
-                                         gg).tolist()
+            self._ticks[k] = np.arange(self._axis_limits[k][0],
+                                       self._axis_limits[k][1] + step,
+                                       step*multiple).tolist()
 
 
         self._ticklocs['l'] = [i - self._axis_min_max["l"][0] +
@@ -528,24 +521,43 @@ def get_ticks_from_truncation(self, multiple=1):
 
 
 
-    def set_custom_ticks(self, locations=None, clockwise=False, multiple=1,
-                         axes_colors=None, tick_formats=None, **kwargs):
+    def set_custom_ticks(self, clockwise=False, axes_colors=None,
+                         tick_formats=None, **kwargs):
         """
-        Having called get_ticks_from_axis_limits, set the custom ticks on the
-        plot.
+        Having called get_ticks_from_axis_limits(), draw the custom ticks on
+        the plot. We call self.ticks() for each axis in turn with the ticks
+        and ticklocs already defined using get_ticks_from_axis_limits().
+
+        Parameters
+        ----------
+        clockwise : BOOL, optional
+            Whether the axes of the simplex run clockwise or not.
+            The default is False.
+        axes_colors: Dict, optional
+            Option to color ticks differently for each axis, 'l', 'r', 'b'
+            e.g. {'l': 'g', 'r':'b', 'b': 'y'}
+            The default is None.
+        tick_formats: None, Dict, Str, optional
+            If None, all axes will be labelled with ints.
+            If Dict, the keys are 'b', 'l' and 'r' and the values are
+            format strings e.g. "%.3f" for a float with 3 decimal places
+            or "%.3e" for scientific format with 3 decimal places or
+            "%d" for ints.
+            If tick_formats is a string, it is assumed that this is a
+            format string to be applied to all axes.
+            The default is None
+        kwargs:
+            Any kwargs to pass through to matplotlib.
+
+        Returns
+        -------
+        None.
+
         """
-        if not self._truncation:
-            for k in ['b','l','r']:
-                self.ticks(ticks=self._ticks[k], locations=locations,
-                           axis=k, clockwise=clockwise, multiple=multiple,
-                           axes_colors=axes_colors, tick_formats=tick_formats,
-                           **kwargs)
-        else:
-            for k in ['b','l','r']:
-                self.ticks(ticks=self._ticks[k], locations=self._ticklocs[k],
-                           axis=k, clockwise=clockwise, multiple=multiple,
-                           axes_colors=axes_colors, tick_formats=tick_formats,
-                           **kwargs)
+        for k in ['b','l','r']:
+            self.ticks(ticks=self._ticks[k], locations=self._ticklocs[k],
+                       axis=k, clockwise=clockwise, axes_colors=axes_colors,
+                       tick_formats=tick_formats, **kwargs)
 
 
     def ticks(self, ticks=None, locations=None, multiple=1, axis='blr',
@@ -558,11 +570,38 @@ def ticks(self, ticks=None, locations=None, multiple=1, axis='blr',
                     **kwargs)
 
 
-    def add_extra_tick(self, axis, loc1, offset, scale, tick, fontsize,
-                       **kwargs):
-        ax = self.get_axes()
-        lines.add_extra_tick(ax, axis, loc1, offset, scale, tick, fontsize,
-                             **kwargs)
+    def add_extra_tick(self, axis, loc1, offset, tick, fontsize, **kwargs):
+        """
+        Convenience function passthrough to lines.add_extra_tick.
+
+        Add an extra tick on an axis but not necessarily on
+        the boundary of the simplex. This may be useful if a
+        truncation is applied.
+
+        Parameters
+        ----------
+        axis : STR
+            A string giving the axis on which the extra tick should be drawn.
+            One of 'l', 'b' or 'r'.
+        loc1 : 3-tuple
+            A 3-tuple giving the location of the extra tick in simplex coords.
+        offset : FLOAT
+            Defines an offset of the tick label and the length of the tick
+        tick : STR
+            A string giving the text for the tick label
+        fontsize : INT
+            Describing the font size of the tick label
+        **kwargs : DICT
+            Kwargs to pass through to matplotlib Line2D.
+
+        Returns
+        -------
+        None.
+
+        """
+        lines.add_extra_tick(self.get_axes(), axis, loc1, offset,
+                             self.get_scale(), tick, fontsize, **kwargs)
+
 
     # Redrawing and resizing
 
@@ -572,11 +611,11 @@ def resize_drawing_canvas(self, scale=None):
             scale = self.get_scale()
         plotting.resize_drawing_canvas(ax, scale=scale)
 
+
     def _redraw_labels(self):
         """
         Redraw axis labels, typically after draw or resize events.
         """
-
         ax = self.get_axes()
         # Remove any previous labels
         for mpl_object in self._to_remove:
@@ -602,6 +641,7 @@ def _redraw_labels(self):
             text.set_rotation_mode("anchor")
             self._to_remove.append(text)
 
+
     def convert_coordinates(self, points, axisorder='blr'):
         """
         Convert data coordinates to simplex coordinates for plotting
@@ -619,18 +659,21 @@ def scatter(self, points, **kwargs):
                                  **kwargs)
         return plot_
 
+
     def plot(self, points, **kwargs):
         ax = self.get_axes()
         permutation = self._permutation
         plotting.plot(points, ax=ax, permutation=permutation,
                       **kwargs)
 
+
     def plot_colored_trajectory(self, points, cmap=None, **kwargs):
         ax = self.get_axes()
         permutation = self._permutation
         plotting.plot_colored_trajectory(points, cmap=cmap, ax=ax,
                                          permutation=permutation, **kwargs)
 
+
     def heatmap(self, data, scale=None, cmap=None, scientific=False,
                 style='triangular', colorbar=True, use_rgba=False,
                 vmin=None, vmax=None, cbarlabel=None, cb_kwargs=None):
@@ -646,6 +689,7 @@ def heatmap(self, data, scale=None, cmap=None, scientific=False,
                             vmin=vmin, vmax=vmax, cbarlabel=cbarlabel,
                             cb_kwargs=cb_kwargs)
 
+
     def heatmapf(self, func, scale=None, cmap=None, boundary=True,
                  style='triangular', colorbar=True, scientific=False,
                  vmin=None, vmax=None, cbarlabel=None, cb_kwargs=None):
@@ -661,10 +705,12 @@ def heatmapf(self, func, scale=None, cmap=None, boundary=True,
                              vmin=vmin, vmax=vmax, cbarlabel=cbarlabel,
                              cb_kwargs=cb_kwargs)
 
+
     def set_background_color(self, color="whitesmoke", zorder=-1000, alpha=0.75):
         self._background_parameters = BackgroundParameters(color=color, alpha=alpha, zorder=zorder)
         self._draw_background()
 
+
     def _draw_background(self):
         color, alpha, zorder = self._background_parameters
         scale = self.get_scale()

From af4e1e6ca3539c3600d610e4cc2381d6263aab1f Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Tue, 16 Aug 2022 11:23:19 +0200
Subject: [PATCH 13/20] Updated docstrings

---
 ternary/lines.py                |  4 +--
 ternary/ternary_axes_subplot.py | 48 +++++++++++++++++++++++++++++++++
 2 files changed, 50 insertions(+), 2 deletions(-)

diff --git a/ternary/lines.py b/ternary/lines.py
index e7215ac..e495538 100644
--- a/ternary/lines.py
+++ b/ternary/lines.py
@@ -234,7 +234,7 @@ def gridlines(ax, scale, axis_min_max, multiple=None,
         These may not be equal to (0, scale) if a truncation has been
         applied.
     multiple: float, None
-        Specifies which inner gridelines to draw. For example, if scale=30 and
+        Specifies which inner gridlines to draw. For example, if scale=30 and
         multiple=6, only 5 inner gridlines will be drawn.
     horizontal_kwargs: dict, None
         Any kwargs to pass through to matplotlib for horizontal gridlines
@@ -298,7 +298,7 @@ def ticks(ax, scale, ticks=None, locations=None, multiple=1, axis='b',
     locations: list of points, None
         The locations of the ticks
     multiple: float, None
-        Specifies which ticks gridelines to draw. For example, if scale=30 and
+        Specifies which ticks to draw. For example, if scale=30 and
         multiple=6, only 5 ticks will be drawn.
     axis: str, 'b'
         The axis or axes to draw the ticks for. `axis` must be a substring of
diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index 225c4c8..2c88883 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -562,6 +562,54 @@ def set_custom_ticks(self, clockwise=False, axes_colors=None,
 
     def ticks(self, ticks=None, locations=None, multiple=1, axis='blr',
               clockwise=False, axes_colors=None, tick_formats=None, **kwargs):
+        """
+        Convenience function passthrough to lines.ticks.
+
+        Calling this function with all the default arguments results in
+        each axis of the simplex being labelled on every gridline with
+        an int. This is the simplest case where the axis_limits (data)
+        have not been set and are therefore the same as the axis_min_max
+        (simplex) limits.
+
+        If set_axis_limits() or set_truncation() has been called, this
+        function should not be used. Instead call get_ticks_from_axis_limits()
+        and then set_custom_ticks().
+
+
+        Parameters
+        ----------
+        ticks: list of strings, None
+            The tick labels
+        locations: list of points, None
+            The locations of the ticks
+        multiple: float, None
+            Specifies which ticks to draw. For example,
+            if scale=30 and multiple=6, only 5 ticks will be drawn.
+        axis: str, 'b'
+            The axis or axes to draw the ticks for. `axis` must be a
+            substring of 'lrb' (as sets)
+        offset: float, 0.01
+            controls the length of the ticks
+        clockwise: bool, False
+            Draw ticks marks clockwise or counterclockwise
+        axes_colors: Dict, None
+            Option to color ticks differently for each axis, 'l', 'r', 'b'
+            e.g. {'l': 'g', 'r':'b', 'b': 'y'}
+        tick_formats: None, Dict, Str
+            If None, all axes will be labelled with ints. If Dict, the keys
+            are 'b', 'l' and 'r' and the values are format strings
+            e.g. "%.3f" for a float with 3 decimal places or "%.3e" for
+            scientific format with 3 decimal places or "%d" for ints.
+            If tick_formats is a string, it
+            is assumed that this is a format string to be applied to all axes.
+        kwargs:
+            Any kwargs to pass through to matplotlib.
+
+        Returns
+        -------
+        None.
+
+        """
         ax = self.get_axes()
         scale = self.get_scale()
         lines.ticks(ax, scale, ticks=ticks, locations=locations,

From 9e086defa02ede8099517e4ebdde01e21309af08 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Tue, 16 Aug 2022 16:16:23 +0200
Subject: [PATCH 14/20] Updating truncation example

---
 examples/truncated_simplex_example.py | 139 +++++++++++++++-----------
 ternary/helpers.py                    |   2 +-
 ternary/ternary_axes_subplot.py       |   1 +
 3 files changed, 85 insertions(+), 57 deletions(-)

diff --git a/examples/truncated_simplex_example.py b/examples/truncated_simplex_example.py
index fc2e324..ddff6c9 100644
--- a/examples/truncated_simplex_example.py
+++ b/examples/truncated_simplex_example.py
@@ -1,9 +1,20 @@
+"""
+This script gives two examples of truncation i.e. cutting one
+or more corners off the simplex to save whitespace in a figure.
+
+The first example is simple: only the top corner is truncated and the data
+coordainates are the same as the simplex coordinates.
+
+The second example is more complex: all three corners have been truncated
+and we set axis data limits which are not the same as the simplex coords.
+"""
+
 import ternary
 
-## Simple example with one corner truncated
-## Boundary and Gridlines
+## Simple example with the top corner truncated
 scale = 10
 figure, tax = ternary.figure(scale=scale)
+figure.subplots_adjust(left=-0.1, right=1.1, bottom=0.1, top=1.1)
 tax.set_truncation({'rl' : 8})
 tax.ax.axis("off")
 
@@ -12,102 +23,118 @@
 tax.boundary(linewidth=0.25)
 tax.gridlines(color="black", multiple=1, linewidth=0.25, ls='-')
 
-# Set Axis labels and Title
 
+# Set Axis labels
 tax.left_axis_label(r"$\longleftarrow$ Hogs", fontsize=10)
 tax.right_axis_label(r"$\longleftarrow$ Dogs", fontsize=10)
 tax.bottom_axis_label(r"Logs $\longrightarrow$", fontsize=10, offset=0.08)
 
 
-# Set custom ticks
+# As we have set a truncation, we need to get and set custom ticks
 tax.get_ticks_from_axis_limits(multiple=2)
 offset=0.013
 tax.set_custom_ticks(fontsize=8, offset=offset,
-                      tick_formats="%.1f", linewidth=0.25)
-
+                     tick_formats="%.1f", linewidth=0.25)
+# here we have used a tick formatting string to label all the axes with
+# floats to one decimal place.
 
 tax.ax.axis("scaled")
 tax._redraw_labels()
+figure.canvas.draw()
 
 
 
 
 
 
-## Boundary and Gridlines
+
+## More complex example with truncations on all 3 corners of the simplex
+## and axes with data coordinates which are different to simplex coordinates.
 scale = 14
 figure, tax = ternary.figure(scale=scale)
 figure.set_facecolor('w')
 w_i,h_i = 3.15, 2.36
 figure.set_size_inches((w_i,h_i))
 figure.set_dpi(150)
+tax.ax.axis("off")
+figure.subplots_adjust(left=0, right=1, bottom=0, top=1)
 
-tax.set_axis_limits({'b':[52,59],'r':[0,7],'l':[41,48]})
+# here we set the data limits of the axes (of the complete simplex)
+tax.set_axis_limits({'b' : [52, 59], 'r' : [0, 7], 'l' : [41, 48]})
 
+# now we set the truncation of all 3 corners in data coords. The truncation
+# point refers to the first axis in the key e.g. "b" will be cut off at 57.5
+# parallel to the left axis until we reach the "r" axis for "br" : 57.5
 tax.set_truncation({'br' : 57.5, 'rl' : 4, 'lb' : 46.5})
 
-
-tax.ax.axis("off")
-left = 0
-right = 1
-bottom = 0
-top = 1
-figure.subplots_adjust(left=left,right=right,bottom=bottom,top=top)
-
 # Draw Boundary and Gridlines
 tax.boundary(linewidth=0.25)
 tax.gridlines(color="black", multiple=1, linewidth=0.25, ls='-')
 
-# Set Axis labels and Title
+# As the truncated figure is no longer a triangle, we need to set custom
+# positions for the axis labels. One way is to enter positions as 2-tuples
+# in xy data coords (e.g. obtained interactively by the hovering the mouse
+# over the matplotlib figure axes) and convert them to simplex coords
+# (3-tuples) for plotting:
+qs = {"l" : (1.94, 5.80),
+      "b" : (6.67, -1.5),
+      "r" : (12.34, 5.58)
+      }
+
+pos = {i : ternary.helpers.planar_to_coordinates(j, tax._scale).tolist()
+        for i, j in qs.items()
+        }
+
 fontsize = 10
-qs = [(55.9, -0.62, 44.5),(56.1, 3.30, 40.5),(51.5, 3.35, 45.0)]
-
-pos = ternary.helpers.convert_coordinates_sequence(qs,tax._boundary_scale,
-                                                    tax._axis_limits,
-                                                    axisorder='brl')
-tax.left_axis_label(r"$\longleftarrow$ Hogs",
-                    position=pos[2],fontsize=fontsize)
-tax.right_axis_label(r"$\longleftarrow$ Dogs",
-                      position=pos[1],fontsize=fontsize)
-tax.bottom_axis_label(r"Logs $\longrightarrow$",
-                      position=pos[0],fontsize=fontsize)
-
-
-# Set custom ticks
-# tax.get_ticks_from_axis_limits(multiple=1)
-# define ticks in data coords:
+tax.left_axis_label(r"$\longleftarrow$ Hogs", position=pos["l"],
+                    fontsize=fontsize)
+tax.right_axis_label(r"$\longleftarrow$ Dogs", position=pos["r"],
+                      fontsize=fontsize)
+tax.bottom_axis_label(r"Logs $\longrightarrow$", position=pos["b"],
+                      fontsize=fontsize)
+
+
+# We also need to set custom ticks for this example.
+# We could use tax.get_ticks_from_axis_limits(multiple=1) and this gives
+# us all the ticks on the remaining visible parts of the simplex boundary.
+# Instead we show here how to plot specific ticks.
+# define ticks in data coords along each axis:
 tax._ticks = {'b' : [54,55,56,57],
               'r' : [2,3,4],
               'l' : [44,45,46]}
-# define tick locations in simplex coords:
+# define tick locations along each axis in simplex coords:
 tax._ticklocs = {'b' : [4,6,8,10],
-                 'r' : [4,6,8],
-                 'l' : [4,6,8]}
+                  'r' : [4,6,8],
+                  'l' : [4,6,8]}
 
 offset=0.013
-tax.set_custom_ticks(fontsize=8, offset=offset,
-                      tick_formats="%i", linewidth=0.25)
-
-
-tax.add_extra_tick('r', (11,2,1), offset, scale, '1', fontsize=8, color='k',
-                   linewidth=0.25)
-tax.add_extra_tick('r', (11,0,3), offset, scale, '0', fontsize=8, color='k',
-                   linewidth=0.25)
-
-tax.add_extra_tick('l', (2,8,4), offset, scale, '43', fontsize=8, color='k',
-                   linewidth=0.25)
-tax.add_extra_tick('l', (4,8,2), offset, scale, '42', fontsize=8, color='k',
-                   linewidth=0.25)
-tax.add_extra_tick('l', (6,8,0), offset, scale, '41', fontsize=8, color='k',
-                   linewidth=0.25)
-
-tax.add_extra_tick('b', (2,1,11), offset, scale, '53', fontsize=8, color='k',
-                   linewidth=0.25)
+tax.set_custom_ticks(fontsize=8, offset=offset, tick_formats="%i",
+                      linewidth=0.25)
+
+# As we have applied a truncation, it can be helpful to plot extra
+# ticks which are not located on the simplex boundary. We specify
+# which axis the tick belongs to so that the tick can be drawn with
+# the correct orientation: horizontal, right parallel or left parallel.
+# Then give the position of the tick in simplex coordinates and specify
+# the tick label as a string in data coordinates:
+tax.add_extra_tick('r', (11,2,1), offset, '1', fontsize=8, color='k',
+                    linewidth=0.25)
+tax.add_extra_tick('r', (11,0,3), offset, '0', fontsize=8, color='k',
+                    linewidth=0.25)
+
+tax.add_extra_tick('l', (2,8,4), offset, '43', fontsize=8, color='k',
+                    linewidth=0.25)
+tax.add_extra_tick('l', (4,8,2), offset, '42', fontsize=8, color='k',
+                    linewidth=0.25)
+tax.add_extra_tick('l', (6,8,0), offset, '41', fontsize=8, color='k',
+                    linewidth=0.25)
+
+tax.add_extra_tick('b', (2,1,11), offset, '53', fontsize=8, color='k',
+                    linewidth=0.25)
 
 
 tax.ax.axis("scaled")
-tax.ax.axis([1.1, 12.8, -0.7, 7.4])
-tax.ax.set_position([0,0.02,1,1])
+tax.ax.axis([0, 14, -2, 9])
 tax._redraw_labels()
 
 ternary.plt.show()
diff --git a/ternary/helpers.py b/ternary/helpers.py
index c4e31be..f6afd54 100644
--- a/ternary/helpers.py
+++ b/ternary/helpers.py
@@ -147,7 +147,7 @@ def project_sequence(s, permutation=None):
 
 def convert_coordinates(q, conversion, axisorder):
     """
-    Convert a 3-tuple in data coordinates into to simplex data
+    Convert a 3-tuple in data coordinates to simplex
     coordinates for plotting.
 
     Parameters
diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index 2c88883..f1d604f 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -500,6 +500,7 @@ def get_ticks_from_axis_limits(self, multiple=1):
         NB. the tick locations for the left axis have to be shifted if there
         is a truncation of that axis, otherwise they are projected in the
         wrong place by lines.line(), which calls helpers.project_point().
+        This is handled in the last 3 lines of this function.
         """
         for k in ['b','l','r']:
             gg = self._axis_min_max[k][1] - self._axis_min_max[k][0]

From 5dd1816cd70579390ad7251e57676eba74088636 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Tue, 16 Aug 2022 16:44:53 +0200
Subject: [PATCH 15/20] Minor docstring update

---
 ternary/ternary_axes_subplot.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index f1d604f..645646f 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -123,8 +123,6 @@ def set_axis_limits(self, axis_limits=None):
         """
         Set min and max data limits for each of the three axes.
 
-        max-min for each axis must be the same as the self._scale
-
         axis_limits = dict
             keys are 'b','l' and 'r' for the three axes
             vals are lists of the min and max values for the axis in

From 66ccb609ac327e131753b447a85b66a99a0402fb Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Thu, 18 Aug 2022 11:40:53 +0200
Subject: [PATCH 16/20] Minor docstring update

---
 ternary/ternary_axes_subplot.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/ternary/ternary_axes_subplot.py b/ternary/ternary_axes_subplot.py
index 645646f..488ea30 100644
--- a/ternary/ternary_axes_subplot.py
+++ b/ternary/ternary_axes_subplot.py
@@ -142,7 +142,10 @@ def set_axis_min_max(self, truncation):
 
         !! Assumes the truncation lines do NOT cross each other!!
 
-        truncation: dict (see main module)
+        truncation: dict
+            keys are 'br', 'rl' and/or 'lb'
+            values are a value in SIMPLEX coords giving the maximum of the
+            first axis mentioned in the key
         """
         for k in truncation.keys():
             self._axis_min_max[k[0]][1] = truncation[k]

From 33cb96848d75214af70d1067f9d16e9e696d6a39 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Thu, 18 Aug 2022 14:52:45 +0200
Subject: [PATCH 17/20] Updated examples and added readme images

Updated the custom_axis_scaling and truncated_simplex_example scripts
and added 3 images from these scripts to the readme_images folder.
---
 examples/custom_axis_scaling.py          |  59 ++++++++++++++---------
 examples/truncated_simplex_example.py    |   1 -
 readme_images/truncation_all_corners.png | Bin 0 -> 27172 bytes
 readme_images/truncation_top_corner.png  | Bin 0 -> 54351 bytes
 readme_images/zoom_example.png           | Bin 0 -> 106879 bytes
 5 files changed, 35 insertions(+), 25 deletions(-)
 create mode 100644 readme_images/truncation_all_corners.png
 create mode 100644 readme_images/truncation_top_corner.png
 create mode 100644 readme_images/zoom_example.png

diff --git a/examples/custom_axis_scaling.py b/examples/custom_axis_scaling.py
index a18d10d..6199b7c 100644
--- a/examples/custom_axis_scaling.py
+++ b/examples/custom_axis_scaling.py
@@ -1,12 +1,24 @@
-import ternary
+"""
+This script gives two examples of setting custom axis data limits instead of
+having the axis limits being from 0 to scale as is the default case.
+
+In the first example we simply set some axis data limits, get and set the
+ticks for the axes and then scatter some data. This example is then repeated
+but with the additional feature of showing custom axis tick formatting.
+
+The second example shows how to use custom axis scaling to achieve a zoom
+effect. We draw the full plot on the left and then zoom into a specific
+region and plot that on the right. The basic principle is the same as the
+first example.
+"""
 
-# Simple example:
-## Boundary and Gridlines
-scale = 9
-figure, tax = ternary.figure(scale=scale)
+import ternary
 
+## Simple example:
+figure, tax = ternary.figure(scale=9)
+figure.set_size_inches((4.8,4.8))
+figure.subplots_adjust(left=0.05, right=0.95, bottom=0.05, top=0.95)
 tax.ax.axis("off")
-figure.set_facecolor('w')
 
 # Draw Boundary and Gridlines
 tax.boundary(linewidth=1.0)
@@ -19,10 +31,10 @@
 tax.bottom_axis_label("Hogs", fontsize=fontsize, offset=0.06)
 
 
-# Set custom axis limits by passing a dict into set_limits.
-# The keys are b, l and r for the three axes and the vals are a list
+# Set custom axis DATA limits by passing a dict into set_axis_limits.
+# The keys are b, l and r for the three axes and the values are a list
 # of the min and max in data coords for that axis. max-min for each
-# axis must be the same as the scale i.e. 9 in this case.
+# axis is the same as the scale i.e. 9 in this case.
 tax.set_axis_limits({'b': [67, 76], 'l': [24, 33], 'r': [0, 9]})
 # get and set the custom ticks:
 tax.get_ticks_from_axis_limits()
@@ -35,15 +47,14 @@
 
 tax.ax.set_aspect('equal', adjustable='box')
 tax._redraw_labels()
+figure.canvas.draw()
 
 
 ## Simple example with axis tick formatting:
-## Boundary and Gridlines
-scale = 9
-figure, tax = ternary.figure(scale=scale)
-
+figure, tax = ternary.figure(scale=9)
+figure.set_size_inches((4.8,4.8))
+figure.subplots_adjust(left=0.05, right=0.95, bottom=0.05, top=0.95)
 tax.ax.axis("off")
-figure.set_facecolor('w')
 
 # Draw Boundary and Gridlines
 tax.boundary(linewidth=1.0)
@@ -55,33 +66,34 @@
 tax.right_axis_label("Dogs", fontsize=fontsize, offset=0.12)
 tax.bottom_axis_label("Hogs", fontsize=fontsize, offset=0.06)
 
-
-# Set custom axis limits by passing a dict into set_limits.
-# The keys are b, l and r for the three axes and the vals are a list
+# Set custom axis DATA limits by passing a dict into set_axis_limits.
+# The keys are b, l and r for the three axes and the values are a list
 # of the min and max in data coords for that axis. max-min for each
-# axis must be the same as the scale i.e. 9 in this case.
+# axis is the same as the scale i.e. 9 in this case.
 tax.set_axis_limits({'b': [67, 76], 'l': [24, 33], 'r': [0, 9]})
+
 # get and set the custom ticks:
 # custom tick formats:
 # tick_formats can either be a dict, like below or a single format string
 # e.g. "%.3e" (valid for all 3 axes) or None, in which case, ints are
 # plotted for all 3 axes.
 tick_formats = {'b': "%.2f", 'r': "%d", 'l': "%.1f"}
-
 tax.get_ticks_from_axis_limits()
 tax.set_custom_ticks(fontsize=10, offset=0.02, tick_formats=tick_formats)
 
 # data can be plotted by entering data coords (rather than simplex coords):
 points = [(70, 3, 27), (73, 2, 25), (68, 6, 26)]
-points_c = tax.convert_coordinates(points,axisorder='brl')
+points_c = tax.convert_coordinates(points, axisorder='brl')
 tax.scatter(points_c, marker='o', s=25, c='r')
 
 tax.ax.set_aspect('equal', adjustable='box')
 tax._redraw_labels()
+figure.canvas.draw()
+
 
 ## Zoom example:
-## Draw a plot with the full range on the left and a second plot which
-## shows a zoomed region of the left plot.
+# Draw a plot with the full range on the left and a second plot which
+# shows a zoomed region of the left plot.
 fig = ternary.plt.figure(figsize=(11, 6))
 ax1 = fig.add_subplot(2, 1, 1)
 ax2 = fig.add_subplot(2, 1, 2)
@@ -132,11 +144,10 @@
 tax1.line((60, 10, 30), (60, 25, 15), color='r', lw=2.0)
 tax1.line((75, 10, 15), (60, 25, 15), color='r', lw=2.0)
 
-fig.set_facecolor("w")
-
 tax1.ax.set_position([0.01, 0.05, 0.46, 0.8])
 tax2.ax.set_position([0.50, 0.05, 0.46, 0.8])
 
 tax1.resize_drawing_canvas()
 tax2.resize_drawing_canvas()
+figure.canvas.draw()
 ternary.plt.show()
diff --git a/examples/truncated_simplex_example.py b/examples/truncated_simplex_example.py
index ddff6c9..e008deb 100644
--- a/examples/truncated_simplex_example.py
+++ b/examples/truncated_simplex_example.py
@@ -52,7 +52,6 @@
 ## and axes with data coordinates which are different to simplex coordinates.
 scale = 14
 figure, tax = ternary.figure(scale=scale)
-figure.set_facecolor('w')
 w_i,h_i = 3.15, 2.36
 figure.set_size_inches((w_i,h_i))
 figure.set_dpi(150)
diff --git a/readme_images/truncation_all_corners.png b/readme_images/truncation_all_corners.png
new file mode 100644
index 0000000000000000000000000000000000000000..1d509b8cf13d6b57b3d2d3363b6b90c282edd9c7
GIT binary patch
literal 27172
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

literal 0
HcmV?d00001

diff --git a/readme_images/truncation_top_corner.png b/readme_images/truncation_top_corner.png
new file mode 100644
index 0000000000000000000000000000000000000000..841e215f4f5164e368d3346a7f9acba782858721
GIT binary patch
literal 54351
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
P{F!UDVAg4iRongvFN_@@

literal 0
HcmV?d00001

diff --git a/readme_images/zoom_example.png b/readme_images/zoom_example.png
new file mode 100644
index 0000000000000000000000000000000000000000..089e3cb5638b63865e125b641f72e074baa19aa0
GIT binary patch
literal 106879
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%0Ae>FSxs>0345AP
zd+nu2P*J0sagN?8&Sy7Zr4oxVrWU|gYI$|B_hfIOlgjSZ;w8wVf$w@jS<K<$=Y>3@
zK}3|{L{K`=100Xo)j456k{9y01B=W(!(yJZ9PRSApon2a4!u`ZMO_J4C6*})aI?7Q
z{a+rQ^@#mFlK`aF6uJtoDsGp4B+46>7HSY_|0K_>Kl3JZAJgC(?x>u9?_U<cy#2;6
zS#+l7jeEMOb-$WE^-j7nHPa2{ksj_IE*sF84Mwxo*j|C=fDGa($-c#Kr0E}+GwFC3
z1?`SWKoH(nEe$6Pm$>KIl=%*3sJ)pczp;v;Wt~~P*}TP8x6P^+SaNs4yT_oGpZtRJ
z+GN(nF@`^3)8Mz;2Lwet9bkkFpsm%|@Q39w8s?7r_m~_qO)-l8-j~+j`v`6UVXOUe
zk(n=awz3=d{zAKJ%?^zfrA*M=dP8tDgbc3_Fs@-sU!n6oXrTZ`G*=t*O{Ak94War%
z;O=wuq)HK19!hpnRopd)<dNNCzWDS#5Wv6#vtT1cT3IN-`2kGSU3DLL$wHW3up)u>
zzB+}l<OEL5>`yjK$}*8hwr-JyWu08FBpo7`Ae(5^THbu8AzeD;u27}`w|b-2d``_i
z;RzNSN>|Xa10f)-y6k|i3~aY$K@CwEDSjkcWuXC|Lu7riPn8VzY!ukLYvFf13gw!%
zH;+_FgPuP0jLir|hhKa+*|MX{`t|Ahh8Cc1`kTEpQWY>cB-_qEw3|_1%TolGWw0tx
zF~$`B5@ok=<X&Ze1un7Nt_8r_gE|Zx;*YErH}m8jXcUn_7PudH<FDX*sN88|LOfa!
zMlPKiI;`QP0Z@1e2hl6L`Wos>!|RR^Yf}r)D{;=vp6_4w(A_SNZR+K=aPbNk{0vjc
zi!-ionq|ask`&^h9BFXqo*H&vEFEvw@D=Ea_tD5|#*!|!X$V=rseS#sC;XvNYyG)|
zFE}#!a=LJpRCoY*fe106bnNyiu(|Mj+7dZg=#18O`S7bXtXHdNkUi(+JIA?e2ZxgY
zFdP!|b#;8iMKe(c>`V1dO3L%A*v0fmuIq=B1@1>F90cQ6&;{*l2TRz#J!Onq>n4h6
z36g?_bRt>2%?YX&LL<_uAPg-fJY}g!cysk;zUPHNDRk~duWtV7O&i9*R&wE`fScyB
zz+v#XTXZ$l)%4`Z0R8lkPxJ}ABe%b1Ho!mxpEr_c3PSQsa7Wy>G%gus1iK!2M#wOW
zHJly8M<4?TMFH$i*1iImjj7=?5E!xl_#c|&2}D_P#B~+{($>3vuf&W$bhPg$6Zrd~
z<^Qw_UY`w~HOKdGE`QR{Hy%w2{-gq^TTvx6n>@6zL`zt66arehWIwl3JpVL)5`8@%
zL&dn-xD?|Cg^2%xznugldMtMxbn{Qb<lR*L|4(o49nN+C_YX^{R459`I7^Ypjxvi<
znc1Td$_!<14TY?PD65i?A}O+!m7OS?WM=O@evdcj^}Vm_cOUohJMR0B`#O&E`j+^3
z&)4hud^{gR<aYbS>gr1P?R@t%ZvD}Q3O<h_im_T~Wv&VtDG|>O9;mx2O}aDt|7@G#
zCuodgou1?a_1lIX?&Eg$tgvF&Er0yn%#>a6bKlh2lSh8qA&gOJ2~%wXkX=~lkFEQ2
z>LQj=MR-9jz)A>n(g$=ZrPniC5hpAG-p0jox_T_d7=-Wi_P8^%_q@m7u(lM|EOE}H
zwm|=EA8U`t^D<AJ_=OLr=Q7bNbcbZMgQ#nX_0t<TN<C0X5SS$3Yt5uu8`FlkkkFm2
z3@u{?MhL1Ix))f~Pz<=JrK^aW<%|)tz*hBaL6?<9?)Frko0U8>+{|~n0N$`aKesbH
z=y|ZqUopV5bs3hdy3rz~CVn4Jh;ge|8}LIrhuWr?uy2G3?;kPG?otXO#72%MuSX#I
z2#Im}Q-ZbvHQAO-m`m)sx0Pb@DG&M89_EubpRez?+P-}n58>}n$2=|E+TkhLaaoP}
z@=B?0n?{H8<W*PR9xd1LRoyI++XXS~1X;rg5oY@l8HHK-xC3L?=7xX+ruViPL3Bs-
z(TOIp=fr2}TWX?lB8}}i-p-}F5;W;;z4BlPFJN4_vc%n)DQqUW=3f!jJd=4MqPl4t
zW$|N7xb?M5{l7?<KB}}9M*l>dt@7Fu%PgJ#S?tC~EGdHI)S1|Tlqgq<Q6e-AMOT?q
zJ~sO{(9F@dxU%ZKB$yn8ca^^9%D(<A>>nX;ahxnbIPHJuN-OBQ--kYZ)Av|6YS0C4
z=?y(Br_zl+prX++Yt>GCm83q9DMBMf{?@O7<r%T3;;upjvkr1vtL8P(Hxlu9;6O~D
zm4bO}B$gU_=<s1LxE%x^l-^3Dy<sTc_W0akg|YSnqn%}guQMK4&ff%g<@RV(o6KsV
zn0xjuzq1c^rF1%%`Zu*^mf;ISb0f#I1FsKjVd$G<GRKqe<FG2GBi3l>Nl4XOO8f?_
z7I&pluvppggAwQt=oJjm2TOCxR^}EyUh!{W0S#K13WTCHG2+kycE>Rj6K#ZP5Q_aS
zU-p=B!>?ZV;d@C<P2E3%4jiN4yhq>oHk2_X<?j8Io2W#LyXtoJr5*XSSUuc4%5)_7
zlC!s$*WrTP%}5N%N!gmamS3s4Z95eeyP%+8O*coyh%rdI$l$7}0)wZcCMGo7eMtz8
zpuOE&`T`aJ%R~rSGN7V0#5jydqe5EdO`h3twl0UoSWiQgwwJ@Xf2U-C8w*Cb;p(#O
z+;C@oO>EipRIQcnGj+7)@}drKC9@KJ!2VQnjdA5uV_UXhGQ_BIVzCETE2tSBR!7Gk
zJZ1B|G3g#h%$`w?i-Ym?Rk7}U9WL7M|H-I{u7eec(z)oTtN;A8k03HfP=0QL0&5HG
za>!0Yr+|nr0my_pc7}U_TR(*rE*%t@#4=(Y2}9GPYKf2NLXM0YjG_=eE6$eHeje4<
za9baT>i5+ZIuh5B794u%QudC0djlAn&6+L+O*JM4NAK9zChD#x)eAT2^1Wf1t1T8y
z`tJKkMmjzDl%78Rk;q3((h~@=KvugYY)Zstn~b1`g?7LL^H_Q`vET?joQhI;h-m>Y
zLT(Y>ia)^>@%SG!RJUYaZl?l?42;{pKJ3D(?A?CN?=D-32eNC)_!rVL40e>WoS-0B
zx_emL9Cs;YIn&hth;I^gup2T^>-w6Q5L>!;gxG+G8V^*m<tzZOP70|D=9u}xhep8o
z03Ru{Yt{VQJ<K6**xcPOaGV2V-kj?!fPml^Xp;nyBnM3;(r_-ji0ZvObm)-jk5}ZN
z`<&xAhxkBXy1&!Pn5P^*p50*A&+sC`+4xbC;kl1Fj>@z<gI#Bz%Z83S<Zj7I&iy30
z`p<inBZ4_hVFx$Qd9M77FL=E)<op4nR6H=ngh&)qfYB#Lc;mnTHO1hI1lsTC@M0%&
z&1~w}y4<lSacHJ6f`@G{N4Y0_Whj+T*z|NyLhMV|=kE+!KJTf|uxyeEv|CDRJJ*^+
zH+7e+Nn#NlR=VBL1Mtk$;$@jn#fWM>ppf=lxIX>t1k_qS+l}srezG|DPvJ_LEe2%(
zIs^8}iH+|+gk6>(SLx(N6e>o4N4QT&WDCQg*J{lMq~n0r2_W81mmR}7!T<~&A%^@5
ztIwYif!=T=4pkw(3M|7_^szKlX}CZ-pd#18Awysr73o!EptKhIc2M+^fLs-?FNr{D
z(5+hb4&5c=ZXT0fb&A3C<SGC4&-O#Kz#!Q-QM!GB`LIzgXZDf94&LP$!^s2iKM80F
zGkd?5QH=9t>IDhM%7jkun=v1Bl*x9SCP->dyQ?8~x$W5TMaVof%`2@y`5^(BW44wX
zVw_V_;<p8k91t!RT&YnL^<b2{;FESYz&iqFF*!D5u0hPqqOUohCMZbvR@@)`Lf|-x
z#6UHE=oKgEFYQuGbNYgwBURI^Nf||3o}-6GN4@j*@yi*60V5B)jep8e?&{(YZYu6@
zHyuGkB8t<dK&Drz>N`oU^Y5o1m;9D;n=_ne^CMOh#Vfz|*4fXGNq*c$)Am<M{9I3J
zLALprhii=372_slSQlW0DeoGIFDe#pJ|FN^(Cy@$=OVe-JZBP0FhV%zF^i(=?=gaO
z!mVdlxr5P{&vX9ZF@1??<7zRND?qQCsat*aBpQ~8IbPBg&Ocon4JC&2=;xI2PR}iN
z!#?&uj|F+?S-_waeh+W`=%9{HAs&WJ$91mmq?)^t*Ou;WhfQm7pe`b=I+?wVRoyWH
zbs|eBmp1inY!*<FY2eJ;V5M9q7=QtYi|9jDJOc~1R<~t61eYgQ+?Nuc$g;87dM_cF
zPT#dUerdXFs@OQaB*OCu2ge9+@MW7^CEfg83sXj(GwL_=J^oH~U+(Z^A$a=w&L!Pt
ziW#k$<W57!-&*`C7B$PbES`I=8`&+s+5MKlTZ*TPsG3UsC+5>Wwde48&hF2EY}aEr
z^!@a(Z=O1*T5m;+<m}Q|Tw_YW>SQIeq{9bnH_u>t1N_Z7UQdTXxOBOQ3aV3`nkcx5
z>KINqkT~ujC;xIo2(KQKl$6xb%NcJoSx@!AH$Fgz;srPo9#3<?wFVSlTItJ(>ZwxS
zb`9(<O?}sZs=2Ya4<_t|^#Q)uKIptVE2d?*k|zI@F<YV7K=w;-<s%94O(hQ};&&Es
z;Ymq_LD1&-Q2l6jSZE#wBjc@Z&XeE2ufj7hbYK?MjeOn2e^b<}d6)l->tGAKSeJj_
zXgWogkK_JKT+kKayOrb^Vvw75v}tkw{KHZ$Qu*p)lk4pCayb9(!qdZ0RX!DKwygBb
zj;ekDx%=D7C(ga&gIWDoYZyOvdPpynf6_wJ|JkvYGy2HxcY41P;dQcSRfmUNVNxgW
zqsKB|-=C7Y9Qz`!xQp$_eg^U`0I?(%D2NRuKquq|h}oZ<nr}0xcgy;cY#nl}2%bl%
z3b?{WJlF=CLr~JG*yQ;3%)X`18gX!$9Ubw^YFF>b9-Vwqv+5D!hUbc~{Pt&&j6uC~
zq9j@zufQ@mN+g8w8UW-eun`DCFJYU2ih!v50c{~A;}9`41V1?dT9ijHWzx(&5ljN3
z|GJ8>qS@7@ro7KvlAXVh!cK6>b<Fwry||C{32D0+P2I}JHKI`~zE((6j3AN7UHl~t
zTJS&8TZb)MoOp_x)3;0yoB5NBPgwBD?)m<i?^lq--RJ+LmVlRe80DM^4Dt9q#0DGn
z`4%pkyq25{iu@Y=YDffjAOE<{4iibZ(D}!Bt~!HF(K}*#5$-4Zu-6<pdejG8k15D~
zmP&p+O0(5Og0@Xg@cNaBb^0o4o0FW|epCN53RF-sUZDgdrfHxd!~!b^om*~t+f?r1
zM!a+!`uSp@rEGf+Cp_XRJ=&)KeH$g?1$f;Of-oXD2=Ly_P@|lQZzPAVH|_CD&FMx5
z1ivL~55LnfSX{LD?D8}D6r%w-#fc}S(|zGq3PrTcil<Ez=lD+!R_ueNh{4<}|4Rg_
zX(rt*rvk%GJ^6dG#*DcMIWX>LsN0(HvWAI^e!OAk#zvlbA&gZXd#DUrT0)P4J)iV9
zj+4;g;mnDGl84>D6Az0srhnRSD^`<k)VC2fZ}5R*xttZ%qjd@&=ZiL?TDWC7ePW_l
zFU#f#F6mWx>0v6_P)UA2xjFoJQCse*xp1yC;-(f(AsI&7`j8bX<oqEs?(l`Bzw8(!
z&R6X)`o9F{t;*Eb5c9Hh+4_Z^)0bA|-yPycq)qC{h36%uKd;YO{r73Q{hpF)P1}sA
zY7?8nq(kTytQ9fwN-V<)&*snOHE5(9*7c(;HF^B;MBAaC0lb8p5#GcX$ms-o4BTTp
zdLoXa!}T=3;nNVX?r1=F*E=g=Vf^f6tS0fOD{t8p;OpybA#uoTA>3Q$cQijXhU#s>
zZWIMkad|uNM%i#~1^nA*$FUf?dU8$Gxlx0`A7rji`3LG+7&=}NQga6i;7%~7iER(W
znBs=Cw~Oe-y%@>^XW5+7PIy8wox1C=lC9*%vH2f&m*KHI?`H4RlD;I>G#n$%`diK{
zJ~(o8A_UVNcn5tvAnf*9Z;;}EA&)MDYB)DM2tJ>CGsH{2b7wbbbqEWPtl<xZQW*C8
z;jjyE;n4j`6z4>0k=>-&UgXOFt9KWg!~O2ACeEUuiV0uDzb|uV7Cgz6B)H>eqWYH)
zI+}BiK_R+uZ4_foSZn5=T<1Xb*Y<<T?@!P7Rqn5s=zxI%^sc`ars~{G%Pod{_7D?4
z@~7_p&RtT|4=B1O%JP_cgQ1VK{!U^`9U|a*pO^`zJ-F{IdU2Oa(Srzwv8^n*w6?Qc
zuk&2pU(-w-B-H4Su&oD9&baKS?Ngmm5qSE(CYB10ih${kyY;JfkP+<`9PUk9K5{_E
zDj(H<LV;CKFqD@?q?~2P&Yk$PV8=xYmcH4Nt&Zl^Ow`nW!n0OB<sQkjK;1)p0~Z%p
zM;r1-)>((J6$O#3W9MJ5<fN&7K80sqd1k6U3Gcep$#%Z1cv1pxbcZ5!{mf7Vl5jvf
z!C$=d++F24H3|a`z@_Tm-$?84m0|bplI1ZSVZ*!0@UUcCYRM)8gC;3ycWV_L)F`-p
zuT<jSgKF^Fmj*Mrn^|f<4Su|k-d1HS5JHpXnTb&$!Pq3mz2FAVfe-$OLzNAWSoCip
zaC;!_+%??tsS^LTA-{bBjg@D0o^8J(A(f4BpKacfNk|pZdOLQyH^MJ4X8=w+&Hg{n
z_wPsp?|C6E==Z8So<+m`qO?necdiP#ippN0-8p+_Gn@~GMh*wH6$Ig%-p~E*9yvUr
za=qd-?6V~7j{gGZJ&c3qSa9ubYm{18R29<|V|Ez}U>0<R`=|V3HV#71sf!E(gL4HQ
zE7a|?2rvL#69Z*aah7FSy`63XGM&(^5nlFe*&{H|f~)anNM~n#+wiR7snxe}g-HY<
z#Wp)QSL{o(A9NxNb9(@o%w3Y|GGDBTj(}~|H|4nRA;e;0wqWy7z~ueh$k519Q_q$A
z*Bg$$%|Dqd@$9z7I}ApjKct&;*jp9C_F@O^S?eFgSXmtYQiBdjACl~{lp&}Kg?ZEG
z;|F~$(u9figYZ&gQ#^ci{$>My5s)kXBttLXlp(?_2otRzc#{ri)`oG?L5^wwi5fGQ
z>^KV*K$C|Lv|jB26qupZL->B-8*ZJP!zMczo)w>~S{iHHh+GRE+k`MeY5#QF<0Cas
z+n_=@WZjX=t!=F3<o&}QEtR;n-Z16I6S)_ye{4b1aI@=fW*mKG*aJ9v$vnQ%)m17+
z)8WuX`g)`l@N#AAMe1-)y2a#F!^u0fyVs@7gY$MK<Y$w^>3HCl6?fgsJxb|kWvs{K
zf{WSM&z)hysayiXhDk4ru3-kpDCrRe@B(QRzrR~_xQ>ZSEDZ|)b?@!7BhNvBPh@XE
zniW%&>Kq|@=+M`Ia%$w|9+y~KwoR~sV7r;eR?e9{R&w3w4D?x>`4jn%TlFiK(EK}Q
z=Yq;HteJ)Q?)jb&B_e|XVK<JpB3+c`qgUk1f{dcY4^(3o*9fPTN4vT7MiY50n{K-d
za-c)htM1ya{%ZRhr(00;js0YV+7sBsQU_*ApdtG&q}LYuHG=B;b$Ow`DSCc*iUFoa
z=N>wp@Mgub7)XET_~GLIp?KQex4}c@1uYx{rOJ7C?~52{K&2IrT{?GhFqyJ|8}6c@
zyb(RQ@N2m?gfPGz09Kf22UMkiRZI4d)+Yq%_suqfPu)iNoYiNc(X7T9DnX)`hhc0~
z!l6Uo7iUXgE>_{2@jy6f$3Bwpvtx6LB+2`xLOH;E8?TuN`66_cq>oB+OY%?7vc}nw
z%?f^tYc>63@Gz_2=0}%W0zR4l<tuJ^G*g?@UyvRJmP#(6%%i|okQDyL!E(4(GU!*1
zuxtwhch?*f8@jqa$b8|eRQ9(K#I;D+xA|dqpM6mK4>2nP1{5_&jAlfYa1I;q6MEL)
zsQ(l-MggqaU_jR4x#li>m}d0lR;mZBnQ3fs@46I}3yfV2vPGueYByc}bQeAJd|JqH
zTjOEizpFhowJeu8xLD6K6c{e;$#by$2<z&pub;F;ov9%Rvy=Q=>~;ZkGlCH=;>g{W
zAApN4H*fD<4vrzg0K?cW4jHrMEoB%Tkxxh+*-lP=P>f7^5@^toOqz{u)aKkM@F6-j
z8~=hnN(u@Ehf!drKT>o>jjJNQ0NB)xlK*^9#D0fmpZtxHmNOU#>4gaMEUvAZaMk|3
z7|u;}+j-gowakrVm<t7Tt%dWrPJe#gTUiI~*JRJcz%AV`m#5^lq@<P&J)%zHU=?u8
z#2h7ssRfA;aOa57cZ`6c&;yK*1%$}t6!$^ij}kEbdL?ZmnH<a<E)%q>5>?*rbkIe1
z>@bA-o?HIONlomU>ko>|C^&`l*R3=|9WnM5d*+G)i<`sRvq~I*DNOm5ko|TgqKc|I
ziX5x!6RuMIpKr$79fM*D9AW=_kMWehzVrcMMVAj}<NrCl1+kpF_CMD+e$s*K9N&zP
zCF+A4`5$xRX@(K)ja-q@wuvUb<8d+u2ZXAYk`oSlmwQ=$+szdx<2)MSIC@p@J&9|k
zRgCECok@R6l+T=r5OX>X($L+C*iLp0rHhpKN4V|Ix#cm6G<Xid^D5?Dc&4>cjAW<v
zP`u@^)`i%P`CT*|e=;j~Si|@XWicP@L=)I{`qx6LU<%nI-iH#yw9iKkmSK=Zu=TMp
zUISutZfUZytua+U0TXLb)Js!sIuXs_*x_6@W&@p%tB51O8X(;hIc=*t9cJQl&_PJy
zrCNZiKQv0O{iqk8rWR~X-~W(KSVV-D8!zYY!c9ljcVye$fnNZIR~8xr9qpzAV@<*1
z5@kW&X+{C=`#4C8yo+8)-|X4`N@>jQtUJ2LPv(10*&lP+(aO+q4VEk;jrwU+OoOvV
zW(6w`h@GxFW@OeVOZ9YFU=y6=!?^J`ZJ7Wm9)0GO0O2+duFNct=-af%-@}o^DxcOU
zeGgQ1zvATrEbhhr3l{UaPm<rsbB$XY-~9Sx%deZ83Wj;pnr{GRqldpE43IFm;OOYb
z7V^IN2FIw|#fqXZH<VBPk5|woQo(Q&9{9Q+3cM~5wt7)LLKjAh7c54>CG#pQJRRPX
z(K;eFRV6TxO_&X~cQkhke=rdiQRr~lY14c6h@Ai0*7<I#quSICqh9^7K}$OE{~X=E
zICF1xC7{fzjrV~Hj~0m{rL?9{WLh?kX9Z4RSHAxmXMlMo^a~+u(C?3m*Ic$Xh+db%
zcHR=}8rCLtnfVF=uB&G0{5n&&DBCToHnlK#?^Ley)l4JDsZUK}t{Hq?Z~Y{sb7cnO
zr|>SFYaV&!+PD9^y-^K|nZ;p0Rih7t;&5eghJ42ksd_>9Xfky>$M1y|JJBUUt$GO|
zFo7iuJ6vZ5)pb6ao`I#>H{^j~1a#Bo(`~%)wzI?9z^nQn*HH6XjX~)_0XWyTeD#kl
zegbQs9Ns?N45jjD-trZn9>s_rkFz%H!+<;7R%RNxD=md0pTg=JvZSuKAPJjtiIr#V
zl$B4ujI@@%JGC^spYu?|n;Fwc*b?yU6Ll;t2nu0`nl~b~{Mo)YY8U5E_+EmqpNQ*|
zZ_ZQ8Iq6&cd*#pj{{w5Fciw#O^aAwaAFg?FZ2lI@l4o;W-s0Ei8Qx7VUX+S4dMpzj
zosmK^&RG*WRX>v>ex;O*ey!b|x-m;ptgAA9JJn|(V!QQ-WxzGtH$^>I&%vj90zJpc
zj(*Ac-<uKIQ;OH73Dgh(ZZFYvz!!zbJQ9GzO{C)qS+#wGQ&LlgWu$7H2;sH`$~Al_
z*?4lt?+Q%NTo;OTMry`>ahH#9rfda9M=$2|zEZ@w@SC{P_|<ZzAPB6Nu3K@8ooDWY
zIiWwkD-untN=MMV#V9t&i3-kC-fQ1><D*AEtSp8}d;2e3{1JbzCfWf0Nqzg{x><R5
z!!kX~Jw~k5cEWkyX}ElW+EszHVP?ow+S@Q$n+AR!<7{B1fqVQt!`cy+KJ7(fu0pdh
z;_d04Jn!d*&E8h+dB-#)+cG<n2>1UZaxej6HW7l4487k0$tAA1^Y~-a=V+dNK5xQ(
z+sz}W0ewDc8H|6ULD9;Y`W*aC*<_fK*x&-fy3`0nEW&5I##WXC7Rq1W8x(D)q{N^2
z2?h;1x^n?%Pq|DV#axZhsew*+9}kLv`=T8otH!>_Sn(ZxV~1E-pPsOIB2dSq0(BqZ
zhJ#C`n@=zoh*UR_Cq^gTC977D^!nMYb2VxSA3}7AqOb7>+rK}KtoxmUCJXOWZNkG0
zB>eEPRvxhxK}NCdIS%`6pL{eksuKQl-6d6T_kQ1>6qXd$A1DqyKyUcn9^WZu$uO%J
z{rH5Ye{IF1O@!5Jf|BD({)hutcj^9+o39VOf#|R@ybct=UxCc$a$NTHKG>*W2|0~6
z#K+$*Ok*9oa4=jU#0?{E?kk^9zcZCKz%&HT@9IqpSC0-uf{QeZ1NiI1me&A1BIMbi
zSP$#r13C38_}PCu@<frwbyIzsUdEsP3=FnYqFR8k;|~T_j5h39EWzu%Y_TeFgwTYK
z2ngX(TF%OqmXd0FvV@_}bHHx|ljwN#j06ww?ie@fV;X{N7O;MMt$07z`5-^F;TnU(
z#LI~*Zp;$Qu1BJa^=PP8zU`5R5$8|`Q?&wS@8uBS>WNqR(d9Tm<Y(COX(tHRjiZg*
z1_BriTC!*umknx_`#`oBY837pxp@5stISovBYpd9_Qk*VdSGZjHNvSEEH1iuz#0$;
z7$5znN@923T^5%2qkWN3k|DDr>upib*Lz(l&W05Ct5HKW*n&3t52{<fm`p9MYZ%X(
zM-~${knnok{ipO($IgAniqmT)Djn;>h2&oVP76evqndc>ATB`$WRJ*_;lTW6?1Q`P
z1{YG?@r<zIN4DM-pMocZt(hEN=eB2}XjD<a<=E-b6~qrASi0^G^=^_#A#s<{TFI_h
zPybVje^g)j)bUZToDjBVh|{EYQE=1Ae88psJ}V8S+AOs7(<O8=&7XZX{C_<>3p_XE
zxwM)N&pIH_U9cHu68UTuD{*$;F|T9lJ3@A*mb@Oz7toNo)ol_>G(5!P(kvwn`b@Wg
z;>i+g+CO^W;Uf=)NIOR#TKBFD0&Nz=KCtui!-VCbzyCEPb4`!5Hj<T7V{ezlD#ey{
z#PQ|f%pM1?9w8e~WENZ1M)MiT5dPCZ7qq+ke23jCmd1+E&J2d~g_q-xPmX_od7n?)
z!khAYCeMwI8}g*BDbaNkd))6wVI_7}Dx6pOo+IqfKxWa%uymunMe9`A7k#Y}<m4e!
zjbJ#mwPE}6BU`$?sq{Dr_w$h!c&R?G2)$Ll>K6Q8dfnC|OX>axyxj{)5HL7&F2iGm
zS1Hoif3IB9w+mHR)u#$gd>S`^v3}G20@SCR`2jwpCB$bu*!lTw(cv*X6?8@v_wz6c
zYOsaAtQQnVzlq#x<8Hj?%B{t?CXcZ!Phf0UUsZm6QwS@fu87JJXz(j1eNcw@pldvW
zFLGai-Q)2rrh{2WGFegR+Csq>g#p|{!Y%q$dKu61Tx{J7e9)zIw&CW@2ZRcfQyFS8
zA81J47I2^l)vZ6Xb{2o1#OiXrmdN~zJDXpery6J=Kc@M>XS-HG$BU&o^=pT95)=oN
zBm+k8pbPm6A^B{rq$y+pUzz@v9*!z{ki`~3m5wQ{yz#TI&TJnG)?`F&x32Vt>xNdH
zzrLXk=Kf3@DY;7T+M4kjD(Ll=xN@*J&B*Mf-e7fPoaD@2owC5hkH9T9h1*B$MG_rK
znhzW;m*Dkg{lTJ<`;7$s4rG<66Z;Wi6_T-l0YsgBG!e-4c?^At4VFi^ya$!{JUzn)
z<PG!M<F`a^N8JK3I>V~H0u!te_@}x?h&q&o3gm_nwe#av=__Hb_(l(B4>_x{`Kg)W
zPMb)1Hd-#NLUiBs{V(<D-8<T{N(UY<%>~qiuy{B%Xp_pYmzA*;{Y);kDdN;DjrKds
zVcI%dS8#&jYf*suEx4r4E;Oi8mehgjl4Ixl4bYWX1GcNnPA8x2?QpmT?`(`U4r+4K
z#ZMX#^5C~-Z9>7Mz@&__eh8k%Osu}IT4qHt#gC2;<uoyavi@-2`@mGeD~OZ&wVAnD
zqbkhUXo7drKG)6miqSyt_FK*GA3(fl-)zQzpDBdC3jX{+mL>lmeP@Zw30sRn_<Ny3
zY=+94$W_8bgD|ds{`|R9&;pbnd@yYT<A|`ZR-HDEeqqJ{&7%<#r^`FeLxK&8^7*OX
zdH1Mny%V1QaOIpsC@h?xJ|A<uaKT4Ert@(t->RGVL|GfqX~M$CA9Nf{%$$cmlQwv+
z88C=5xZd0P8?Cx<5+XIu`57*DdH0O`17+}^k|t3{2TNWS<FU5=Q!mezev7}xYuV-l
ziG}(rAHR@=qY45tB(Hw!+#shC?xT?nn7Uakz3=$LV=89{<7rSZCb>Be&kPyiSAb;U
zee$Ql2gfnJif|s5pSS8Vt@VjNogg2AkHFu$xNU$KUSb1=Ll8j<{c--ljwRqisxQxy
zBaXEkQ(8r2hJi5QaJOt2_CX}|?P+#u)Ohr~s*U{y|FJ2(vw7Qh`)EwQvL&>rH~P&D
z8Tt@vLn)4ZGtKN`(w>((G+_0bTP|d}yRSUti@E*cCv@k)!;Iu>A~m*bH3YSyve>t#
z;Foy`khY9Fn{{I=y^}!cG?tbtML&F##Ez-={(sw$;lvaAaB-N%w?34!QQs~N#<`ae
zTn7eb=_Q_b-tLG5gP~ys3^AEj<CQr|V1`?cy@4h=vLyPyAEpIvDQq7f5I>)C<y7jm
zaSPcmT}9)=>6Df!EGKVkydeFBh@3p)ImW$#JKJoEE|W)q!{p&72c_S0>kgJecm(av
zjqXzLbsgqU^aV-ET(5rE@gaWc?!ud?e)55qeQ;b14BCrvEQE(5wy#wy?<UZq>|%$2
zxi6SC&42$rgu#V;JVD)?F8p^eTM?{)Z%+l-k)$-I69^^>VGvKKh`jZudc*aJ5-RmX
z#+eN}s0}V0+|)0i%5dtBcKoh-GFbPS?HqSQ3Po?lmtfY5Rw;H&Iv-E>R{6I35p_|f
z=^c1e{GPn-tskN>I;Z4QKP3+rL$ji-(~cdt^pEO4;bC$4WF8TPwF@*xU}}QR+N5=Z
zy<wb`1?Wo}<V>2jQl9PowrMQa$c^^l7U%e)9&E#`Nq3IpDena<jmZ80@alY2dznb@
z0>uHfpyK1!4%lyE-LC_git4c36%1;isiXw$N5STDd9=-Hlq*oQB#Alvz!AqCpn(E_
zV1movZ+s@CxK+v8%Zd+nJ>p|+8Yz8T486iMQkX!}wlCc!$dh>@xAfXqp=;YgT4Zc>
z8`4nAcT4<J(#}}rn3NDB)mwhgtX0T6Bh#PZKKl6!n?uOii(v-Qmt`BESpBLk>mC#q
z!xH2B|D2#2ioa*eA)6Np3zFlyB7}dSh|6Bx76#wRf&DK-Ut*ahS_^BS&R<3dy&ZJ+
zFWCyGGH}jykhP;ge%zCRZR!PDdA+foO{|XSu?TNCTPsiTg6Q&g6insOq<~}zHHbjg
z0jxDyHoXJC-bG4BiywM+F~lEKzZ<vDwlEBi>dFI`K=0hU8Fx=bJ^5vO_I*rseXUK?
z4OV||zA;uX_VlVm6;8ZwqC21_>#S+PS|IJ7J1(ovRG=~c{b4ZngDib>qanbv(sxHC
zAah~E01wDH<Im@tW^H<T?T0`Rm$@s}V(`*Tr-8R00N(DWg^RW5Dv5L&+%ac<y_bZu
z3|{zojN)LofmN~>%Sc1AW-YLDO;~`>j&<^6iJx5u$lf-@5K$=-VXm-ef*A>`xuJd6
zbM{y-33vas(fV!FrWOMS58j+&(_k?N>TF-Uoy)+$H?V>aI~nvf*DCwcu1IiR7TVD2
zdVFm?djAO5E(@)QGQ$OaILOE^%}F0>Gz4d-{?6tBfa%035rhT7p<HKp#ZEju`lok-
z?*eqnN0eg37)2epI>M}pfej|t1jd43y>YwTEoRSTATcxWRZH=%b+y@F@oIy53?mJ~
zi4!p}X20I<$Bpd5>=9yn{Rfoy#hiaP@nMSbq9&$9@cNF~zUnV9T-Q^7PU2GXFd~0d
zWVJt4w+KYeSs_cY$V%_#){K&m=KHSX(2h;L{$x?dseYG~Of0JEJe+ag^O90$(Qfm)
zZ?JQxoIvGvc7pIktm4-$4p%=jc*akLZq~^;x9Bin9V}E^ZzDAT<i-N}+D!Q30(vO!
z;iBj@#>C|i#M;Z)`fkM#YdDU4C%!ld#~WyEp?52FR<y~9!H~5f0__je<JJ;3#VDT=
zLu4gVGK-I*^O8rK4zF=>B)S+t2hJ?+@$h;%sZklj8WS^RS_^~A((Ki=t24x|)$BS~
zDrU>pR>0DKsxpEP{!Lrcn|GGGg>LvdQMG*HYXevC7Z+&t&Jy877W)f+6B)mLowsnX
zJSImQN~PzQhjZP)Hg6r$;u>JKvY6kQT4e)}{xV?z3m9j=&<(AIZtTy$amMUiT>d!9
zwgYvK1tGaa+{yu?UQ#H8L>+GU&;7AjJ~fAy{BWlC#vKg1G)g$);5&KP<g{joo5|sM
zf=ztF!6l~%wpC}4Uq*ZhsgcC1OfZuc?iBTZGTXe5^J{hF?vdOEN7#6;%xM*U{qFV=
zv}|Mxz`)1$t@0^IJctSePTq2mk-bsgJW{as9sJ|c?!LeEX$4Cue0$P-z6iN}p13Zw
zSi!i#1e93D!h%(Q-9T}6SW8-(&${XMXkbQZhUKLKi7jON<H|Hr0~c~tc2kosOzvOn
zY<P3sf44$K84K*tK%G!aBDGq)RmRE0#unlW1elZ;wk?#5CvU?93e#l*{=ulhne~aZ
zP0zP47O8oq;7c>lG!g1mVk^h~kQ>2uYl9+)ah>eZxdYa@UEx{a8`ys^sU0o3<~xKI
z6*W&BipZvrh;KFf2#ZEME@q7>OoXv5+FimsL*hhggtR=H)AwH>P@KF;ay?TzSz`bR
zTXS7Rr5td;s3mQ4O{_38eBn~;inot#-SCL18(Wifq^z%r9<a{;n|CRn>pbOjqh1l?
zh|Z1GVS(vJ{cS9(yC(i?aY9js&pcE4q|_vyvpt{UdL;uB<HW-6&G45quD+|A^N%W9
zqUyHMb~&e5BmuvDK*z9SY3{&Msw#VpkBa7ZHI<>I>^jl0+#>Xogl!TYsRS&@Zc8JX
zxiEL=c-XT$`KRp7n>QP5f&i}?0Z)hQj^{t-#T%CjVFA9-zVN|$iWuo+G7()0-o;7m
z#XkUuB$l;)G%EtjfG|yI4IB{~%iSy&E)~EqP#tMB*b=tX>ESmyf$L%h>KN=bTi<F&
z<S$Xy$A~vwlPWx`E#rSWRfR0i3cfvg-gy?9YRw;Dc9-*3gOK7%e5TzdXz{>)L<c;K
z|BTd3BZY!f^u(v3?a4}pjOe}jKCv4{N3Z*f{cWULoD*iwxm6V5ed7zM=`XI;6+Ad$
zoJHqZ_OJc2cltvP`?{@E4wl!f9U_+TUWu(t*Td{69Iz<#Dpf?D#JiJ<$grRR?T_%g
zBTTh5^_)vugBcI4FN^=qKM3zuuq}S0_9c>C%15wI4@@7<fY6rJb9I?mi;zQeVsHX`
z#s`Fe0t@N2vq}Yz%xTf=vn$;`dLO+keho=8tpD+@j?)kK@p(>={YuT}_n4p|&vB20
zyTgrWQKOFReV4^TDEuNoS~Ac{BmHpgOzLI2cBPb(j>9uQF5;D<9k1Ywpk%xa6qeD{
zqWBS?(GMD-vQgesw@4rEySI7U^D9~BTl3~$PK<f8o{RJI7Yv-~4G)^#T>9>FW9mIW
z&$bD3;ZYc;pNW-lrw6M#I5-&FS`g-1&H|5%Fkh&}1GEWVz#n=X1U3pT6p?_F0Wm_&
zbsqI^-}hO9vi7+2<Ak4TXFjisAo5_7^;vq^*J52m@=TR~*pEDf=VW4$_jQ$v=i3UD
zt|n_}i8?;9t=cp@{g>S7=J5>m6t3%iB(SynXXXdTui24{ooR7(zFlv9w)cxpa9`nF
z6?W){N+Kx6Z)EcN`_^txn8}}Xblc`+??qmS2az7gq%iCDgI>Fn6m3N0ReFz~y2>TM
z*!hrL3SYcQab85;Fo<_y!6Z?Gq9$4ZM9_he%mB-R`9q@;HPQE$7Xlh(4p3AU-g$4I
z%t!Tbr?b6RIiW$s-Q7fw2wY@IWD9qn90swL&{q>oZ7i`9kZimBhx@ou{d2mEVxIyV
zL>^IMH0}y2wPozQypM35KEO6FkrL8$;sFB@MoH0b3{S-TxO8_xQBfC6NF&Qw+!o@~
zxNM(r$rK4)7P4law3Iy)&i&qms^P7f{MDn>j$Nd=3$N4EMw`-LW|K*?Kv<ms2F~3{
z_gtB^`$;(L9VTsG9}o6-*anxgHP;ElDoSw2jXGY^=+;D)4!psiB|Ikn#I0mKo_q-`
zob&Y0L}lr}*`w7*6@%9~IN1HyAM@ysSPGL+)+K=&od||iBJhbM_$VfUeD!(evsHa=
zmdbOr00!BGy0v~iWU8o~vZ22&Wce(!e%@O>*?&?tTrnwxJukXc639p(8d+j2&OUgA
zeyvmN)sSp&b#g<oZxHdu&aYYi{oyq?)n+SeKejs1>5!wcFvWSo;q4G>j$05VOvz&R
zJ{MF_MYPbI#;$}7D(*(5@}$S14bwGs*aoX#z53h*{<jTaoc#&z&TdnZ+#evIpjr{M
zDmnM2BQJm-^Mv?AtT>{%_Pk`Zx|cFfDVPRF1Xp1@M~ocK<A2(;d92%21`9WJQ-wYg
zYn~sgPYCEQ3s60FSt$P3Tjjyb&d?o{8gDM_>0T@I)^k3W^tYa6#kH9~PWAd1()d6|
z<u|JAMl4qI>)Vw>j;?y*r8Aq}z_zW!=MmR`cA)i#rT(8B-K2;60!p8TMjPQLD-8K6
zhL^^O3+B&c5vqCV(M0^|!-^ZnrZgCD+osDSY%Mg)w3MoFpxaqj(|rDB{A3TG$Qkor
zYJ;_sMx$|;4#rDK8%YScXRDCyJhqSC)c@qI`XEugzr0UH9aBi*Eu;+(Zo0fZ2etou
zGbm@1aAvA+Kg9<w?a;>`<esH)swV_08&fbii3WI{bk#_L9U1@S+@@Bu<$Jh~xSa&O
z;bNYAXql)yOs!wo^w+#2Il;G>Co7@&pD{6UwvG&TC`sk^73cEk9KO*m5|>L#8VWfU
zK1muQji)g6pV;~CLe#%c$NGoMKgOq`uS+CRhkKd*+N!$}i$wGPe!QEvF$5I+DG9^z
z!o)*H`;M~1A+sC@aR!Zii*P)G+csVeLVpqB^7OE(tY-7A2PzN!sGh7Xj2BUn@7gup
z(-lI9$To)B{~qmd6PON?%e!9<KgLy5wsM{<{Qd$aLrbA|_454JtlAl3Tx)Wim+x#G
z@xPC?&+AZ?7>NP2MKYLJ)(KYEdn@kw&w9E3yqaCO$@^A!r~P1|W9OYv-9M{KR1fLA
zBZUn{ub6grwEDVr_Qy(BK6%7Jvphq$h0Iwrc#P;%Hrf@O1!bC3_jAy8CQ1!d<^Q*%
zzBR|)mbKY9eZu0Y;Ob+v=-0{(-A-Aw{=#K0%Cg<P`|9!_kAB5tRA2<*n`plge$W@T
zhmBYtcU!&K%Xo@3Ue;OEcMW!H+*fYDJeL<;?76%my!R-{-+EV3Ur%r!H!dY{NR+{p
zH2AsoAC~gb5)=8G{O@1zagvYz$3MO*I!pYH_3u4I`<Hjm#!umEKCrd?uMgRN(D0U=
zclrOl7#}?;{{hHn0GMbrNH%|M_Es-Xq;yJ_0~B2%CzZ&-!o&e>PL-%Z97<v?g8Yb%
zpa)*#Kt(1|3YIqY0X-%(tFU$*Z!!uZXsX<LxdZXV4`6hn@>+gB)D2R2ITCd~9fMW0
zZo^c5#HkFd@xZ^}?;hw<rD^MZ|NaXz9sdGI63>c{C1-6yPbCK=u{@Y{8*vm^D#4Hw
z9(2}!8;Sh+K-G?Cuj|n57CKh8T4f5L9w#`x4|eT83d=siJ$>=3S-w^W3DH3V2iSW|
z%?CqF1p4s2hbekuzx%;VP6?9~y*yb06+u@6B4iwT7GPFR<GSnD^pz#|81KR#KOQhm
zc;JqROzK!ztf_#(j8;ifljT^mRcF2eesBR9Ki%%DgrzWIKnY1WczD5}gAFz$72yoU
zq6A+<eE$Q->#@*Fhl!xiPxE*bE(kysHIGDFJPzV-Iy^=RWEGGG;o_1P!LVcR(L!ih
zn=-9gP_#mbuXhldbfAPwH~I$9dlV6acnm2F#YQW$<id`Xzy=|174conGf}C1`49xc
znuit48DjW>i^2<EVrI|fi9}1cG^^3(baokScs1|2jhrx&{L3AL0S&@@+%Oqn6n6=Q
z3&s=_oxDgxB7PuuQwQ!HG0nux=@cBSK3Oyp<ESWc*Iy<!Ie%<lgFe70;T8e5!3V2$
z5n`SUt+3b(?Z#thlhz;OstEP>@j+}sx@2TzNr0KN7cX&dN<^P=ZUqS)VZzpWCk(!N
zC6)n~PC<2)fZWi*`(ETIDA)Er$JKcg%5SrE%a%mA`=7P6ogPpoOGFpy!fBj~6T5W+
ztxIgJ8-53|xP3xE+6?aB8_Y^L;@xuIN=r+t<92ns*M!?rF$i8zPt_Cu(!UaKH9PoI
z4xcEGt-8K<1$mQ+D8b5{h7rf02A1q4*##@-PUP@Btv3FIW{5sW6B`c&lSl)*EqlK$
zp|IX@3FKtomOjMLsy=(2L@+tIa)|fxtWMvLJ!~lbhFdd(h@?hwWB#W&VOqlar1wQz
zAIczvI36r@{r2nxCz|Amtht+z=aHawqC^(X(tDkEd>_J(D&IxY$D+JLPJ0a=LKvY6
z;iAnfR1w*?0m2<V!BlPqZ-babWiDOXjT;e<{|LbPwspVWhEvu{Xqt%E7W(2TZ22<c
zV^sD6XgOdj;*Yb9Gkc~KKDU!6w-A#e!nc%U9?xVm9?(>X)QM1#^yc@iBM?VPly>8d
zyo%wIM5L(5d451^A*fuG;pdWQiFq{g#R(-Bb1fHf<AZ6nuVkfHhVvL@wxXO@@-KtC
zeGx`3T@}(<)p(Uj{<u?7#ZHlBr_^Ko3gu2IhITvYn>TOXjIrlse@pj+OF$Ed#RKp`
zHv~gQc&Z7O1)_Gpn+Wj0N)M1`S;T>^gZkV<K#_?A4Z{14V4eExVTJd=R@9q0O8pXu
zg9JDB6}Yij47|i$XTPVLD8W_$)nkBuLp9jawkwPF&`9r`pLOQP^d0877oqRsjjV=N
z7+G`*SS?68^JtB0qMqVV`H_4<g#X5fITLQ@1Oc*~J$Aaet?tz03DmQ=-lC;bw0`#i
z^DI>@t*_G;My|9N91=^w&~+K>2w&gp@#_#t2|}$vi2vQ-oj{DHuwJ-`YTR92nbSv?
zSb~4)UVc0>#2mPrgox0=gYp8<G+|PVQ*q+c{sYpcO1$hkm_yuRyfFf3EwLVT_u2)b
zK;b6tBLs;ZfsbEdelP_zhseajn7ITQzC@xX{!v1|17gV6Xi;GP%#z+L4_8Y9*22x6
zau8hKX@Vbqo_-PqVyK}|WcOPVVjhH8#v$Tv7DeSRGZT(`1m6KNFifR=T*N?}#BALL
z+!FfMC8=37ghWgufyKbVg0QOri+iTI3csQow<!*jS#-;AM#crYj>E@a2w8eaR(Htp
z%R({W9TEu;vB#}%1HzuD5~wY9dJBVcWfbf#?PBhWf|ASQo3Y?oH5lbz=^&hp|BVmD
za)N+4PK-s1@QXKfa*r97JWN9e30)ciJ`zJ4jpQ)U*cR<Zy&20RF#9_h5|8vcY!ib5
zW75Q~aOjh*nK$9ULBxx|(NsC;Z*~pd7(AYDIH`Jt5RQHjC(PGTw4o{qZ|uCM@(>j6
zbn~CbJeDWUW1FJxUO>x2jVx2vB^bV!LxS2pGn|GG!gK5{WDCrISYPo#_%9}_B~fDq
z@>#UjuVRYz@!1YTT}6=9+%j@E;Q^#Ic{)sR3USdk<?9M>B66AWK00Gbc*#7~JDG3W
zPsyfQ6-1KW3?bF+v2fwj0FjBU9dD=+a4T@^m(E$8=f^@G2DU{R{fVjWAjy|QBE(AM
zWSn`*l~yOii}4in8%K2+ULHRZ_%DuB+xUhokZaG%MA@a!yswm~)ZY}2wp+RGWDeJQ
zs{M}F^wEUYYx&)Kx4gTI8p(G|fNPiF@jm^Jy#p(HD*f868Mit;+p{l@34e+)xfrH7
z{J~{j*g)#*l6-Z)R@c{w@bj5grBidG``4mbw;?@E&}vtjNLBZR(NDGdhc%2fQ>B8K
z$EWK{U3s*2yUcoRvlV7Lnl;nJa@al)R?BVuB94k~u}Le8wnsE;59Qow<`09f)F-S9
z_Q=}#2@j1hJWKX)qgvm^+q2^Vcs(cnBRSzbdCea5HG5<x#D}WDC_xolhAJ2$$^|R4
zkvk|UHE@rWQB%yAkHT0W5!9bIkgFwvG<$vpIbiJOk$CHqv0A^uDyKZso};P$PDdU8
z{q#!;V*t0OCEGq(#Ch`7A~bgmK(oVMn+@W1oolX|@XePERLPGdLV3+m{S0DrFb7Ts
zBPg9?V8RUI1yRLjgy+eT)34+uR-|{BOur_WzF`>U&oo0=ZP}e{UvHJUegsf;mpIpG
zR_0)|a17{)Ikt=S4~63j@qy;Q3-2hm&YL@@>KEv_!*X>HTyElEG|```;~7xK&Lt7j
zx-V7$JGVO44NXv}RUoU@M5m*PXMC>7^=3}8X4o;c3rQK4VJ)BJl4#gNTi%~ZDp>RQ
zSpE5y?Dgt54TC>rR~D01C>V}n+^FKa;+b{hsmh%@vel6Z4P8aD_QQ#488>8ga|cEp
zdps_NHO~ym{(KYPK&O8cX6UjbZAlHbwH)echJThQC~#C9@inoY(~f^1=X3^`oV1Dg
zWEQ8^p3T>}_A}Xc{gDa`)tt5w@$5LdSwVGhe!^=m@>y*fNC6A^LRM-!LR)g1o$_r>
z;$xhok`y9CTXHm$`eQW*@6%Ctn%JbcuO3e07qz>Pgx%kKM5jBq_2WfwGQ-T<PENS9
zB``1fy{bv0(-%xRQ<s@_i*>^N^{j2x{VN>?FGE$pz|cfXuLc_%=)huB3zjGSL@7gV
zVC=4OI;sFhLPz8MkFa=Cv7}&Ciz7-L%tVurlc+TIK;u|P)$M06i)|3X^QDd=QXMq2
z&lM4Tapnz)!6KfkxpPvS@hzFwsfZqVg^f!ces5}6FJO}zI$4e9r`_OBau#T-Z?Fd>
z5Z{1|3w5khKRfFfMDm|q=7`T<U9^C;Ywa5XeL%UL2xfViQ-|hI9}4=tyRB*UkB{MK
ziJ~cqc!<&eCu2=~gFW~SAcFIFyn0t)1(isA5sNudv;9P6YmWu~KXvt$te4M(ty2i8
zL)Z~H+MnPB6O~_3K2;{_uB5Y1s5P@w)H-ry&t3M=)-6a;%eIp}l5ut#clqbL);Q1B
z5m_=ajuQ?yDg<0Ft6ZmzZO;jKFmtaa+v)y;V_}6h(;l_K{1){xNx!f5&qnIhruRe{
zefc7rH!1t4^;MrOSB73*=rN6|&ku;tK7Ct-Q$x&UbwD{zakOp!+E9q=$dpN4C6`2H
z_yML+4U4Z!7Zk;3HPb4GO6UU07{h35)Art!^Y&e@-w>0b_QugVzQaWhzK5a5G!>Hu
zqF<E-9ne2U$>_6?y|$v16oVAk{*@)!r`59WboNb6z$;R}c3GD=@PGpW`fD^xpZEmT
zlKl6FRfN~h-=Bzfq#nCE!5$c@4HrqCcUd+Zh+QxBxm_7f(_vyRQ5z**#(m{dg`x7`
zR4q-XwYfyu%N$SrB*s&r4B{>GbBGYOhqxr7bstw^Lr?j{80)D<2~XObsz0dgWP7Wg
z&U-|?D_cF5Kj|`YF3!!ShgZgig86O3NGtgm>$_+pj-DT<Hkw05n?GBsqR319uoZld
z_q!Fl`1OA26jiuV;HPDN=SeXa?u^RtFIJADCsq$9@%xQH;H4M>8y~qRUUQfKbv!<>
zB<W0T-f;VJX4|BYSVb^@@?|>O<98JzuP!?w6;sc(`egW@kY}|5CbenzcY?x%?xuMC
zg&fdGeK6D*upn4?l7)0Le2ODlk2s_p?r-U@H4N9j5zbTeEf|JJf0k}#FfS#~R}4iv
z{!XvGI%Vv%=B}076ybgJpxFqc+(B&(En;tuNf^46L@lNz8#UPre_?}PT;mh*@A68Y
z@~7)`0h07xF|Lt!E2w)Cmmt5tyVCN7)O$B<w7*;Cew*P|q#Fli@aVQ2y=Pc*wURbb
zyS_U(ucF!Ilr{55Qv-Ro$cP5Fz;nWmDHD44?&hL_$37%%{q=x#p+GG?%{F$ncMaY1
z6`U?6Dt~{Jo=rJn@pYnGX1~wg;0+vLJlAc(U*@LW5xKAT;)|U>yV(r?Jj|`<HhtyB
zDcifv!)+GJ7ges$elMzdT%TajU0QrTyqNv6kkcT?{L<Lok{R;AC)#%B{22OGq{bvq
z#G2HEHY!PeiS_)NGbZ90)nFGWZnr47JT6@|`7M&}5Np7mO?CfX%hW%d>E2fD{4xR8
zYIY%S_VjJrCB-+)OL4^&oY~&Ve~(Oe)PpfV`orK5QLxu0YgEsF*w?P_xxYYU^Ii@^
z!M2yj3#zIk-&@cf{&?2z>OX34>8DO)TP?Sqe-fq`{HkIXv;7lBQDeckwmmmjPwv@M
z$`i6M8P5fWl2=uRpe`XTbABbE54Lxc&qN!KdVjbcEvaZOQpWrYd5Qf(GH1oq(q2xS
zlU&RKo*=VLO{!m(ScH$|^Kb56`ITbX@adC92=kY{v9AWxBoQ292tTg*POlDE9g(st
zUs^*F*9$X>mb}&oE}Lo7_&_EBwt%V#<s?%%-{f1}{_#4E>)4|IzTJjAuDD0C3bDXJ
zE1&EaSmDun-Vn?xYd?5xxce(vP~M5mi*KrM`7WN{x%blG?=KN@@-mk<aVkEY8A@n)
za$GiAEU6)osq{zjDO(0P?Zuo|6~n)d$7434!F9@6C5gr3(i<r<qy6=+bIc>`@1jfq
zVa5Aj^b#;uGw-XKp9^_X!x!(b{&)wipvL}(?`%!FvsgR@pX^J~`8n@5`Zpm=Cu_2<
zfGKNsA;+s?xRfFuJMbGjGb8P;fkwW_kvfOE%Bnh-;acirsRe5q$HdxBW-7)A);xWA
zE`a<>oSa{OgdZ|Jh;=Ksdnh%`Wmdb}&%~GdmS*>N`}hY`n#YuwjUu0&2z!`!*6xK=
z=?=y^g;*;=uFabRdi6aQN}|WUrc-mKhp-2PQT<tJ&0VN-NUMBnrfM|vxbSrRWWVq#
zljSLw0+e{|S#fG3Eu|F<n>NWb+YQracC#LjHo5pyE<SXzhbEr?8t;=s0ZKZeWkNT2
z2esYgnmU0AH>SwKZN07>d)Y*<q{t=n)#dYR4m~aXW7Nmet0QUh1Ea+jOmhaV_nC^%
znvjPzO0LmIvo@#0VJSrE*omvB+rsL8{5jQk=$VSFvumgyah@CC0#ES23)=c$4gV*C
z_J07$#--7P!utR$wMPREi0Ytz_IeL3ZC~(}e?LB0=ih6({^4i2{(Vu_fAt<eyNLff
zh}}}fhnU!;UMa&o@Hw_mqT9v>iI{0Z_y`0?Vf=(<%9R%Yp!VW-VgFSI8<nuf!<5gg
zHN!G@>J2gdAg5s?jII%%A&*7_EQxrKsR;i!2=KBOqIdjz&Qn|+l>c~*=R&n004}wl
zLic?-z2`{pCBPe^!z1FXU1x8gTwv)w(O(;z0Kp$2B||f+3gp91*969CZ}kge;0aWE
zDiB5s6Qu`kU@Qp+?WH&w3g8T-pzWPRtOyO8{O@STj)MR>VqAv)y)Iq50XQBC&_*C5
zjG+$!CnBWwnuzKc%mRotIhr%}0|tn1)RLrt4ZMtj0N?<UNBZN#^$bz7plKt!jh;gl
z91lWo(65EE(gd{%p}9u;3kTFb`r0w*V%cMyzKUC`5!X48^9sFU?1P1=7nZGFnXZ42
zV26>CKBLh^BlXJ0MlNu-2adtP^x2c&o$$Tx&NYTul*A5U-!dlTr(r*ssF}))CJ%FN
z8F3Gk`1r*Ez$*ZIDZ>W|l|B)SZTgJ1Ukj?ZEzfbqZi&c|5FUY;b3dNzyT9?weGRzg
z<%{11Ku2t$Cxl!AI?BaF#hoOP)nE{al9)york;m3;wtLx8|a@0(_%dq$>aB;Yb2u3
zZs|>-0wbVN4~QSu;iOIJ%~jxNIt?Zz5a?fdI8UsAwer7@R<0Dl+;JnKtG&y_LPEsJ
z_)~^J#(onKHY7w#Ic9;Da%&-Kxj1G~B+iiFnN}RvBB0WG1C_U0d=l6jw(g=QtoRAS
zIQsgRz-owjB+x&&wnYrM?)~?^T0gpM<F%X8Z!9D7Rm>3he6YVV2HXg8H3N<kkA-RT
zha<$?9uJkH<`v?3bo%jt;!-MePYuPLJLvipBBc&-j^FCtF+EI9wo@wG?o#6J=}`)p
z?Aa!nG8F6F30j(ilrK?h50b(I!-RR%Qg&_LcK2-|yVuP<#8X8<0KY){H~&UMGGR3}
zJ^^LddGXot0_1;${m!Rx<p%%8Zn!BJr)aZ0e+$-RXc^Q`LB0suro-eqhWoXD7Yn8R
z(AUh)uc}I4E?b|85yO@*wkB2;NjHaA0s$Ai?jmjZmUbCxi6nls`%_WRk6PF<bvP9b
z&@U`mCn^`6)cE`3=HJJ4!IQO;qn-s)K7wa(GcHI2p#WaA?dq9feGBG@x#wpHCx!Fk
z8hCL86^uXwSq6S~OAq0$!6!4j55LB3hk3#F+c-LrWf9_<%|D+RGH5so;THY%5ALE|
z+N9ek3!_e5&6Mu1xjBEcs?mOEE9y+nu_!TeBv&SDeDS4u#7S42PRi1nS@c@rQodN!
zDI>e@_`w6hUz1cZ%KWy&O=>$GvHbmrz!SNN*S1fdFfZ-SLR0eIVMK?Nlym@x-O!E8
z_8Q*-ml#444-}-q7G7P10n5?&Ka4||74(4OTVnpH)aeRG2>=}u!sMv3Ba(OlR1$SX
zyM-dWR{v<<3EIXvUiXQUxTlm%{=uvooM$iJ3Bq8Ha!&}kagCQL=Xmh($O$dC%q5Aa
z$agXn-40Pr$J9x+?<j5WI>e9RhFKNCDj_D#Ff>ZdUp$8U7>9L?@I(RV4j8HmP4-dr
zeg2KrQKv!(Qwp@!!7yhX2fX_-lo0meGQ+iu0q594AM$w>DJ*DQyor?z1Wqi$pIzs;
z(Z2NKtI)iKVUDascZWC^YL#~khd+?A3^hs)ek6I{{QJuex5I*a+`TE^TQL!*66--4
z@9%tpI8~F_`~27cnce<t$G*ZFLRJ&bgB(s%3Xk^9W6ZO@^q&FB{tAnNe5^z?)}aYP
z7LH`=XM$!@U<5g1e)=bu4Nev4-vuDXfb66Qm-br-I~7`Kc0?`_P&|I3Cb6+0RX-Nl
zL*w;IlDCGN_=v#)|Fv(0;1hfSX7CqlDd4s7rX^aO!&&MMcj2x;DqgEt-wp$t-W_6E
zcY?NP{O-oN5T}4!6pTk>FE?Xm(JL)JjK%4BNwOV<S9k2Y`$jz=m`mXqeMliTmYu{-
z=W#TRTqCX(mKb+y(b<LL2obph^XQ4X^DM-FB~Htj7!eGekn*#{O2W*8sS8FVicISu
znb`%r{72@&!yKP&eedv&FQI&P<o%7O6Lbvb{(8a6?07~W5gRsTD;S$mWq?u6qGu(1
zcR>vH<NLZk)JnP%$XIGqcvb!vL#%hu`O9~B1`BAG_8d*?pX|94$YjtZW%Q>h?tFkU
zTUpS(|EwHRC*K0n6q_ifX@K4qL-;8;y9J?F{eY(*CMWbJJ?r(6$|*lG=C_6CNjb;Q
z9p_-QB$F_2;FWna+`4VzZDCn3>n-cDi}JqI<5$Tfu8~O`^jfd0zCspH(GAJWZy49~
zLNsoOyGpnyL+=0HbIl{>(e-7#*ghZoap9|?%(xZ~wBIEweJ8MK({B8R9dr*CXU;Uf
zkfZa-AY~D@q7N#;yDYhC%5{X%f=nWmpX~{mks^kFH#a@SV6W>v%>N09*}80f*Wqy<
zIYBS9OD2FH1)~PV4q7kC)!Qpe0qT~ZEopI%^Vza3&qmgftGwEtJO8q7BF#SeR<hE)
ztuiKZ(-*IJE>SE_^F2A3a%t1uyT3<uyH6%4N&kBL59c`f!7FEF{;P^nG48oAKPnnG
z)ia>1mCp!5hsHZ_J4`zzMlJ5%y*g)w++b99GCoM6sE#b+DL8%BD@}KLp>D9z`#o>s
zmF9>8*L!7~K9md`-7iM(vBp#pHdT0lR_YbmGnI(|dzydu7@jN-riZjAtZK8I_>2>9
zN1S~8|7&{bbY2X5$6xA?W}6#RkXrjg`;gZ-!~Tu-<e=9$rNTW@vgg+>8g)EQH|YYI
zz#-}`nZc67ql>-wck2=F;l{Q(hBQ4b?f&^&MrSWx{bw(yu|L<}*2aOe7?Se*&kFI{
y|F@y)|NM~uLz%gL3yJ^t|E@ay|L@0o*S40$O5E!b+(Cl>yLe9VY>L#?yZ;OINy|<E

literal 0
HcmV?d00001


From 0a23adeb2cc29871acf9c76a07a0b459394a5f58 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Thu, 18 Aug 2022 15:37:56 +0200
Subject: [PATCH 18/20] Update README.md

---
 README.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 55 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 4db5e77..81ad998 100644
--- a/README.md
+++ b/README.md
@@ -23,7 +23,8 @@ The library provides functions for plotting projected lines, curves (trajectorie
 <img src="/readme_images/rgba_example.png" width="150" height="150"/>
 <img src="/readme_images/various_lines.png" width="150" height="150"/>
 <img src="/readme_images/colored_trajectory.png" width="150" height="150"/>
-<img src="/readme_images/scatter.png" width="150" height="150"/><br/>
+<img src="/readme_images/scatter.png" width="150" height="150"/>
+<img src="/readme_images/truncation_all_corners.png" width="200" height="150"/><br/>
 <br/>
 <img src="/readme_images/btweinstein_example2.png" width="300" height="150"/>
 <img src="/readme_images/btweinstein_example.png" width="300" height="150"/>
@@ -394,6 +395,58 @@ do so automatically when you pass `clockwise=True` to `tax.ticks()`.
 There is a [more detailed discussion](https://github.com/marcharper/python-ternary/issues/18)
 on issue #18 (closed).
 
+# Custom Axis Data Limits
+
+By default, the axes limits are [0, scale] i.e. simplex coordinates but it is possible to set 
+custom data limits to the axes instead. This is done by passing a dict into set_axis_limits.
+The keys are b, l and r for the three axes and the values are a list of the min and max in 
+data coords for that axis. max-min for each axis is the same as the scale i.e. 9 in this case.
+
+```python
+tax.set_axis_limits({'b': [60, 75], 'l': [15, 30], 'r': [10, 25]})
+```
+
+This can be used to zoom in on a particular region, for example. Please see
+the [custom axis scaling example](examples/custom_axis_scaling.py) for further
+details.
+
+<p align="center">
+<img src="/readme_images/zoom_example.png" width="732" height="400"/>
+</p>
+
+# Truncated Simplex
+
+One or more corners can be removed from the simplex by setting a truncation. 
+This may be useful for saving whitespace if the data are grouped in one area
+of the plot. A truncation is specified in data coordinates by passing a dict
+into tax.set_truncation. The keys are two letters specifying the start and end
+axes of the truncation line and the values give the maximum of the first axis
+specified in data coordinates. For the example on the left below, we write:
+
+```python
+tax.set_truncation({'rl' : 8})
+```
+
+The result is that the truncation line has been drawn from the right axis at
+data coordinate 8 to the left axis, cutting off the top corner. As the figure is no 
+longer a triangle, we need to get and set custom axis ticks and tick labels. 
+There are convenience functions for this in the case of a truncation and/or 
+custom axis data limits. Again for the left image shown below:
+
+```python
+tax.get_ticks_from_axis_limits(multiple=2)
+offset=0.013
+tax.set_custom_ticks(fontsize=8, offset=offset,
+                     tick_formats="%.1f", linewidth=0.25)
+```
+
+<p align="center">
+<img src="/readme_images/truncation_top_corner.png" width="533" height="400"/>
+<img src="/readme_images/truncation_all_corners.png" width="314" height="236"/>
+</p>
+
+Please see the [truncated simplex example](examples/truncated_simplex_example.py) 
+for further details.
 
 # RGBA colors
 
@@ -463,6 +516,7 @@ contribute.
 - Bryan Weinstein [btweinstein](https://github.com/btweinstein): Hexagonal heatmaps, colored trajectory plots
 - [chebee7i](https://github.com/chebee7i): Docs and figures, triangular heatmapping
 - [Cory Simon](https://github.com/CorySimon): Axis Colors, colored heatmap example
+- [tgwoodcock](https://github.com/tgwoodcock): Custom axis data limits, truncated simplex
 
 # Known-Issues
 

From 5a0c6ad3b9764b81e07c5c81447eb7468984d5e6 Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Thu, 18 Aug 2022 15:41:46 +0200
Subject: [PATCH 19/20] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 81ad998..3de6c7d 100644
--- a/README.md
+++ b/README.md
@@ -441,7 +441,7 @@ tax.set_custom_ticks(fontsize=8, offset=offset,
 ```
 
 <p align="center">
-<img src="/readme_images/truncation_top_corner.png" width="533" height="400"/>
+<img src="/readme_images/truncation_top_corner.png" width="400" height="300"/>
 <img src="/readme_images/truncation_all_corners.png" width="314" height="236"/>
 </p>
 

From cdc10e9e2f54493d9e87e635a8211af41e29fb5c Mon Sep 17 00:00:00 2001
From: tgwoodcock <tgwoodcock@users.noreply.github.com>
Date: Tue, 6 Sep 2022 09:10:27 +0200
Subject: [PATCH 20/20] Minor fix to colormapping.colorbar_hack

Replaced sm._A = [] with sm.set_array(None) as the former was causing an
error with plt.cm.ScalarMappable
---
 ternary/colormapping.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ternary/colormapping.py b/ternary/colormapping.py
index c264463..6c1fe6f 100644
--- a/ternary/colormapping.py
+++ b/ternary/colormapping.py
@@ -91,7 +91,7 @@ def colorbar_hack(ax, vmin, vmax, cmap, scientific=False, cbarlabel=None, norm=N
     if norm is None:
         norm = plt.Normalize(vmin=vmin, vmax=vmax)
     sm = plt.cm.ScalarMappable(cmap=cmap, norm=norm)
-    sm._A = []
+    sm.set_array(None)
     cb = plt.colorbar(sm, ax=ax, **kwargs)
     if cbarlabel is not None:
         cb.set_label(cbarlabel)