GDALDataset-class           package:rgdal           R Documentation

_C_l_a_s_s "_G_D_A_L_D_a_t_a_s_e_t"

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

     'GDALDataset' extends 'GDALReadOnlyDataset-class' with data update
     commands.

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

     putRasterData(dataset, rasterData, band = 1, offset = c(0, 0))
     saveDataset(dataset, filename, options=NULL, returnNewObj=FALSE)
     copyDataset(dataset, driver, strict = FALSE, options = NULL)
     deleteDataset(dataset)
     saveDatasetAs(dataset, filename, driver = NULL, options=NULL)

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

 dataset: An object inheriting from class 'GDALDataset'

rasterData: A data array with 'length(dim(rasterData)) = 2'

    band: The band number (1-based) to read from

  offset: Number of rows and columns from the origin (usually the upper
          left corner) to begin reading from

filename: name of file to contain raster data object

returnNewObj: until and including 0.5-27, 'saveDataset' returned an
          invisible copy of the new file handle, which was then only
          finalized when the garbage collector ran. The old behaviour
          can be retained by setting to FALSE, the default behaviour is
          to close the hande and not return it.

  driver: GDAL driver name to use for saving raster data object

  strict: TRUE if the copy must be strictly equivalent, or more
          normally FALSE indicating that the copy may adapt as needed
          for the output format

 options: Driver specific options (currently passed to GDAL)

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



     '_p_u_t_R_a_s_t_e_r_D_a_t_a': writes data contained in 'rasterData' to the
          dataset, begining at 'offset' rows and columns from the
          origin (usually the upper left corner). Data type conversion
          is automatic.

     '_s_a_v_e_D_a_t_a_s_e_t': saves a raster data object in a file using the
          driver of the object

     '_s_a_v_e_D_a_t_a_s_e_t_A_s': saves a raster data object in a file using the
          specified driver

     '_c_o_p_y_D_a_t_a_s_e_t': make a copy of raster data object in a file using
          the specified driver

     '_d_e_l_e_t_e_D_a_t_a_s_e_t': delete the file from which the raster data object
          was read (should only delete files opened as GDALDataset
          objects

_O_b_j_e_c_t_s _f_r_o_m _t_h_e _C_l_a_s_s:

     Objects can be created by calls of the form 'new("GDALDataset",
     filename, handle)', where name: a string giving the name of a GDAL
     driver, handle: used internally; not for public consumption
     (default = NULL).

_S_l_o_t_s:


     '_h_a_n_d_l_e': Object of class '"externalptr", from class
          "GDALReadOnlyDataset"', used internally; not for public
          consumption

_E_x_t_e_n_d_s:

     Class '"GDALReadOnlyDataset"', directly. Class
     '"GDALMajorObject"', by class "GDALReadOnlyDataset".

_M_e_t_h_o_d_s:


     _i_n_i_t_i_a_l_i_z_e 'signature(.Object = "GDALDataset")': ... 

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

     Timothy H. Keitt, modified by Roger Bivand

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

     'GDALDriver-class', 'GDALReadOnlyDataset-class',
     'GDALTransientDataset-class'

