Data Transfers

A data transfer is defined by one source and one target region, and is able to transfer one variable type in one direction between two participants.

Each data transfer is defined by a variety of properties such as Source, Target, and Data Transfer Control. A one-way coupled analysis has data transfer(s) in only one direction between the coupled participants. In this type of analysis, the source region(s) are defined on only the participant sending data, and the target regions(s) are defined on only the participant whose solver is receiving the data.

A two-way coupled analysis has data transfers in both directions between the coupled participants. In this type of analysis, source and target regions are defined on both participants. For example, consider a coupled two-way fluid-structure interaction analysis where a Fluent system and a Static Structural system are the two participants. The Fluent system would have a region which is the source region for the transfer of force, and the target region for the transfer of incremental displacement. The Static Structural system would have a region that is the source region for the transfer of incremental displacement, and the target region for the transfer of force.

Source/Target

Both Source and Target are each defined by a coupling participant along with a region and a variable defined within the context of that participant. For a two-way data transfer on one region, you define two individual data transfers. When you set up your data transfers, a top-down approach should be followed when selecting Source and Target. Select in this order:

  1. Source Participant

  2. Source Region

  3. Source Variable

  4. Target Participant

  5. Target Region

  6. Target Variable

Data Transfer Control

Additional properties can be defined to control the way in which the specified data transfers are executed. For each data transfer you can specify controls that determine:

  • When the transfer is to occur.

  • The under relaxation factor applied to the transfer.

  • The convergence target.

  • If ramping is used when applying data from the source-side to the target-side of the data transfer.

Transfer At

The Transfer At property is used to control when the data transfer is executed by the solver. The only available option is:

Start of Iteration

Transfer data at the start of every coupling iteration within a coupling step.

Under Relaxation Factor

The factor multiplying the current data transfer values when under-relaxing them against the previous values. This is overridden with unity in the first coupling iteration of every coupling step only when the Analysis Type is Transient.


Note:  When under-relaxation is used, there is no guarantee that the full value from the source side of the data transfer is applied to the target by the end of the coupling step.


RMS Convergence Target

The target value used when evaluating convergence of the data transfer within a coupling iteration. The default value is 1e-2. The convergence target is RMS-based. For information regarding how this target is applied, see Evaluating Convergence of Data Transfers.

Ramping

The available options for ramping controlled by System Coupling are as follows:

None

The full data transfer value is applied to the target side of the interface for all coupling iterations. No ramping is the default option.

Linear to Minimum Iterations

Within each coupling step, the ramping factor is used to linearly increase the change in the data transfer value applied to the target side of the interface. The data transfer value is increased during each coupling iteration until the specified minimum number of coupling iterations, , is reached. The ramping factor is applied to the change in the data transfer value from the previous coupling step. If there is no change in this value from the last coupling step, the full data transfer value is applied to the target side of the interface for all coupling iterations of that coupling step.

During the coupling iteration (for ), the ramping factor equals . The full data transfer value is applied for all coupling iterations that are equal to or greater than the minimum number of coupling iterations. As is always reached, the full data transfer value is always applied by the end of each coupling step. This ramping behavior is demonstrated in Figure 3: Schematic of the Linear to Minimum Iterations Ramping Concept for the case where the minimum number of iterations specified is 5.

When ramping using Linear to Minimum Iterations, if the minimum number of iterations is the same as the maximum number of iterations, then it is unlikely that the data transfer will converge. It is a best practice for your maximum iterations to be larger than your minimum iterations.

Figure 3:  Schematic of the Linear to Minimum Iterations Ramping Concept

Schematic of the Linear to Minimum Iterations Ramping Concept

Ramping and under-relaxation are independent operations. Ramping is applied before under-relaxation.


Note:  System Coupling’s ramping will interact with ramping behaviors within the participant systems. To understand the full ramping behavior, verify ramping settings to see if your participant system is ramping loads received from System Coupling. For ramping behavior in Mechanical, see System Coupling Related Settings in Mechanical in the ANSYS Mechanical User's Guide.


See Working with Data Transfers for details about how to create, modify data transfers and do other common operations.

Working with Data Transfers

After you connect a participant system's Setup cell to the System Coupling Setup cell in the project schematic, the System Coupling workspace displays the regions and variables available to create data transfers after a Refresh of the Setup cell:

Create Data Transfer

There are different ways to create single and multiple data transfers using the Create Data Transfer context menu option.

Create uninitialized data transfer

Select the "Data Transfers" tree node in Outline view, then select Create Data Transfer from the context menu. This creates a new data transfer without any source or target properties defined. You can later modify the data transfer definition in Properties view.

Create data transfers for two regions from different participants

Select two regions from different participants in the Outline view, then select Create Data Transfer from the context menu. This creates multiple data transfers that vary based on the following criteria:

  • Whether the two regions have the same topology

  • Whether the input variable from one region has the same properties (such as the physical type) as the output variable from the other region

Create data transfers for single region

Select a region from a participant in the Outline view, then select Create Data Transfer from the context menu. This creates data transfers for each variable associated with the region. If the variable is an output variable, then the source participant, source region, and source variable are defined for the new data transfer. If the variable is an input variable, then the target participant, target region, and target variable are defined for the new data transfer.

Create a data transfer for single variable

Select a region from a participant in Outline view, select a variable in the Properties view, then select Create Data Transfer from the context menu. This creates a new data transfer. If the selected variable is an output variable, then the source participant, source region, and source variable are defined for the new data transfer. If the selected variable is an input variable, then the target participant, target region, and target variable is defined for the new data transfer.

Modify Data Transfer

Select a data transfer in the Outline view. The Properties view displays all the properties for the data transfer. You can modify all the properties for the data transfers in the same view.

Rename Data Transfer

Select a data transfer in the Outline view. Double-click to rename the data transfer.

Duplicate Data Transfer

Select one or more data transfers in the Outline view. Right-click and select Duplicate. This operation creates new data transfers with the same Source, Target, and Data Transfer Control properties. Note that you can change these properties as needed for these new data transfers.

Suppress Data Transfer

Select one or more data transfers in the Outline view. Right-click and select Suppress to prevent the data transfer.

Delete Data Transfer

Select one or more data transfers in the Outline view. Right-click and select Delete to remove them.


Note:  If the data transfer definition is not valid or the data is invalidated for any reason, the state of the node will show as a ? and the incorrect properties will need to be changed.



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