load#

TcpOslServer.load(uid: str, args: Dict[str, Any] | None = None, run_async: bool = False) → str | None#

Explicit load of node.

Parameters:
uid: str

Actor uid.

args: Optional[Dict[str, any]], optional

Additional arguments, by default None.

run_async: bool, optional

Whether to perform the load as an asynchronous, non-blocking long running operation. If True, this method returns immediately with the ID of the long running operation instead of waiting for the load to complete. Use get_long_running_operation_status() or wait_for_long_running_operation() to poll for or await its completion. By default False.

Note

Argument is supported for Ansys optiSLang version >= 27.1 only.

Returns:
Optional[str]

ID of the long running operation if run_async is True, None otherwise.

Raises:
OslCommunicationError

Raised when an error occurs while communicating with server.

OslCommandError

Raised when the command or query fails.

TimeoutError

Raised when the timeout float value expires.