doco

Author: alimanfoo

README.rst

@@ -44,7 +44,7 @@ Fill it with some data::
     zarr.ext.Array((10000, 1000), int32, chunks=(1000, 100), cname='blosclz', clevel=5, shuffle=1)
       nbytes: 38.1M; cbytes: 2.0M; ratio: 19.3
 
-Obtain a NumPy array::
+Obtain a NumPy array by slicing::
 
     >>> z[:]
     array([[      0,       1,       2, ...,     997,     998,     999],
@@ -54,6 +54,22 @@ Obtain a NumPy array::
            [9997000, 9997001, 9997002, ..., 9997997, 9997998, 9997999],
            [9998000, 9998001, 9998002, ..., 9998997, 9998998, 9998999],
            [9999000, 9999001, 9999002, ..., 9999997, 9999998, 9999999]], dtype=int32)
+    >>> z[:100]
+    array([[    0,     1,     2, ...,   997,   998,   999],
+           [ 1000,  1001,  1002, ...,  1997,  1998,  1999],
+           [ 2000,  2001,  2002, ...,  2997,  2998,  2999],
+           ...,
+           [97000, 97001, 97002, ..., 97997, 97998, 97999],
+           [98000, 98001, 98002, ..., 98997, 98998, 98999],
+           [99000, 99001, 99002, ..., 99997, 99998, 99999]], dtype=int32)
+    >>> z[:, :100]
+    array([[      0,       1,       2, ...,      97,      98,      99],
+           [   1000,    1001,    1002, ...,    1097,    1098,    1099],
+           [   2000,    2001,    2002, ...,    2097,    2098,    2099],
+           ...,
+           [9997000, 9997001, 9997002, ..., 9997097, 9997098, 9997099],
+           [9998000, 9998001, 9998002, ..., 9998097, 9998098, 9998099],
+           [9999000, 9999001, 9999002, ..., 9999097, 9999098, 9999099]], dtype=int32)
 
 Resize the array and add more data::
 
@@ -67,7 +83,7 @@ Resize the array and add more data::
       nbytes: 76.3M; cbytes: 4.0M; ratio: 19.3
 
 For convenience, an `append` method is also available, which can be used to
-append data to any axis:
+append data to any axis::
 
     >>> a = np.arange(10000000, dtype='i4').reshape(10000, 1000)
     >>> z = zarr.array(a, chunks=(1000, 100))