R2GUESS (version 2.0)

Extend.R2GUESS: Extends an already finished R2GUESS run for an extra user-defined number of iterations

Description

The Extend.R2GUESS extends an already finished R2GUESS run.

Usage

Extend.R2GUESS(x, niter, time.limit=NULL)

Arguments

x

an object of class ESS.

niter

integer specifying the number of additional sweeps to run the model for.

time.limit

numeric representing the maximum computation time (in hours) allowed for extending the run. By default (NULL), the run will continue until completion.

Value

An object of class ESS whose fields are detailed in as.ESS.object, and which contains results from the additional sweeps.

Details

The Extend.R2GUESS extends an already finished R2GUESS run for an additional niter sweeps. Results from these extra iterations will be appended to the existing history files, and posterior calculations (MPPI, MPP, and the list of best models) will be entirely updated. These additional iterations will use the same pseudo-random number generator as the one used for the initial run, and will initialise it at the state it was while finishing the original run. If the previous run was interrupted before reaching the user-defined time.limit, Extend.R2GUESS will return an error message.

See Also

Resume.R2GUESS, Postprocess.R2GUESS, as.ESS.object

Examples

# NOT RUN {
modelY_Hopx <- example.as.ESS.object()
## Be careful the Output files will be created in modelY_Hopx$path.output
## If you want to save the new Ouput copy/paste the 
## folder modelY_Hopx$out in an appropriate place
## and change modelY_Hopx$path.output
modelY_Hopx_extend <- Extend.R2GUESS(modelY_Hopx,100)
# }