Provides an estimate of the memory that is being used to store R objects.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
object.size(...) ## S3 method for class 'object_sizes' is(x) ## S3 method for class 'object_sizes' as(x) ## S3 method for class 'object_sizes' c(..., recursive=FALSE) ## S3 method for class 'object_sizes' format(x, humanReadable=getOption("humanReadable"), standard="IEC", units, digits=1, width=NULL, sep=" ", justify = c("right", "left"), ...) ## S3 method for class 'object_sizes' print(x, quote=FALSE, humanReadable=getOption("humanReadable"), standard="IEC", units, digits=1, width=NULL, sep=" ", justify = c("right", "left"), ...)
logical, indicating whether or not the result should be printed with surrounding quotes.
logical, use the “human readable” format.
See the man page for
See the man page for
This is a modified copy of the man page for utils::object.size in R 2.2.1.
Exactly which parts of the memory allocation should be attributed to which object is not clear-cut. This function merely provides a rough indication: it should be reasonably accurate for atomic vectors, but does not detect if elements of a list are shared, for example. (Sharing amongst elements of a character vector is taken into account, but not that between character vectors in a single object.)
The calculation is of the size of the object, and excludes the space needed to store its name in the symbol table.
Associated space (e.g., the environment of a function and what the
pointer in a
EXTPTRSXP points to) is not included in the
Object sizes are larger on 64-bit builds than 32-bit ones, but will very likely be the same on different platforms with the same word length and pointer size.
Class of returned object is
c("object_sizes", "numeric") with
object.size outputs size in bytes, but human
readable format similar to
commands can be displayed by calling
A numeric vector class
c("object_sizes", "numeric") containing
estimated memory allocation attributable to the objects in bytes.
object.size in package 'utils' for the standard
version of this function,
Memory-limits for the design limitations on object size,
humanReadable for human readable format.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26
object.size(letters) object.size(ls) ## find the 10 largest objects in the base package allObj <- sapply(ls("package:base"), function(x) object.size(get(x, envir = baseenv())) ) ( bigObj <- as.object_sizes(rev(sort(allObj))[1:10] ) ) print(bigObj, humanReadable=TRUE) as.object_sizes(14567567) options(humanReadable=TRUE) ( z <- object.size(letters, c(letters, letters), rep(letters, 100), rep(letters, 10000) ) ) is.object_sizes(z) as.object_sizes(14567567)