model.methodCall()

model.methodCall()

Calling model methods. You can create and run model methods to extend the functionality of a COMSOL Multiphysics simulation using custom methods. See the Application Programming Guide for more information about creating and using methods.


	The Model Java-file history for running a method call in the COMSOL Desktop contains the history produced while running the method call and not the method itself.

model.methodCall().create(<tag>,<methodname>);

model.methodCall(<tag>).run();

model.methodCall(<tag>).inputNames();

model.methodCall(<tag>).methodName();

model.methodCall(<tag>).methods();

model.methodCall(<tag>).set(<param>,<expr>);

model.methodCall(<tag>) represents a method call for a model method.

model.methodCall().create(<tag>,<methodname>) creates a method call for the model method <methodname> with the given tag.

model.methodCall(<tag>).inputNames(); returns the names of input parameters of a method reference by a given method call.

model.methodCall(<tag>).methodName returns the name of the method that the method call runs.

model.methodCall(<tag>).methods(); returns the names of all methods in the model.

model.methodCall(<tag>).run() runs the method call with the tag <tag>.

The following examples show how you can specify the names of an input parameter, the value of a 1D double array parameter, and the value of a Boolean parameter:

model.methodCall(<tag>).set("paramname","p1");

model.methodCall(<tag>).set("paramvalues",new double[]{2.3 3.7 5.6 7.1 11.3 17.5});

model.methodCall(<tag>).set("sendmail",true);

Parameter names are created automatically with the appropriate types according to the inputs that have been specified in the method. This means that you can then use a natural set syntax as shown in the examples above.

Arguments to Method Calls

The following table describes the names of arguments that you can use to change the value of inputs to a method call before running it:

Table 2-91: Argument Names for Method Calls
Argument Name	Sample Values	Description
-methodinputnames	size,times	Comma-separated list of names of inputs (as strings) to change for the method call to run.
-methodinputvalues	0.8,{0.1,0.3,0.8}	Comma-separated list of the corresponding values. Arrays and 2D arrays are entered using curly braces.
-methodinputfile	Path to file	A file to read the inputs to the method call from. This file has the same format as the one used together with -appargsfile (see the Application Builder documentation about application arguments),

Specifying method call inputs both from a file and individually on the command line can be combined. If an input is given both in a file and on the command line, the value given on the command line overrides the value given in the file. If a value is given several times in the file or on the command line, the last given value overrides any previous given value.

Using Method Calls from a Model Java-File

You can use the model method in a method call from a Model Java-file if the file starts by loading an MPH-file (including its model method) and then calls a run of a method call. However, in this context, model methods do not support user interface commands or file schema. The table below table lists user interface commands that are not supported:

Table 2-92: Unsupported User Interface Commands in Model Java-Files
Command	Result
Alert	Command is ignored
Confirm	Command causes an exception
DebugLog	Command is ignored
FileOpen	Command causes an exception
FileSaveAs	Command causes an exception
ImportFile	Command causes an exception
Message	Command is ignored
OpenURL	Command is ignored
Request	Command causes an exception
SelectNode	Command is ignored
SetProgress	Command is ignored
SetProgressInterval	Command is ignored
ZoomExtents	Command is ignored