callaltairbatch
Runs the Altair Compute Console to submit a job to a specified solver using the specified target file. By default, the job will run synchronously and the function will wait for the process to complete. If Compose is not installed in the same directory with the Altair solvers, the setaltairfolder option must be called before running callaltairbatch.
Syntax
callaltairbatch (stringSoftware, stringFilepath, ...)
R1 = callaltairbatch (stringSoftware, stringFilepath, ...)
[ R1, R2 ] = callaltairbatch (stringSoftware, stringFilepath, ...)
Inputs
- stringSoftware
- Software name to be invoked.
- stringFilepath
- File name to be submitted to the above software.
- ...
- Additional arguments will all be strings appended to the call to launch Altair Compute Console.
Outputs
- R1
- The status of the system command to launch Altair Compute Console.
- R2
- Contains any text output by the software that has been executed.
Examples
Call RADIOSS without output arguments:
callaltairbatch('RD', 'RDTest.rad')
(No output when no output arguments are specified.
Call RADIOSS with one output argument:
R1 = callaltairbatch('RD', 'RDTest.rad')
R1 = 0
Call RADIOSS with two output arguments:
[ R1, R2 ] = callaltairbatch('RD', 'RDTest.rad')
R1 = 0
R2 = Output from a batch call is returned. Output from a batch call can be quite lengthy and is not included here.
Call HyperMesh with a file session:
callaltairbatch('hm', 'MySession.hm')
(No output when no output arguments are specified.
Call HyperView with optional input arguments, such as a TCL script:
callaltairbatch('hv', '-tcl MyHyperViewScript.tcl')
(No output when no output arguments are specified.
Comments
callaltairbatch leverages shell commands and as such, it is necessary to use double quotes in parameter values if they contain spaces, otherwise the spaces will be interpreted as new arguments. Other default shell command rules and best practices apply as well.
When a non-solver is called (e.g.: HyperMesh), although the execution of the command is done in batch, non-solvers are GUI-based applications and therefore the result of callaltairbatch invokes the GUI of that specific software that has been called.