

hdf5 {base}                                  R Documentation

_I_n_t_e_r_f_a_c_e _t_o _t_h_e _H_D_F_5 _L_i_b_r_a_r_y

_D_e_s_c_r_i_p_t_i_o_n_:

     `hdf5save' and `hd5fload' provide an experimental
     interface to version 5 of the NCSA HDF library.

_U_s_a_g_e_:

     hdf5save(file, ...)

     hdf5load(file, load = TRUE)

_A_r_g_u_m_e_n_t_s_:

    file: the name of the file in which the objects will be
          stored.

     ...: the names of the objects to be saved.

    load: a logical value.  If `FALSE', a character vector
          containing the names of the objects in the file is
          returned.  If `TRUE' (the default), the objects
          are returned as the components of a named list.

_D_e_t_a_i_l_s_:

     `hdf5save' writes a representation of R objects to the
     specified file in a form which can be read by software
     which understands the HDF5 format.  The objects can be
     read back from the file at a later date by using the
     function `hdf5load'.

     Not all R types are supported and it probably doesn't
     make sense to put some of them into an HDF file (e.g.
     closures).  However, lists, strings, vectors, and
     matrices work.  Lists map to HDF groups.  Vectors and
     matrices map to datasets.

     This capability is only available on machines which
     have the HDF5 library, version 1.2 or higher (freely
     available from the reference below).

_A_u_t_h_o_r_(_s_)_:

     Marcus G. Daniels mgd@santafe.edu.

_R_e_f_e_r_e_n_c_e_s_:

     <URL: http://hdf.ncsa.uiuc.edu>

_S_e_e _A_l_s_o_:

     `save', `load'.

_E_x_a_m_p_l_e_s_:

     (m <- cbind(A = 1, diag(4)))
     ll <- list(a=1:10, b=letters[1:8]);
     l2 <- list(C="c", l=ll); PP <- pi
     hdf5save("ex1.hdf", m, PP, ll, l2)
     rm(m,PP,ll,l2)  # and reload them:
     hdf5load("ex1.hdf")
     m        # read from "ex1.hdf"; buglet: dimnames dropped
     str(ll)  # buglet: "pairlist" instead of "list"
     str(l2)

