The chunk plan for a subscript, as a data frame

One row per chunk that x[i, j, k] would touch: 0-based chunk coordinates, plus each chunk's 1-based start and its extent along every dimension. The plan is a table; the array is what assembling it gives.

Usage

altarr_plan(x, ...)

Arguments

x

an altarr array

...

one subscript per dimension (missing means all)

Value

a data frame, one row per chunk.

Examples

x <- altarr_zarr_v2(altarr_example_zarr())
altarr_plan(x, 1:40, 1:20, 1:3)
#>   d1 d2 d3 d1_start d1_n d2_start d2_n d3_start d3_n
#> 1  0  0  0        1   20        1   16        1    7
#> 2  1  0  0       21   20        1   16        1    7
#> 3  0  1  0        1   20       17   16        1    7
#> 4  1  1  0       21   20       17   16        1    7
altarr_plan(x, 70, , 1)   # a missing subscript means the whole dimension
#>   d1 d2 d3 d1_start d1_n d2_start d2_n d3_start d3_n
#> 1  3  0  0       61   10        1   16        1    7
#> 2  3  1  0       61   10       17   16        1    7
#> 3  3  2  0       61   10       33   16        1    7
#> 4  3  3  0       61   10       49    2        1    7