R Graphical Manual

Browse All

Last data update: 2014.03.03

R: Collapse separate simulation files into a single result

aggregate_simulations

R Documentation

Collapse separate simulation files into a single result

Description

This function grabs all .rds files in the working directory and aggregates them into a single data.frame object or combines all the saved results directories and combines them into one. This is generally useful when results are run piecewise on one node or run independently across different nodes/computers which are not on the same network.

Usage

aggregate_simulations(files = NULL, dirs = NULL,
  results_dirname = "SimDesign_aggregate_results")

Arguments

`files`	a `character` vector containing the names of the simulation files. If `NULL`, all files in the working directory ending in `.rds` will be used
`dirs`	a `character` vector containing the names of the `save_results` directories to be aggregated. A new folder will be created and placed in the `results_dirname` output folder
`results_dirname`	the new directory to place the aggregated results files

Value

if files is used the function returns a data.frame with the (weighted) average of the simulation results. Otherwise, if dirs is used, the function returns NULL

Examples

## Not run: 

setwd('my_working_directory')

## run simulations to save the .rds files (or move them to the working directory)
# runSimulation(..., filename='file1')
# runSimulation(..., filename='file2')

final <- aggregate_simulations()
saveRDS(final, 'my_final_simulation.rds')

# aggregate saved results
# runSimulation(..., save_results = TRUE, save_details = list(save_results_dirname = 'dir1'))
# runSimulation(..., save_results = TRUE, save_details = list(save_results_dirname = 'dir2'))

# place new saved results in 'SimDesign_results/' directory by default
aggregate_simulations(dirs = c('dir1', 'dir2'))



## End(Not run)