Skip to main content

System Coupling Participant library 2026 R1

Class sysc::Datashipper

Last update: 09.03.2026

Definition: Datashipper.hpp (line 54)

Provide a class for the data shipper.

Data-shipping is a form of data distribution architecture where data objects are retrieved from the server, and are cached and operated upon at the client nodes. This architecture reduces network latency and increases resource utilization at the client.

The fundamental concepts here are as follows:

Server space is where the data is ordered. This data is roughly evenly distributed among processes.

Client space is where the data is arbitrarily distributed between processes.

Collection is the operation that transfers data from client space to server space.

Distribution is the operation that transfer data from server space to client space.

See System Coupling Participant library developer documentation for examples.

Members

Private attributes

Variable m_ds

Definition: Datashipper.hpp (line 222)

std::unique_ptr<DatashipperHandler, std::function<void(DatashipperHandler*)> > sysc::Datashipper::m_ds

Type: std::unique_ptr< DatashipperHandler, std::function< void(DatashipperHandler *)> >

Public functions

Function Datashipper

sysc::Datashipper::Datashipper()=delete

No default constructor.

Return type:

Referenced by:

Function Datashipper

sysc::Datashipper::Datashipper(const Datashipper &)=delete

No copy constructor.

Parameters:

Return type:

References:

Function Datashipper

sysc::Datashipper::Datashipper(Datashipper &&)=default

Move constructor.

Parameters:

Return type:

References:

Function operator=

Datashipper & sysc::Datashipper::operator=(const Datashipper &)=delete

No copy assignment.

Parameters:

Return type: Datashipper &

References:

Function operator=

Datashipper & sysc::Datashipper::operator=(Datashipper &&)=default

Move assignment.

Parameters:

Return type: Datashipper &

References:

Function Datashipper

sysc::Datashipper::Datashipper(std::size_t globalSize, OutputIntegerData indexMap)

Provide a constructor for the DataTransfer class.

Parameters:

  • globalSize: - Global size of all elements across all ranks.
  • indexMap: - Index map is an array, where the actual array indices are indices in the client space, and values are indices in the server space. The local size of index map is equal to the local size of client space array. For example, if indexMap[7] = 56, that means local rank has a client-space array and it has an entry in 7th (local) spot which corresponds to entry in the 56th (global) server-side array.

Parameters:

Return type:

Function collect

void sysc::Datashipper::collect(OutputIntegerData distributed, InputIntegerData collected)

Collect integer data.

Parameters:

  • distributed: - client-space array.
  • collected: - server-space array.

Parameters:

Return type: void

Function collect

void sysc::Datashipper::collect(OutputIntegerData distributed, InputIntegerData collected, std::uint16_t numComponents)

Collect integer data.

Parameters:

  • distributed: - client-space array.
  • collected: - server-space array.
  • numComponents: - number of components per element.

Parameters:

Return type: void

Function collect

void sysc::Datashipper::collect(OutputScalarData distributed, InputScalarData collected)

Collect scalar data.

Parameters:

  • distributed: - client-space array.
  • collected: - server-space array.

Parameters:

Return type: void

Function collect

void sysc::Datashipper::collect(OutputVectorData distributed, InputVectorData collected)

Collect vector data.

Parameters:

  • distributed: - client-space array.
  • collected: - server-space array.

Parameters:

Return type: void

Function collect

void sysc::Datashipper::collect(NodeData distributed, InputNodeData collected)

Collect node data.

Parameters:

  • distributed: - client-space array.
  • collected: - server-space array.

Parameters:

Return type: void

Function collect

void sysc::Datashipper::collect(FaceData distributed, InputFaceData collected)

Collect face data.

Parameters:

  • distributed: - client-space array.
  • collected: - server-space array.

Parameters:

Return type: void

Function collect

void sysc::Datashipper::collect(CellData distributed, InputCellData collected)

Collect cell data.

Parameters:

  • distributed: - client-space array.
  • collected: - server-space array.

Parameters:

Return type: void

Function collect

void sysc::Datashipper::collect(PointCloud distributed, InputPointCloud collected)

Collect point cloud.

Parameters:

  • distributed: - client-space array.
  • collected: - server-space array.

Parameters:

Return type: void

Function distribute

void sysc::Datashipper::distribute(OutputIntegerData collected, InputIntegerData distributed)

Distribute integer data.

Parameters:

  • collected: - server-space array.
  • distributed: - client-space array.

Parameters:

Return type: void

Function distribute

void sysc::Datashipper::distribute(OutputIntegerData collected, InputIntegerData distributed, std::uint16_t numComponents)

Distribute integer data.

Parameters:

  • collected: - server-space array.
  • distributed: - client-space array.
  • numComponents: - number of components per element.

Parameters:

Return type: void

Function distribute

void sysc::Datashipper::distribute(OutputScalarData collected, InputScalarData distributed)

Distribute scalar data.

Parameters:

  • collected: - server-space array.
  • distributed: - client-space array.

Parameters:

Return type: void

Function distribute

void sysc::Datashipper::distribute(OutputVectorData collected, InputVectorData distributed)

Distribute vector data.

Parameters:

  • collected: - server-space array.
  • distributed: - client-space array.

Parameters:

Return type: void

Function distribute

void sysc::Datashipper::distribute(NodeData collected, InputNodeData distributed)

Distribute node data.

Parameters:

  • collected: - server-space array.
  • distributed: - client-space array.

Parameters:

Return type: void

Function distribute

void sysc::Datashipper::distribute(FaceData collected, InputFaceData distributed)

Distribute face data.

Parameters:

  • collected: - server-space array.
  • distributed: - client-space array.

Parameters:

Return type: void

Function distribute

void sysc::Datashipper::distribute(CellData collected, InputCellData distributed)

Distribute cell data.

Parameters:

  • collected: - server-space array.
  • distributed: - client-space array.

Parameters:

Return type: void

Function distribute

void sysc::Datashipper::distribute(PointCloud collected, InputPointCloud distributed)

Distribute point cloud data.

Parameters:

  • collected: - server-space array.
  • distributed: - client-space array.

Parameters:

Return type: void

Connect with Ansys