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
- collect
- collect
- collect
- collect
- collect
- collect
- collect
- collect
- Datashipper
- Datashipper
- Datashipper
- Datashipper
- distribute
- distribute
- distribute
- distribute
- distribute
- distribute
- distribute
- distribute
- m_ds
- operator=
- operator=
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:
- const Datashipper &
Return type:
References:
Function Datashipper
sysc::Datashipper::Datashipper(Datashipper &&)=default
Move constructor.
Parameters:
- Datashipper &&
Return type:
References:
Function operator=
Datashipper & sysc::Datashipper::operator=(const Datashipper &)=delete
No copy assignment.
Parameters:
- const Datashipper &
Return type: Datashipper &
References:
Function operator=
Datashipper & sysc::Datashipper::operator=(Datashipper &&)=default
Move assignment.
Parameters:
- Datashipper &&
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:
- std::size_t globalSize
- OutputIntegerData indexMap
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:
- OutputIntegerData distributed
- InputIntegerData collected
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:
- OutputIntegerData distributed
- InputIntegerData collected
- std::uint16_t numComponents
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:
- OutputScalarData distributed
- InputScalarData collected
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:
- OutputVectorData distributed
- InputVectorData collected
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:
- NodeData distributed
- InputNodeData collected
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:
- FaceData distributed
- InputFaceData collected
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:
- CellData distributed
- InputCellData collected
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:
- PointCloud distributed
- InputPointCloud collected
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:
- OutputIntegerData collected
- InputIntegerData distributed
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:
- OutputIntegerData collected
- InputIntegerData distributed
- std::uint16_t numComponents
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:
- OutputScalarData collected
- InputScalarData distributed
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:
- OutputVectorData collected
- InputVectorData distributed
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:
- NodeData collected
- InputNodeData distributed
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:
- FaceData collected
- InputFaceData distributed
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:
- CellData collected
- InputCellData distributed
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:
- PointCloud collected
- InputPointCloud distributed
Return type: void