storeCache: Stores as a cache an already-produced R object

In simpleCache: Simply Caching R Objects

Description

Sometimes you use significant computational power to create an object, but you didn't cache it with simpleCache. Oops, maybe you wish you had, after the fact. This function lets you store an object in the environment so it could be loaded by future calls to simpleCache.

Usage

storeCache(
  cacheName,
  cacheDir = getCacheDir(),
  cacheSubDir = NULL,
  recreate = FALSE
)

Arguments

cacheName	Unique name for the cache (and R object to be cached).
cacheDir	The directory where caches are saved (and loaded from). Defaults to the global RCACHE.DIR variable
cacheSubDir	You can specify a subdirectory within the cacheDir variable. Defaults to NULL.
recreate	Forces reconstruction of the cache

Details

This can be used in interactive sessions, but could also be used for another use case: you have a complicated set of instructions (too much to pass as the instruction argument to simpleCache), so you could just stick a call to storeCache at the end.

Examples

# choose location to store caches
cacheDir = tempdir()
cacheDir
setCacheDir(cacheDir)

# build some caches
simpleCache("normSample", { rnorm(5e3, 0,1) }, recreate=TRUE, timer=TRUE)
simpleCache("normSample", { rnorm(5e3, 0,1) })
simpleCache("normSample", { rnorm(5e3, 0,1) }, reload=TRUE)

# storing a cache after-the-fact
normSample2 = rnorm(10, 0, 1)
storeCache("normSample2")

# what's available?
listCaches()

# load a cache
simpleCache("normSample")

# load multiples caches
loadCaches(c("normSample", "normSample2"), reload=TRUE)

Example output

[1] "/work/tmp/tmp/RtmpH8khhQ"
::Creating cache::	/work/tmp/tmp/RtmpH8khhQ/normSample.RData
<00h 00m 0.0s>::Object exists (in .GlobalEnv)::	normSample
::Loading cache::	/work/tmp/tmp/RtmpH8khhQ/normSample.RData
::Creating cache::	/work/tmp/tmp/RtmpH8khhQ/normSample2.RData
[1] "normSample.RData"  "normSample2.RData"
::Object exists (in .GlobalEnv)::	normSample
::Loading cache::	/work/tmp/tmp/RtmpH8khhQ/normSample.RData
::Loading cache::	/work/tmp/tmp/RtmpH8khhQ/normSample2.RData

simpleCache documentation built on April 17, 2021, 9:08 a.m.