launch#

ansys.systemcoupling.core.launch(*, port=None, working_dir=None, nprocs=None, sycnprocs=None, extra_args=[])#

Start a local instance of System Coupling and connect to it.

Parameters:
portint, optional

Port on which to connect to System Coupling. The default is None, in which case an available port is found and used.

working_dirstr, optional

Path for the working directory of the System Coupling process. The default is None, in which case the current directory of the client process is used.

nprocsint, optional

Number of processes for coupling participants. The default is None, in which case the System Coupling server uses its own default.

sycnprocsint, optional

Number of processes for the System Coupling engine. The default is None, in which case the System Coupling server uses its own default.

extra_argsList[str]

List of any additional arguments to specify when the server process is launched. The default is []. If a list of additional arguments is provided, it is concatenated as-is to the list of arguments already being passed when the process is started. If an argument has an associated value, the argument name and its value should be specified as two consecutive items of the list.

Returns:
ansys.systemcoupling.core.session.Session

Session object, providing access to a set up and solve API controlling a remote System Coupling instance.

Return type:

Session