Adding a Data Transfer

Each coupling interface must have at least one data transfer. When one or more data transfers are created, the Data Transfer container object becomes available in the data model, with the data transfer object(s) defined beneath it. When adding a data transfer, you must specify the interface where the transfer is to be added, the target side for the transfer, and the variables to be associated with each side of the interface.

Data transfer names must be unique within an interface. When data transfers are added to an interface, they are assigned default names according to the convention <TargetVariableDisplayName>-<#>, where:

"<TargetVariableName>" is the display name for the target variable, as defined by System Coupling
"#" indicates the order in which the data transfers with the same target variable are created on the interface.

For each data transfer object and the variables defined on the sides of the associated interface, display names (when available) are used and are shown in System Coupling's GUI, Transcript/Log files, and EnSight-formatted results.

You may add data transfers to a coupling interface individually. If you are using the System Coupling GUI, you may also add groups of related data transfers at the same time. For more information, see:

Note:

  • The same rules apply to the creation of data transfers in both the GUI and the CLI. For more information, see Rules for Adding Data Transfers.

  • For a given type of coupled analysis, only the data transfer settings relevant to that type of analysis are shown.

  • Not constructing a data transfer for an input variable or parameter could represent a setup issue. A warning is shown if input variables or parameters are not included in a data transfer.

Tip:  Data transfer settings can be adjusted to stabilize the solution and address convergence issues. For information on stabilization methods that can be applied at the data-transfer level, see:

For information on convergence criteria, see Evaluating Convergence of Data Transfers.

 

Adding a Single Data Transfer

When adding a single data transfer, you must specify the interface on which the transfer is to be added, the target side for the transfer, and the variables to be associated with each side of the interface.

For instructions on adding a single data transfer, see:

 
Adding a Single Data Transfer in the GUI

To add a data transfer in the System Coupling GUI, perform the following steps:

  1. In the Outline tree under Coupling Interface, locate the coupling interface object on which the data transfer is to be created.

  2. Right-click the interface object and select Add Data Transfer.

    The data transfer object is added to the data model under the Data Transfer object container.

  3. Click the data transfer object to review its settings and change, if necessary.

    The following data transfer settings are shown in the Properties pane, with values populated from the participant setup files:

    • Suppress: Allows this data transfer to be deactivated without deleting it permanently.

    • Target Side: Specifies the interface side that will receive the transferred data. Possible values are One and Two. Default value is One. The display name of the associated coupling participant is added to the object label.

    • Source Variable: Automatically populated with the variable for the participant associated with the source side of the interface.

    • Target Variable: Automatically populated with the variable for the participant associated with the target side of the interface.

    • Ramping Option: Specifies the ramping option to be applied. Default value is None.

    • Relaxation Factor: Specifies the relaxation factor to be applied if ramping is used. Default value is 1.

    • Convergence Target: Specifies the convergence target for the data transfer. Default value is 0.01.

  4. Under the data transfer object, click Stabilization to review solution stabilization settings and to change if needed.

 
Adding a Single Data Transfer in the CLI

To add a data transfer in the System Coupling CLI, run the AddDataTransfer() command. This command allows you to use internal object names to specify data transfer details: the interface, the target side of the transfer, and variables to be associated with each side of the interface To add a two-way data transfer on an interface, you must run the command twice, once for each direction.

When specifying regions, use the SourceVariable/TargetVariable arguments to indicate the variable names on each side of the interface.

To add a data transfer, run the command as shown in the example below:

Example 16: Add a data transfer using internal variable names


 >>> AddDataTransfer(Interface = 'Interface-1',
	TargetSide = 'Two',
	SourceVariable = 'Loss',
	TargetVariable = 'HGEN')

When the command is run, the data transfer object is added to the data model under the DataTransfer object container.

 

Adding a Data Transfer Group in the GUI

When working in the System Coupling GUI, you can add a group of related data transfers on a coupling interface. Availability of options for transfer group creation depends on the data transfers available for the specified interface.

To add a group of data transfers in the System Coupling GUI, perform the following steps:

  1. In the Outline under Coupling Interface, locate the coupling interface object on which the data transfers are to be created.

  2. Right-click the interface object and select one of the following options.

    • Add FSI Data Transfers: Available for Adds Force and Incremental Displacement transfers.

    • Add Thermal Data Transfers: Adds non-surface-to-surface Temperature and Heat Rate transfers.

    • Add Thermal Data Transfers (Heat Rate): Adds surface-to-surface Temperature and Heat Rate transfers.

      If both participants can be source and target for both Temperature and Heat Rate, then System Coupling will send Heat Rate to Mechanical and Temperature from Mechanical (if available). Otherwise, the decision is arbitrary.

    • Add Thermal Data Transfers (Heat Transfer Coefficient): Adds surface-to-surface Temperature and Heat Transfer Coefficient/Convection Reference Temperature transfers.

    • Add Aerodamping Data Transfers: Adds mode shape transfers for each selected mode shape.

    The relevant data transfer objects are added to the data model under the Data Transfer object container.

  3. Click each data transfer object to review its settings and change them, if necessary.

    Data transfer settings relevant to the type of analysis are shown in the Properties pane, with values populated from the participant setup files.

    • Suppress: Allows this data transfer to be deactivated without deleting it permanently.

    • Target Side: Specifies the interface side that will receive the transferred data. Possible values are One and Two. Default value is One.

    • Source Variable: Automatically populated with an output variable for the participant associated with the interface source side.

    • Target Variable: Automatically populated with an input variable for the participant associated with the interface target side.

    • Ramping Option: Specifies the ramping option to be applied. Default value is None.

    • Relaxation Factor: Specifies the relaxation factor to be applied if ramping is used. Default value is 1.

    • Convergence Target: Specifies the convergence target for the data transfer. Default value is 0.01.

  4. Under the data transfer object, click Stabilization to review solution stabilization settings and to change them if needed.