grid.apply {GridR}R Documentation

grid.apply

Description

grid.apply submits a function to another Host or Cluster, to execute it there.

Usage

grid.apply(grid.input.Parameters.y=NULL,grid.input.Parameters.f=NULL,... ,wait=FALSE ,varlist=c(),plots=FALSE, run=1, check=TRUE, batch=NULL, javaSsh=FALSE)

Arguments

grid.input.Parameters.y The variable in " " where to write the output if the job is finished
grid.input.Parameters.f which function should be executed remotely
... the parameters of the function
wait if wait=TRUE, R blocks until the Job is executed, otherwise Job starts in background
varlist if you know which variables or functions are needed to execute that function remotely, add them here if you do not want to use check=TRUE
plots is there a plot output of the function? Will be implemented in future
run please do not change, for internal use
check if check=TRUE, before submission it is checked if the function needs other variables or other functions to executed it remotely. If so, they are copied. If an intenal function like sum is applied, please use check=FALSE, otherwise codetools doesnt work
batch If you want the output of different parameter sets, you can add here which parameters are vectors and should be sweeped ie. c(1,3) then all combinations of parameter 1 and 3 are executed, only works with condor.ssh, remote.ssh and local modes
javaSsh if TRUE, ssh transmission will work on Linux Systems over a JavaSsh Library and not directly over ssh

Details

Until the result is back, there is a lock to variable y

Be careful: The variable "grid.input.Parameters" is used internally, so please do not use it in your code!

To delete old local tmp files call grid.consistency

Author(s)

Malte Lohmeyer

See Also

grid.init

Examples

#example to execute function a on a single remote host via ssh and save the result to x
library("GridR")
a<-function(s){Sys.sleep(s); return(s)}
grid.init(service="local", localTmpDir="GridRTmp/")
grid.apply("x",a, 3, wait=TRUE, check=TRUE)
x

#example for batch mode
library("GridR")
a<-function(s, p, q){return(s+p+q)}
grid.init(service="local", localTmpDir="GridRTmp/")
grid.apply("y",a, c(0,1,2),1, c(100,200,300), wait=TRUE, check=FALSE, batch=c(1,3))
#Here all combinations of (0,1,2), 1 and (100,200,300) are executed as parameters of function a. A List with all combinations is returned.
y


[Package GridR version 0.9.1 Index]