Understanding the System Coupling Log File

The System Coupling Service log file (scLog.scl) provides key run time information and is divided into four blocks:

The start time and date, command line information and executable details for the run appear as follows:

Run start time and date:  10:15:41, Sep 19 2014
                                                                      
Command line used to start this service:

C:\Program Files\ANSYS Inc\v182\aisol\bin\winx64\Ansys.Services.SystemCoupling.exe -inputFile scInput.sci 

======================================================================
======================================================================
======================================================================
|                                                                    |
|                    ANSYS System Coupling Service                   |
|                    Version 16.0,  Copyright 2014                   |
|                (Build Info. - 10:09:03, Sep 19 2014)               |
|                                                                    |
======================================================================
======================================================================
======================================================================

The command used to start the System Coupling service is given next as shown below:

Command line used to start this service:   C:\Program Files\ANSYS Inc 
(Dev)\v182\aisol\bin\winx64\Ansys.Services.SystemCoupling.exe

An echo of the SC service input file is provided next in the log file below the following header:

 ======================================================================
 ======================================================================
 |                                                                    |
 |                  Summary of System Coupling Setup                  |
 |                                                                    |
 ======================================================================
 ======================================================================

The information generally found in this section includes unit system data (for example, MKS, and so on), as well as information relating to coupling (time versus coupling step), initialization (options such as time value or initial coupling step), duration (for example, end time), and step size and the maximum/minimum number of iterations.


Note:  When the coupling is defined by coupling step (and not by time), then time-related information (initial time, end time, or step size) is not displayed in this section of the log file, and only step-related information is available (for example, initial step, number of steps, maximum and minimum iterations).


Summary of System Coupling Setup

Under this section of the log file, there are sub-blocks (for example, “Analysis Information”, “Coupling Participant Information”, “Data Transfer Information”, “Execution Control Information”, “Setup Validation“ and “System Coupling Co-Simulation Summary”). A brief description of these sub-blocks is provided below.

The Analysis Information section includes basic information about the coupling definition, the unit system, as well as time and step information.

======================================================================
|                      Analysis Information                          |
======================================================================

General :                                                             
  Analysis Type        = Transient                                    
  Unit System          = MKS                                          

Initialization :                                                      
  Option               = Automatic                                    

Step :                                                                
  Option               = Step Size                                    
  Size                 = 0.05                                         
  Minimum Iterations   = 5                                            
  Minimum Iterations   = 5                                            

Duration :                                                            
  Option               = End Time                                     
  Time                 = 0.05                                         

The Coupling Participant Information section includes information about each of the solvers connected to the system coupling simulations (for example, internal name, type (either Co-Simulation or Static Data), units, and so on). Additional information for coupled regions and variables that appear in data transfers is also displayed in this section of the log file. This additional information includes: the coupled name and type (for regions); and the variable name and physical type (for variables). This information is not displayed for regions and/or variables that do not participate in data transfers. If such regions or variables exist, a message is written to indicate that the related information has been omitted from this section of the log file.

======================================================================
|                   Coupling Participant Information (2)             |
======================================================================

+--------------------------------------------------------------------+
| Participant: Fluent                                                |
+--------------------------------------------------------------------+

General :                                                             
  Unit System          = MKS_STANDARD                                 
  Type                 = CoSimulation                                 
  Name                 = Fluent                                       

Summary of Coupling Regions (1)
Region : plate                                                        
  Internal Name        = plate                                        
  Type                 = Surface                                      

Summary of Coupling Variables (2)
Variable : Displacement Display Name                                  
  Internal Name        = INCD                                         
  Physical Type        = Length                                       
Variable : Force Display Name                                         
  Internal Name        = FORC                                         
  Physical Type        = Force                                        

Summary of Base Units (9)
   Angle                 = radian                                      
   ChemicalAmount        = mol                                         
   Current               = A                                           
   Length                = m                                           
   Luminance             = cd                                          
   Mass                  = kg                                          
   SolidAngle            = sr                                          
   Temperature           = C                                           
   Time                  = s                                           
 +--------------------------------------------------------------------+
 | Participant: External Data                                         |
 +--------------------------------------------------------------------+

 General :                                                             
   Unit System           = SI                                          
   Type                  = Static Data                                 
   Name                  = Setup 2                                     
   File Path             = external_load_data.xml    

 Summary of Coupling Regions (1)
 Region : File1                                                        
   Internal Name         = ExtDataReg_Setup 2_0                        
   Type                  = Surface                                     

 Summary of Coupling Variables (1)
 Variable : Temperature1                                               
   Internal Name         = ExtDataVar_Setup 2_0_1                      
   Physical Type         = Temperature                                 

 Summary above omits variables not used in data transfers. 

 Summary of Base Units (9)
   Angle                 = radian                                      
   ChemicalAmount        = mol                                         
   Current               = A                                           
   Length                = m                                           
   Luminance             = cd                                          
   Mass                  = kg                                          
   SolidAngle            = sr                                          
   Temperature           = K                                           
   Time                  = s                                           

The Data Transfer Information section includes:

======================================================================
|                   Data Transfer Information (2)                    |
======================================================================

+--------------------------------------------------------------------+
| Data Transfer: Mechanical Displacement to Fluent                   |
+--------------------------------------------------------------------+

Source : Mechanical                                                   
  Region               = Mechanical Wall Display Name                 
  Variable             = DISP Display Name                            

Target : Fluent                                                       
  Region               = plate                                        
  Variable             = Displacement Display Name                    

General Information :                                                 
  Name                 = Mechanical Displacement to Fluent            
  Execute Transfer At  = Start Of Iteration                           
  Convergence Option   = RMS Change In Data                           
    Target Value       = 0.01                                         
  Under Relax. Factor  = 0.25                                         
  Ramping              = None                                         

+--------------------------------------------------------------------+
| Data Transfer: Fluent Force to Mechanical                          |
+--------------------------------------------------------------------+

Source : Fluent                                                       
  Region               = plate                                        
  Variable             = Force Display Name                           

Target : Mechanical                                                   
  Region               = Mechanical Wall Display Name                 
  Variable             = FORC Display Name                            

General Information :                                                 
  Name                 = Fluent Force to Mechanical                   
  Execute Transfer At  = Start Of Iteration                           
  Convergence Option   = RMS Change In Data                           
    Target Value       = 0.01                                         
  Under Relax. Factor  = 0.25                                         
  Ramping              = Linear to Min. Iterations                                

The Execution Control Information section includes a summary of the sequencing of co-simulation participants, and requests for debug and intermediate result file output. Note that the debug and intermediate result output summaries are generated only if such output is requested. For example:

======================================================================
|                 Execution Control Information                      |
======================================================================

+--------------------------------------------------------------------+
| Co-Simulation Sequence                                             |
+--------------------------------------------------------------------+
 
Sequence Index  :  1                                                  
  Fluent Solver                                                       
 
Sequence Index  :  2                                                  
   Mechanical Solver                                                  

+--------------------------------------------------------------------+
| Debug Output                                                       |
+--------------------------------------------------------------------+

General Output :                                                      
  Default               = Level 1                                     
  Startup               = None                                        
  Participant Conn.     = None                                        
  Analysis Init.        = None                                        
  Solution Init.        = None                                        
  Convergence Checks    = None                                        
  Shutdown              = None                                        

Data Transfer Output :                                                
  Default               = Level 1                                     
  Source Coords.        = None                                        
  Source Topology       = None                                        
  Source Data           = None                                        
  Target Coords.        = None                                        
  Target Topology       = None                                        
  Target Data           = None                                        

+--------------------------------------------------------------------+
| Intermediate Restart Data Output                                   |
+--------------------------------------------------------------------+

Output Frequency :                                                    
  Option                = Step Interval                               
  Interval              = 3                                           

The Setup Validation section includes any warning or error messages that may have been generated. For example:

======================================================================
|                         Setup Validation                           |
======================================================================

+--------------------------------------------------------------------+
| Warnings (  1)                                                     |
+--------------------------------------------------------------------+

1 ) Auto-Correction: The specified maximum iterations per step is less
    than the specified minimum iterations. The maximum iterations will
    be set to the minimum iterations.


+--------------------------------------------------------------------+
| Errors   (  1)                                                     |
+--------------------------------------------------------------------+

1 ) The solution sequence specified for the participant named 'Fluent'
    is not greater than zero.  Adjust this (and other) sequence
    values appropriately.

The System Coupling CoSimulation Summary section includes a brief summary of the participants in the co-simulation.

======================================================================
|                 System Coupling CoSimulation Summary               |
======================================================================

Participant : Mechanical APDL                                         
  Version/Build Info   = Mechanical APDL Release 16.0 UP20130905      
                              DISTRIBUTED WINDOWS x64  Version        
Participant : Fluent                                                  
  Version/Build Info   = ANSYS Fluent 16.0.0                                

Solution

Next is the “Solution” block. Under it, the following information is provided.

 ======================================================================
 ======================================================================
 |                                                                    |
 |                              Solution                              |
 |                                                                    |
 ======================================================================
 ======================================================================

The Solution block contains a Mapping Summary section:

 +--------------------------------------------------------------------+
 |                        MAPPING SUMMARY                             |
 +--------------------------------------------------------------------+
 | Data Transfer                    |                                 |
 |   Diagnostic                     |   Source Side  |   Target Side  |
 +----------------------------------+----------------+----------------+
 | Mechanical Displacement to Fluent|                |                |
 |   Percent Nodes Mapped           |      N/A       |      100       |
 | Fluent Force to Mechanical       |                |                |
 |   Percent Nodes Mapped           |      100       |      100       |
 |   Percent Area Mapped            |      100       |      100       |
 +----------------------------------+----------------+----------------+

The current coupling step number and the current simulation time are reported as shown below. This information will be a part of a box that is repeated in the log file at the beginning of every coupling step. It looks similar to the following:

+====================================================================+
| COUPLING STEP =  1                  SIMULATION TIME = 0.001        |
|--------------------------------------------------------------------|
| Solver                           |       Solution Status           |
|   Data Transfer                  |                                 |
|     Diagnostics                  |   Source Side      Target Side  |
+====================================================================+

Note that if the simulation is defined only by steps (and not by time), then the log file output will only present step-related information.

Next is another box that repeats every coupling iteration of every coupling step. It looks like:

+--------------------------------------------------------------------+
|                     COUPLING ITERATION = 1                         |
+--------------------------------------------------------------------+
| Fluent                           |      Not yet converged...       |
|- - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - |
| Mechanical Displacement to Fluent|      Not yet converged...       |
|     Change:RMS                   |   1.00000e+000 1.00000e+000     |
|--------------------------------------------------------------------|
| Mechanical                       |      Not yet converged...       |
|- - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - |
|   Fluent Force to Mechanical     |      Not yet converged...       |
|     Change:RMS                   |   1.00000e+000 1.00000e+000     |
+--------------------------------------------------------------------+
|                     COUPLING ITERATION = 2                         |
+--------------------------------------------------------------------+
| Fluent                           |            Converged            |
|- - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - |
| Mechanical Displacement to Fluent|            Converged            |
|     Change:RMS                   |   2.82982e-005 1.42982e-004     |
|--------------------------------------------------------------------|
| Mechanical                       |            Converged            |
|- - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - |
|   Fluent Force to Mechanical     |            Converged            |
|     Change:RMS                   |   1.30000e-004  2.08200e-000    |
+--------------------------------------------------------------------+

As indicated above, after every coupling iteration, the convergence status is given for each participant. Common participant status values are Converged and Not yet converged..., however, Divergence detected... and Status Unavailable could also be reported. Below the solver status is a list of the data transfers for which the participant is the target, plus diagnostics used to evaluate convergence of the data transfer. Any supplemental diagnostics (as described in the SC Log Output Control Settings section in Understanding the System Coupling Input File) that have been requested are also included here.

Notes specific to the execution of a given coupling step will be reported under the final coupling iteration of the step. For example:

 +====================================================================+
 | NOTES                                                              |
 | * During this coupling step, the target variable, Convection       |
 | Coefficient, was clipped for the data transfer: Upper HTC.         |
 | * Intermediate result file written: scResult_01_000475.scr         |
 +====================================================================+

Shutdown

Next is the “Shut Down” block under which the following information is included:

 ======================================================================
 ======================================================================
 |                                                                    |
 |                          Shut Down                                 |
 |                                                                    |
 ======================================================================
 ======================================================================

 System Coupling Service shut down...

 Run completed successfully.

The preceding output is generated under normal shutdown conditions. If a co-simulation participant (or the coupling service itself) fails during the analysis, the normal shutdown output will be replaced by messages similar to the following:

 +====================================================================+
 |                              NOTICE                                |
 | An exception has occurred and has been transmitted to the coupling |
 | participants.  These participants have been disconnected from the  |
 | coupling service.                                                  |
 +====================================================================+


 +====================================================================+
 |                      System Coupling Exception                     |
 +====================================================================+
 | Origin            : Fluids Problem (Solution 1)                    |
 | Error Code        : 2                                              |
 | Error Description :                                                |
 |   Fluent encountered fatal error after sync point Solve            |
 +====================================================================+


 System coupling run completed with errors.

The first block indicates that all co-simulation participants have been notified of the problem. The second block indicates the origin (that is, the coupling participant) of the failure, and an error code and description. For additional information, see Troubleshooting Two-Way Coupled Analyses Problems.


Release 18.2 - © ANSYS, Inc. All rights reserved.