1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/R6Classes_H5A.R
\docType{class}
\name{H5A-class}
\alias{H5A-class}
\alias{H5A}
\title{Class for representing HDF5 attributes}
\value{
Object of class \code{\link{H5A}}.
}
\description{
This class represents an HDF5 attribute. Usually it is easier to read and write attributes for
groups, datasets and committed datatypes using the functions documented in \code{\link{h5attributes}}.
}
\details{
Otherwise, the functionality for attributes is very similar to that of datasets (\code{\link{H5D}}),
however with the notable exception that attributes always have to be read and written as a whole.
}
\section{Methods}{
\describe{
\item{\code{get_info()}}{
This function implements the HDF5-API function H5Aget_info.
Please see the documentation at \url{https://portal.hdfgroup.org/display/HDF5/H5A_GET_INFO} for details.}
\item{\code{attr_name()}}{
This function implements the HDF5-API function H5Aget_name.
Please see the documentation at \url{https://portal.hdfgroup.org/display/HDF5/H5A_GET_NAME} for details.}
\item{\code{get_space()}}{
This function implements the HDF5-API function H5Aget_space.
Please see the documentation at \url{https://portal.hdfgroup.org/display/HDF5/H5A_GET_SPACE} for details.}
\item{\code{get_type(native = TRUE)}}{
This function implements the HDF5-API function H5Aget_type.
Please see the documentation at \url{https://portal.hdfgroup.org/display/HDF5/H5A_GET_TYPE} for details.}
\item{\code{get_storage_size()}}{
This function implements the HDF5-API function H5Aget_storage_size.
Please see the documentation at \url{https://portal.hdfgroup.org/display/HDF5/H5A_GET_STORAGE_SIZE} for details.}
\item{\code{read_low_level(buffer, mem_type, duplicate_buffer = FALSE)}}{
Only for advanced users. See documentation for \code{read} instead.
This function implements the HDF5-API function H5Aread.
Please see the documentation at \url{https://portal.hdfgroup.org/display/HDF5/H5A_READ} for details.}
\item{\code{read(flags = getOption("hdf5r.h5tor_default"), drop = TRUE)}}{
Reads the data of the attribute and returns it as an R-object
\strong{Parameters}
\describe{
\item{flags}{Conversion rules for integer values. See also \code{\link{h5const}}}
\item{drop}{Logical. Should dimensions of length 1 be dropped (R-default for arrays)}
}}
\item{\code{write_low_level(buffer, mem_type)}}{
Only for advanced users. See documentation for \code{write} instead.
This function implements the HDF5-API function H5Awrite.
Please see the documentation at \url{https://portal.hdfgroup.org/display/HDF5/H5A_WRITE} for details.}
\item{\code{write(robj, mem_type = NULL,
flush = getOption("hdf5r.flush_on_write"))}}{
Writes the data of \code{robj} to the attribute
\strong{Parameters}
\describe{
\item{robj}{The object to write into the attribute}
\item{mem_type}{The memory data type to use when transferring from HDF5 to intermediate storage. This is an
advanced development feature and may be removed in the future.}
}}
\item{\code{print(...)}}{
Prints information for the dataset
\strong{Parameters}
\describe{
\item{...}{ignored}
}}
\item{\code{flush(scope = h5const$H5F_SCOPE_GLOBAL)}}{
This function implements the HDF5-API function H5Fflush.
Please see the documentation at \url{https://portal.hdfgroup.org/display/HDF5/H5F_FLUSH} for details.}
\item{\code{get_filename()}}{
This function implements the HDF5-API function H5Fget_name.
Please see the documentation at \url{https://portal.hdfgroup.org/display/HDF5/H5F_GET_NAME} for details.}
}}
\examples{
fname <- tempfile(fileext = ".h5")
file <- H5File$new(fname, mode = "a")
h5attr(file, "attr_numeric") <- rnorm(10)
a <- file$attr_open("attr_numeric")
a$get_info()
a$attr_name()
a$get_space()
a$get_type()
a$get_storage_size()
a$read()
a$write(10:1)
a$print()
a$close()
file$close_all()
}
\author{
Holger Hoefling
}
|
