Unsurprisingly, you may want to save your results to your hard disk in case of power outages or random system crashes to allow restarting at the interrupted location, save more complete versions of the analysis results in case you want to inspect the complete simulation results at a later time, store/restore the R seeds for debugging and replication purposes, and so on. This document demonstrates various ways in which SimDesign saves output to hard disks.

As usual, define the functions of interest.

library(SimDesign)
# SimFunctions()

Design <- createDesign(N = c(10,20,30))
Generate <- function(condition, fixed_objects = NULL) {
    dat <- rnorm(condition$N)    
    dat
}

Analyse <- function(condition, dat, fixed_objects = NULL) {
    ret <- c(p = t.test(dat)$p.value)
    ret
}

Summarise <- function(condition, results, fixed_objects = NULL) {
    ret <- EDR(results, alpha = .05)
    ret
}

This is a very simple simulation that takes very little time to complete, however it will be used to show the basic saving concepts supported in SimDesign. Note that more detailed information is located in the runSimulation documentation.

1 Option: save = TRUE (Default is TRUE)

The save flag triggers whether temporary results should be saved to the hard-disk in case of power outages and crashes. When this flag is used results can easily be restored automatically and the simulation can continue where it left off after the hardware problems have been dealt with. In fact, no modifications in the code required because runSimulation() will automatically detect temporary files to resume from (so long as they are resumed from the same computer node; otherwise, see the save_details list).

As a simple example, say that in the \(N=30\) condition something went terribly wrong and the simulation crashed. However, the first two design conditions are perfectly fine. The save flag is very helpful here because the state is not lost and the results are still useful. Finally, supplying a filename argument will safely save the aggregate simulation results to the hard-drive for future refere