Running a Coupled Simulation

To run a coupled simulation, you must first set up the runtime environment and then start the client processes and the SIMULIA Co-Simulation Services Director in charge of the coupled simulation.

You can start the client processes and the SIMULIA Co-Simulation Services Director in any order.

This page discusses:

Setting up the Runtime Environment

All clients and the SIMULIA Co-Simulation Services Director require the SIMULIA Co-Simulation Services libraries; the operating system needs to know where the libraries are located. There are several methods for the operating system to properly load the SIMULIA Co-Simulation Services libraries:

  • If you are a member of the SIMULIA Alliance program, you can distribute the SIMULIA Co-Simulation Services libraries with your application media. In this case, you can load the libraries at run time from the same location as your application’s dynamic libraries.
  • The end user might extract the SIMULIA Co-Simulation Services and install them in a specific folder. On Windows, prepend this folder to the system path defined by the PATH environment variable. On Linux, set the LD_LIBRARY_PATH environment variable to include the folder containing the libraries.

  • If Abaqus is installed on your system, you can point directly to the /code/bin directory in the Abaqus release folder to use the libraries that Abaqus is using. On Windows, prepend the /code/bin directory to the system path, PATH, environment variable. On Linux, include the /code/bin path in the LD_LIBRARY_PATH environment variable.

In addition to any license server settings, you need to define the following environment variables for the SIMULIA Co-Simulation Services Director process:

  • Set the CATDICTIONARYPATH environment variable to point to the /dictionary folder. This is required for XML document parsing.
  • Set SMACSE_CFG to point to the /site folder. This is required for upgrading the Co-Simulation Configuration file.

Starting the SIMULIA Co-Simulation Services Director

To start the SIMULIA Co-Simulation Services Director, provide a Co-Simulation Configuration file and a unique listener port, both of which are associated with a particular coupled simulation. The SIMULIA Co-Simulation Services Director can be started directly with SMACseCtlMain (which is located in the /bin folder of the SIMULIA Co-Simulation Services API Kit) or by using the Abaqus execution procedure.

Starting the SIMULIA Co-Simulation Services Director Directly

When starting the SIMULIA Co-Simulation Services Director directly, you must set the environment variables discussed in the previous section.

The command line summary:

SMACseCtlMain job cosim-job-name configure configuration file-name listenerport listener port-number datacheck interactive

Starting the SIMULIA Co-Simulation Services Director Using the Abaqus Execution Procedure

If Abaqus is installed, you can start the SIMULIA Co-Simulation Services Director using the Abaqus execution procedure as follows:

abaqus -cse -job <log_file> -configure <configure_file> -listenerport <port>
This is the preferred approach because the Abaqus execution procedure defines the necessary environment settings. For more information, see SIMULIA Co-Simulation Services Director Execution.