Starting the System Coupling GUI

You can start the System Coupling GUI using either of the following methods:

Starting the GUI from the Start Menu

To start the System Coupling GUI from the Windows Start menu:

  1. From the Start menu, select Ansys 2024 R2 > System Coupling 2024 R2.

    The Select Folder dialog opens.

    The System Coupling GUI opens. Because you are required to select System Coupling's working directory before starting to populate the data model, the Select working directory dialog opens immediately.

  2. Navigate to the location that will be the working directory for the coupled analysis, select the directory, and click Select Folder.

The Select Folder dialog closes and the System Coupling GUI opens in the specified directory.

If the state of a previous coupling run has been saved to the SyC directory (that is, there are Settings and Restart files), then System Coupling automatically loads that analysis in its most recent state.

If a solve is already running in this directory, then the GUI connects to it automatically. For details, see Reconnecting the GUI to a Running Coupled Solution.

Starting the GUI from the Command Line

To start the System Coupling GUI from the command line:

  1. Navigate to the directory that is to be System Coupling's working directory.

  2. Open the shell for your operating system.

  3. Run the System Coupling executable for the appropriate platform, using the -G or --guicommand-line option.

    • Windows

      
      > "%AWP_ROOT242%\SystemCoupling\bin\systemcoupling" -G
      
      
    • Linux

      
      $ "$AWP_ROOT242/SystemCoupling/bin/systemcoupling" -G
      
      

The System Coupling GUI opens in the current directory and an instance of System Coupling is started. System Coupling runs in this working directory and creates a SyC subdirectory for its coupling-related output.

If the state of a previous coupling run has been saved to the SyC directory (that is, there are Settings and Restart files), then System Coupling automatically loads that analysis in its most recent state.

If a solve is already running in this directory, then the GUI connects to it automatically. For details, see Reconnecting the GUI to a Running Coupled Solution.


Tip:  When starting the System Coupling GUI from the command line, you can use the following command-line options to configure the coupling run:

  • To specify System Coupling's working directory, you can use the -w or --workDirDialog option to launch the Select working directory dialog.

  • To run a script on startup, you can use the -R command-line option.

  • To specify how long System Coupling waits for participants to connect to the coupled analysis, use the -C or --connectiontimeout argument, as described in Setting a Participant Connection Timeout Interval.

  • To control System Coupling's behavior for parallel runs, use the parallel startup options described in Parallel Options for System Coupling.

For a comprehensive listing of all available command-line options, see Command-Line Options in the System Coupling Settings and Commands Reference.