Support partial reading of Zarr datasets

[krisfed]

This is a first draft of allowing partial reads from Zarr datasets.

The proposed interface is as follows (somewhat modeled on h5read and ncread):

>> fullData = zarrread("grp_v2/smallArr") % reading full dataset works the same

fullData =

     1     4     7    10
     2     5     8    11
     3     6     9    12

>> d = zarrread("grp_v2/smallArr", Start=[2,3]) % read starting from the 2nd row and 3rd column

d =

     8    11
     9    12

>> d = zarrread("grp_v2/smallArr", Count=[2,4]) % read 2 elements in 1st dimension and 4 in 2nd dimension

d =

     1     4     7    10
     2     5     8    11

>> d = zarrread("grp_v2/smallArr", Stride=[1,2]) % read every element in 1st dimension and every second one in 2nd dimension

d =

     1     7
     2     8
     3     9

>> d = zarrread("grp_v2/smallArr", Start=[1,2], Stride=[1,2], Count=[2,2]) % use any combination of Start/Stride/Count

d =

     4    10
     5    11

The number of elements in Start/Stride/Count must be the same as the number of dimensions:

>> d = zarrread("grp_v2/smallArr", Start=[1,2,3])
Error using Zarr.processPartialReadParams (line 86)
Number of elements in Start must be the same as the number of Zarr array dimensions.

Error in Zarr/read (line 260)
            start = Zarr.processPartialReadParams(start, info.shape,...
                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Error in zarrread (line 36)
data = zarrObj.read(options.Start, options.Count, options.Stride);
       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Only exception is if the dataset is a vector, in which case scalar Start/Stride/Count are allowed:

>> d = zarrread("grp_v2/vectorData")

d =

     1     2     3     4     5     6     7     8     9    10

>> d = zarrread("grp_v2/vectorData", Start=3, Stride=2)

d =

     3     5     7     9

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 97.07%. Comparing base (1ad7173) to head (7889203).
Report is 8 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #106      +/-   ##
==========================================
+ Coverage   96.66%   97.07%   +0.40%     
==========================================
  Files           8        8              
  Lines         210      239      +29     
==========================================
+ Hits          203      232      +29     
  Misses          7        7              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[jm9176]

@krisfed Please create a test task geck once you are done submitting all of your changes.

[jhughes-mw]

Surprised considering the name of the function, you didn't also use arguments block to validate inputs

[krisfed]

Yeah I am doing the basic arguments block validation for Start/Stride/Count in zarrread (better error message and faster erroring out), so not much left to validate here. Not great to validate different things in different places though..

[jhughes-mw]

Looks Good.