deepcopy              package:bigmemory              R Documentation

_P_r_o_d_u_c_e_s _a _p_h_y_s_i_c_a_l _c_o_p_y _o_f _a "_b_i_g._m_a_t_r_i_x"

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

     This is needed to make a duplicate of a 'big.matrix'; currently,
     it creates a non-shared 'big.matrix' regardless of the nature of
     the argument, and this will be changed to support additional
     options.

_U_s_a_g_e:

     deepcopy(x, cols = NULL, type = NULL, separated = NULL, shared = NULL,
              backingfile = NULL, backingpath = NULL, descriptorfile = NULL,
              preserve = TRUE)

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

       x: a 'big.matrix'.

    cols: possible subset of columns for the deepcopy, could be
          numeric, named, or logical.

    type: preferably specified, '"integer"' for example.

separated: use separated column organization of the data instead of
          column-major organization.

  shared: if 'TRUE', load the object into shared memory.

backingfile: the root name for the file(s) for the cache of 'x'.

backingpath: the path to the directory containing the file backing
          cache.

descriptorfile: we recommend specifying this for filebacking.

preserve: if this is a filebacked 'big.matrix', it is preserved, by
          default, even after the end of the R session unless this
          option is set to 'FALSE'.

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

     This is needed to make a duplicate of a 'big.matrix', because
     traditional R syntax would only copy the R object (the pointer to
     the 'big.matrix' rather than the 'big.matrix' itself).

     It can also make a copy of only a subset of columns.

_V_a_l_u_e:

     a 'big.matrix'.

_A_u_t_h_o_r(_s):

     John W. Emerson and Michael J. Kane

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

     'big.matrix'

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

     x <- as.big.matrix(matrix(1:30, 10, 3))
     y <- deepcopy(x, -1)    # Don't include the first column.
     x
     y
     head(x)
     head(y)

