tools (version 3.3)

checkRdaFiles: Report on Details of Saved Images or Re-saves them

Description

This reports for each of the files produced by save the size, if it was saved in ASCII or XDR binary format, and if it was compressed (and if so in what format).

Usually such files have extension .rda or .RData, hence the name of the function.

Usage

checkRdaFiles(paths)
resaveRdaFiles(paths, compress = c("auto", "gzip", "bzip2", "xz"),
               compression_level)

Arguments

paths
A character vector of paths to save files. If this specifies a single directory, it is taken to refer to all .rda and .RData files in that directory.
compress, compression_level
type and level of compression: see save. Values of compress can be abbreviated.

Value

  • For checkRdaFiles, a data frame with rows names paths and columns
  • sizenumeric: file size in bytes, NA if the file does not exist.
  • ASCIIlogical: true for save(ASCII = TRUE), NA if the format is not that of an Rsave file.
  • compresscharacter: type of compression. One of "gzip", "bzip2", "xz", "none" or "unknown" (which means that if this is an Rsave file it is from a later version of R).
  • versioninteger: the version of the save -- usually 2 but 1 for very old files, and NA for other files.

Details

compress = "auto" asks Rto choose the compression and ignores compression_level. It will try "gzip", "bzip2" and if the "gzip" compressed size is over 10Kb, "xz" and choose the smallest compressed file (but with a 10% bias towards "gzip"). This can be slow.

Examples

Run this code
## from a package top-level source directory
paths <- sort(Sys.glob(c("data/*.rda", "data/*.RData")))
(res <- checkRdaFiles(paths))
## pick out some that may need attention
bad <- is.na(res$ASCII) | res$ASCII | (res$size > 1e4 & res$compress == "none")
res[bad, ]

Run the code above in your browser using DataCamp Workspace