Co-Simulation Component

 

Description

The Co-Simulation component transmits and receives data between PSCAD and an external application. The actual data exchange is performed by utilizing the PSCAD inter-application communications control architecture, called Communication Fabric (ComFab).

 

This component may be set to receive data at a sampling rate, if the external application time step is not consistent with that of EMTDC. Linear interpolation is not supported. Default data must be provided for the first time step. After which, data is sent and received through the co-simulation.

 

More:

Co-Simulation API

Communication Fabric (ComFab)

Input Parameters

ConfigurationConfiguration

See Co-Simulation API for more details on some of these parameters.

 

 Name

 

Text

 

Optional text parameter for identification of the component.

         

 Display Name

 

Choice

 

Select Show or Hide.

 

Selecting Show will display the component Name.

         

Client ID

 

INTEGER

Literal

Enter a number between 40,000 and 60, 000.

 

This number is used to identify the client application, to which this component will connect. When generating a configuration file to help connect the external application, the file name generated will be based on this number. Example: $(WorkspaceTempDir)\cosim_#####.cfg.

         

Channel ID

 

INTEGER

Literal

This number specifies the internal channel of the external application, to which communication is established.

 

The external application may require multiple sets of completely independent. Multiple channels may be created to keep this data separated.

 

Enter 1 if there is only a single, internal channel.

         

Sending Data Dimension

 

INTEGER

Literal

Enter the dimension of the array of data values being sent to the external application. Enter 1 for a scalar.

         

Receiving Data Dimension

 

INTEGER

Literal

Enter the dimension of the array of data values being received from the external application. Enter 1 for a scalar.

         

Sending Frequency

 

INTEGER

Literal

Essentially the sample rate. Enter 1 unless there is a large and consistent discrepancy between the application time steps.

 

If there is a large discrepancy between the EMTDC time step and the external application time step, then adjust this parameter to optimise the communication.

 

 

Default DataDefault Data

 

 Default Data Source

 

Choice

 

Select Use Port or Use Data.

 

If Use Port is selected, the component will provide a port connection of the same size as the receiving port. The extra port is only used on the first time step to define the default data that the receiving port will use.

 

If Use Data is selected, an array of the value provided in the Default Value parameter is provided to the receive port on the first time step.

         

 Default Value

 

REAL

Literal

The value to receive on the first time step. This parameter is enabled only if Default Data Source | Use Data is selected.