Add change log for version 0.21

Author: alixdamman

doc/source/changes/version_0_21.rst.inc

@@ -0,0 +1,116 @@
+New features
+------------
+
+* implemented set_axes() method to replace one, several or all axes of an array (closes :issue:`67`).
+  The method with_axes() is now deprecated (set_axes() must be used instead).
+
+    >>> arr = ndtest((2, 3))
+    >>> arr
+    a\\b | b0 | b1 | b2
+     a0 |  0 |  1 |  2
+     a1 |  3 |  4 |  5
+    >>> row = Axis('row', ['r0', 'r1'])
+    >>> column = Axis('column', ['c0', 'c1', 'c2'])
+    Replace one axis (second argument `new_axis` must be provided)
+    >>> arr.set_axes(x.a, row)
+    row\\b | b0 | b1 | b2
+       r0 |  0 |  1 |  2
+       r1 |  3 |  4 |  5
+    Replace several axes (keywords, list of tuple or dictionary)
+    >>> arr.set_axes(a=row, b=column)
+    row\\column | c0 | c1 | c2
+            r0 |  0 |  1 |  2
+            r1 |  3 |  4 |  5
+    >>> arr.set_axes([(x.a, row), (x.b, column)])
+    row\\column | c0 | c1 | c2
+            r0 |  0 |  1 |  2
+            r1 |  3 |  4 |  5
+    >>> arr.set_axes({x.a: row, x.b: column})
+    row\\column | c0 | c1 | c2
+            r0 |  0 |  1 |  2
+            r1 |  3 |  4 |  5
+    Replace all axes (list of axes or AxisCollection)
+    >>> arr.set_axes([row, column])
+    row\\column | c0 | c1 | c2
+            r0 |  0 |  1 |  2
+            r1 |  3 |  4 |  5
+    >>> arr2 = ndrange([row, column])
+    >>> arr.set_axes(arr2.axes)
+    row\\column | c0 | c1 | c2
+            r0 |  0 |  1 |  2
+            r1 |  3 |  4 |  5
+
+* implemented from_string() method to create an array from a string:
+
+    >>> from_string('''age,nat\\sex, M, F
+    ...                0,  BE,       0, 1
+    ...                0,  FO,       2, 3
+    ...                1,  BE,       4, 5
+    ...                1,  FO,       6, 7''')
+    age | nat\sex | M | F
+      0 |      BE | 0 | 1
+      0 |      FO | 2 | 3
+      1 |      BE | 4 | 5
+      1 |      FO | 6 | 7
+
+* allowed to use a regular expression in split_axis method (closes :issue:`106`):
+
+    >>> combined = ndrange('a_b = a0b0..a1b2')
+    >>> combined
+        a_b | a0b0 | a0b1 | a0b2 | a1b0 | a1b1 | a1b2
+            |    0 |    1 |    2 |    3 |    4 |    5
+    >>> combined.split_axis(x.a_b, regex='(\w{2})(\w{2})')
+        a\\b | b0 | b1 | b2
+         a0 |  0 |  1 |  2
+         a1 |  3 |  4 |
+
+* implemented Axis.by() which is equivalent to axis[:].by()
+
+    >>> Axis('age', range(10)).by(3, 4)
+    (age.i[0:3], age.i[4:7], age.i[8:10])
+
+Miscellaneous improvements
+--------------------------
+
+* added installation instructions (closes :issue:`101`).
+
+* viewer : make shortcuts work even when the focus is not on the array editor widget
+  (ie it is on the array list, or on the interactive console) (closes :issue:`102`).
+
+* allowed matrix multiplication (@ operator) between arrays with dimension != 2 (closes :issue:`122`).
+
+* viewer : automatically display plots done in the viewer console in a separate window
+  (unless "%matplotlib inline" is used). Plots can be done via the array widget
+  (using shortcut CTRL+P or right click) or from the console:
+
+    >>> arr = ndtest((3, 3))
+    >>> arr.plot()
+
+  Now both methods generate a plot in separate window.
+
+* improved LArray.plot to get nicer plots by default.
+  The axes are transposed compared to what they used to, because the last axis is often used for time series.
+  Also it considers a 1D array like a single series, not N series of 1 point.
+
+* added possibility to tag multiple groups with an axis in one shot (backward incompatible)
+
+    >>> year  = Axis('year', '2001 .. 2010')
+    >>> year.group('2001,2002;2003:2008;2009,2010')
+    [[2001, 2002], slice(2003, 2008, None), [2009, 2010]]
+
+Fixes
+-----
+
+* viewer: allow changing the number of displayed digits even for integer arrays as that makes sense when using
+  scientific notation (closes :issue:`100`).
+
+* viewer : fixed opening a viewer via view() edit() or compare() from within the viewer
+  (closes :issue:`109`)
+
+* viewer : fixed compare() colors when arrays have values which are very close but not exactly equal
+  (closes :issue:`123`)
+
+* viewer : fixed legend when plotting arbitrary rows (it always displayed the labels of the first rows)
+  (closes :issue:`136`).
+
+* fixed posargsort labels (closes :issue:`137`).

larray/core.py

@@ -3947,7 +3947,7 @@ def replace_axes(self, axes_to_replace=None, new_axis=None, **kwargs):
                   list of tuple (axis ref, axis) or list of Axis or
                   AxisCollection
             Axes to replace. If a single axis reference is given,
-            the `new_axes` argument must be used. If a list of
+            the `new_axis` argument must be used. If a list of
             Axis or an AxisCollection is given, all axes will be
             replaced by the new ones. In that case, the number of
             new axes must match the number of the old ones.
@@ -3976,14 +3976,16 @@ def replace_axes(self, axes_to_replace=None, new_axis=None, **kwargs):
          a1 |  3 |  4 |  5
         >>> row = Axis('row', ['r0', 'r1'])
         >>> column = Axis('column', ['c0', 'c1', 'c2'])
+
+        Replace one axis (expect 2 arguments)
+
         >>> arr.replace_axes(x.a, row)
         row\\b | b0 | b1 | b2
            r0 |  0 |  1 |  2
            r1 |  3 |  4 |  5
-        >>> arr.replace_axes([row, column])
-        row\\column | c0 | c1 | c2
-                r0 |  0 |  1 |  2
-                r1 |  3 |  4 |  5
+
+        Replace several axes (keywords, list of tuple or dictionary)
+
         >>> arr.replace_axes(a=row, b=column)
         row\\column | c0 | c1 | c2
                 r0 |  0 |  1 |  2
@@ -3993,6 +3995,13 @@ def replace_axes(self, axes_to_replace=None, new_axis=None, **kwargs):
                 r0 |  0 |  1 |  2
                 r1 |  3 |  4 |  5
         >>> arr.replace_axes({x.a: row, x.b: column})
+        row\\column | c0 | c1 | c2
+                r0 |  0 |  1 |  2
+                r1 |  3 |  4 |  5
+
+        Replace all axes (list of axes or AxisCollection)
+
+        >>> arr.replace_axes([row, column])
         row\\column | c0 | c1 | c2
                 r0 |  0 |  1 |  2
                 r1 |  3 |  4 |  5