Wrapper for class LazyH5
, which load data with
"lazy" mode - only read part of dataset when needed.
Arguments
- file
'HDF5' file
- name
group/data_name
path to dataset (H5D
data)- read_only
only used if
ram=FALSE
, whether the returnedLazyH5
instance should be read only- ram
load data to memory immediately, default is false
- quiet
whether to suppress messages
Value
If ram
is true, then return data as arrays, otherwise return
a LazyH5
instance.
Examples
file <- tempfile()
x <- array(1:120, dim = c(4,5,6))
# save x to file with name /group/dataset/1
io_write_h5(x, file, '/group/dataset/1', quiet = TRUE)
# read data
y <- io_read_h5(file, '/group/dataset/1', ram = TRUE)
class(y) # array
#> [1] "array"
z <- io_read_h5(file, '/group/dataset/1', ram = FALSE)
class(z) # LazyH5
#> [1] "LazyH5" "R6"
dim(z)
#> [1] 4 5 6
# clean up
unlink(file)