extra_options gains support for
.options.mpi to control the MPI properties documented in
doMPIquite() now removes the sunk connection temp file to
save storage issues (e.g., when distributing on Slurm)Attach() gains an omit argument to omit
specific elements from being attached to the working environment
(default still attaches all objects supplied)Using a list definition for Analyse input now
executes all functions by default regardless of errors thrown. Error
messages and seeds remain captured in the output, however are labelled
according to the number of errors that were observed (e.g.,
SimExtra(result, what = 'errors') may return column with
"ERROR: 2 INDEPENDENT ERRORS THROWN: ..."). Previous early
termination default can be reset by passing
extra_options = list(try_all_analyse = FALSE) to
runSimulation(). Special thanks to Mark Lai for bringing
this to my attention on Issue #20
Added beep argument to runSimulation()
to play a beep message via the beepr
Added RSE() function to compute the relative
behaviour of the average standard error to the standard deviation of a
set of parameter estimates across the replications
(RSE = E(par_SEs) / SD(par_ests))
Bugfix for new list input for analysis functions when error raised (reported by Mark Lai)
SimExtract() gains a fuzzy argument to
allow fuzzy matching of error and warning messages. This helps collapse
very similar errors messages in the recorded tables, thereby improving
how to discern any pattern in the errors/warnings (e.g., Messages such
as “ERROR: system is computationally singular: reciprocal condition
number = 9.63735e-18” and “ERROR: system is computationally
singular: reciprocal condition number = 6.74615e-17” are
effectively the same, and so their number of recorded occurrences should
be collapsed)
Added AnalyseIf() function to allow specific
analysis function to be included explicitly. Useful when the defined
analysis function is not compatible with a row-condition in the
Design object. Only relevant when the analyse
argument was defined as a named list of functions
The analyse argument to runSimulation()
now accepts a named list of functions rather than a single
analysis function. This allows the user to separate the independent
analyses into distinct functional blocks rather than having all analyses
within the same function, and potentially allows for better modularity.
The debug argument now also accepts the names of these
respective list elements to debug these function definitions
quickly
SimFunctions() gains an nAnalyses
argument to specify how many analysis functions should be templated
(default is 1, retaining the previous package defaults)
Various performance improvements to reduce execution overhead
(e.g., REPLICATION ID now moved to an
extra_option as this was identified as a
bottleneck)
Meta-statistical functions now support a
fun(list, matrix) input form to compute element-wise
summaries that return a matrix structure
Summarise() can now return list
arguments that can later be extracted via
SimExtract(sim, what = 'summarise'). Consequently, because
list outputs are now viable the purrr package has been
added to the suggests list
Prevent aggregate_simulations() from overwriting
files and directories accidentally. As well, the auto-detection of
suitable .rds files has been removed as explicitly stating the
files/directories to be aggregated is less error prone
Removed plyr::rbind.fill in favour of
dplyr::bind_row(), which removed plyr as a
dependency
Attach() now accepts multiple list-like objects as
inputs
Added SimCheck() for checking the state of a
long-running simulation via inspecting the main temp file
sessioninfo package used in placed of the
traditional sessionInfo()
Print number of cores when parallel processing is in use
A number of arguments from runSimulation() moved
into extra_options list argument to simplify
documentation
Parallel processing now uses FORK instead of PSOCK when on Unix machines by default
More natural use of RPushbullet by changing the
notification input into one that accepts a character vector
(“none”, “condition”, “complete”) to send pbPost() call.
Also more informative in the default messages sent
Added “Empirical Supremum Rejection Sampling” method to
rejectionSampling() to find better constant
M (useful when there are local minimums in the
f(x)/g(x) ratio)
rejectionSampling() made more general, with
additional examples provided in the help files
Bootstrap CI estimates moved into runSimulation(),
deprecating the less optimal SimBoot()
runSimulation(..., save=TRUE) now default to always
store meta-information about the simulation state
Added renv to the suggests lists since it’s useful
to hard-store package versions used in simulations
data.frame objects largely replaced with
tibble data frames instead as they render better for larger
simulations
Support for rbind() and cbind() on
final simulation results to add additional condition/meta-summary
information
Use createDesign() instead of
expand.grid() in code, which provides more structured
information and flexibility
Added SimExtract() to extract important but silent
information
Added stop_on_fatal logical argument to more
aggressively terminate the simulation rather than do things more
gracefully