The launcher.py module#

Summary#

launch_speos

Start the Speos Service remotely using the product instance management API.

launch_remote_speos

Start the Speos Service remotely using the product instance management API.

launch_local_speos_rpc_server

Launch Speos RPC server locally.

Description#

Module to start Speos RPC Server.

Module detail#

launcher.launch_speos(version=None)#

Start the Speos Service remotely using the product instance management API.

Prerequisite : product instance management configured.

Parameters:
versionstr, optional

The Speos Service version to run, in the 3 digits format, such as “242”. If unspecified, the version will be chosen by the server.

Returns:
ansys.speos.core.speos.Speos

An instance of the Speos Service.

launcher.launch_remote_speos(version=None)#

Start the Speos Service remotely using the product instance management API.

When calling this method, you need to ensure that you are in an environment where PyPIM is configured. This can be verified with pypim.is_configured.

Parameters:
versionstr, optional

The Speos Service version to run, in the 3 digits format, such as “242”. If unspecified, the version will be chosen by the server.

Returns:
ansys.speos.core.speos.Speos

An instance of the Speos Service.

launcher.launch_local_speos_rpc_server(version=DEFAULT_VERSION, port=DEFAULT_PORT, message_size=MAX_MESSAGE_LENGTH, logfile_loc=None, log_level=20, speos_rpc_path=None)#

Launch Speos RPC server locally.

Warning

Do not execute this function with untrusted input parameters.

Parameters:
versionstr

The Speos server version to run, in the 3 digits format, such as “242”. If unspecified, the version will be chosen as ansys.speos.core.kernel.client.LATEST_VERSION.

portUnion[str, int], optional

Port number where the server is running. By default, ansys.speos.core.kernel.client.DEFAULT_PORT.

message_sizeint

Maximum message length value accepted by the Speos RPC server, By default, value stored in environment variable SPEOS_MAX_MESSAGE_LENGTH or 268 435 456.

logfile_locstr

location for the logfile to be created in.

log_levelint

The logging level to be applied to the server, integer values can be taken from logging module. By default, logging.WARNING = 20.

speos_rpc_pathOptional[str, Path]

location of Speos rpc executable

Returns:
ansys.speos.core.speos.Speos

An instance of the Speos Service.