Matlab Distributed Computing Engine (DCE) - Cluster Matlab Job Submission
Article Index
Matlab Distributed Computing Engine (DCE)
Cluster Matlab Job Submission
Job Types Demystified (sort of)
Prototyping Your Parallel Functions
Example Job Submissions
Other Job Submission Options
Known Errors and Limitations
All Pages

Cluster Matlab Job Submission

To submit either a simple or complex job to the FSU Matlab DCE, you call the same function:

fsuClusterMatlab

This function is a customized wrapper that will setup the Matlab environment based on a number of arguments (at the Matlab prompt, type "help fsuClusterMatlab"):

>> help fsuClusterMatlab
  Setup jobs to run on the FSU cluster Matlab Distributed 
  Computing Engine (DCE) FSUCLUSTERMATLAB(outputdir, 
  moabopts, jobtype, waitforresults, numworkers, jobfunc, ...
  jobfuncargs) returns the results of the job as a cell and 
  takes optional arguments of:
 
    outputdir       = Directory to store output and intermediate 
                      files. Defaults to current directory.
                      E.g., '~/matlab/jobs' format allowed.
    moabopts        = Options to pass to moab, i.e., walltime 
                      (defaults to 10 days), queue, qos, etc.
                      E.g., '-l walltime=4:00:00, -l qos=coaps_high' 
    jobtype         = (s)imple, (p)ool arallel, (m)pi parallel
                      Defaults to (s)imple (multiple separate jobs)
                      (p)ool parallel is the matlabpool that allows the 
                      use of parfor loops (m)pi parallel can harness 
                      the labindex/labnumber functionality
    waitforresults  = (w)ait or (n)owait
                      Defaults to waitForState which blocks execution in
                      the client session until the job finishes (results
                      are returned) or fails.
    numworkers      = Number of separate matlab workers to
                      start (cpus). Defaults to 1.
    jobfunc         = The matlab function to pass to the DCE.
    jobfuncargs     = The (optional) input arguments to your jobfunc.
 
  The Matlab session must be invoked with the jvm to work correctly.