Restarting a Coupled Analysis in Workbench

You can restart a completed or interrupted coupled analysis in Workbench, either from the final result or from an intermediate result. When restarting a coupled analysis Workbench, you must select the necessary participant restart files and start participants manually.


Note:  Mechanical Steady-State Thermal Transient Thermal analysis system do not support restarts.


For information on restarts from one of System Coupling's user interfaces, see Restarting a Coupled Analysis.

Generating Restart Files in Workbench

Restarts of a System Coupling analysis require corresponding restart points to exist in System Coupling and in each of the solvers participating in the analysis.

Restart points are generated at the end of a coupling step. To generate restart files for a coupled analysis:

  1. Before starting the initial run of the analysis, ensure that all coupling participants are set up to save (or retain) the corresponding restart points during the analysis. For information on a given participant, see Supported Coupling Participants for System Coupling in Workbench for a list of supported systems and references to their corresponding documentation regarding restarts.

  2. Set up the System Coupling system to control the creation of restart points at certain intervals during the execution of the coupled analysis.

    1. On the Project Schematic, double-click System Coupling's Setup cell.

      The System Coupling tab opens.

  3. In the Outline, select System Coupling > Setup > Execution Control > Intermediate Restart Data Output.

  4. In Properties pane, set Output Frequency to one of the options described in Intermediate Restart Data Output.

Restarting a Coupled Analysis in Workbench

Once the execution of the Workbench coupled analysis is finished or interrupted, or if the solution fails, you can restart from any of the saved restart points. You must select the same restart point for the System Coupling system and all coupling participants.


Note:  For coupled analyses set up in Workbench, restarts are not supported if the default participant names (Solution, Solution 1, and so on) have been changed.


To restart the coupled analysis run:

  1. For each participant connected to the System Coupling system, specify a restart point in the participant application. Make sure that these restart points correspond to the restart point you will choose in System Coupling.

    For instructions on selecting a restart point for a given participant, see Supported Coupling Participants for System Coupling in Workbench and follow the link to its documentation.

  2. Make any necessary changes to analysis settings for participants.

    For instructions on changing settings for a given participant, see Supported Coupling Participants for System Coupling in Workbench and follow the link to its documentation.


    Note:  Changes saved prior to the restart (either in System Coupling or in any participant except Mechanical) are written to the Settings file and included in the restarted run.


  3. Make any necessary changes to the System Coupling system:

    1. Double-click System Coupling's Setup or Solution cell to open the System Coupling tab.

    2. Change the required System Coupling settings. Setup changes commonly include changes to a combination of the following:

      • Coupling analysis type

      • Coupling initialization and duration settings

      • Coupling step size

      • Minimum and maximum number of coupling iterations per coupling step

      • Data transfer convergence target and under-relaxation factors

  4. Select the restart point for the System Coupling system:

    1. On the Project Schematic, open the System Coupling tab by double-clicking System Coupling's Setup or Solution cell.

    2. In the Outline under Analysis Settings > Properties, set Coupling Initialization to the restart point corresponding to the restart point you selected in the participant systems.

  5. In the Outline, right-click Solution and select Update to restart the solution.

Details for the restarted run are appended to the end of the existing scLog.scl file. System Coupling goes to the end of the specified coupling step and continues the solution with the next step.

Recovering from a Workbench Crash

Workbench or one of its component systems may crash in such a way that restart files are available, but not recognized or populated in the Workbench project. In this case, you can recover your project and restart your analysis using the steps below.

The usual project directory (<ProjectName>_files) contains the latest System Coupling results and restart points (these solvers use the live project instead of running in a temporary directory).

Note that the .backup directory contains the original version of any files which have been modified since the last save. These files are useful to recover the last saved state, but they are not useful for restarting your analysis.

To recover the project so you can restart from a specified point:

  1. Launch Workbench and open the project.

  2. The project will be locked because it was not shut down cleanly. When asked what you want to do with the project, click Unlock.

  3. When asked if you want to recover the last saved state before opening, click No.

    The state shown on the Project Schematic shows that the solution had not started, but you will find that backup files are available. Note, however, that your Workbench project does not know about these files.

  4. Populate the restart data from the participant systems connected to the System Coupling system, ensuring that these points correspond to the restart point specified in System Coupling.

    For information on how to do this for a given participant, see Supported Coupling Participants for System Coupling in Workbench and follow the links to its documentation.

  5. Recover System Coupling's restart points:

    1. On the Project Schematic, right-click System Coupling's Setup cell and select Update.

    2. Double-click the Setup cell to open the System Coupling tab.

    3. In the Outline, select Analysis Settings, then in Properties of Analysis Settings, right-click Coupling Initialization and select Read Restart Points.

      The restart points will now be available in System Coupling as usual.

    4. In Properties, for Coupling Initialization, pick a restart point that corresponds to the restart point you selected in the participant systems.

    5. Right-click Solution and select Update.

      Your restarted coupled analysis will begin to solve.