hdf5                  package:hdf5                  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 the
     NCSA HDF5 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@swarm.org.

_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)

