MPI自定义数据类型

自定义数据类型

1.数据类型辅助函数

• MPI_Type_commit

int MPI_Type_commit(
  MPI_Datatype *datatype
);

在通信中使用数据类型对象之前，必须提交数据类型对象。提交的数据类型仍可用作数据类型构造函数中的参数。无需提交基本数据类型。它们是"预先承诺的"。

• MPI_Type_free

int MPI_Type_free(
  MPI_Datatype *datatype
);

标记与处理数据的数据类型关联的数据类型对象，并将数据类型设置到MPI_DATATYPE_NULL。当前使用此数据类型的任何通信都将正常完成。从释放的数据类型定义的派生数据类型不受影响。

• MPI_Type_extent（已弃用，由替换MPI_Type_get_extent）

int MPI_Type_extent(
  MPI_Datatype datatype,
  MPI_Aint *extent
);

此例程既具有线程安全，也具有中断安全。这意味着此例程可能安全地由多个线程使用，也可以在信号处理程序中使用。

• MPI_Address

int MPI_Address(
  void *location,
  MPI_Aint *address
);

获取内存中的某位置的地址，返回指定变量内存中的“绝对”地址。

2.Contiguous数据类型

• MPI_Type_contiguous

int MPI_Type_contiguous(
  int count,
  MPI_Datatype old_type,
  MPI_Datatype *new_type_p
);

连续复制：将原数据类型oldtype按顺序依次连续复制后，得到一个新的数据类型。比如定义连续的2个实数为一个新的数据类型。

 MPI_Type_contiguous( 2, MPI_CHAR, &type );

3.Vector数据类型

• MPI_Type_vector

int MPI_Type_vector(
  int count,
  int blocklength,
  int stride,
  MPI_Datatype old_type,
  MPI_Datatype *newtype_p
);

创建向量（步幅）数据类型。先连续复制blocklength个oldtype类型的数据，形成一个数据块；再通过等间隔的复制count个该数据块形成新的数据类型；相邻两个数据的的起始位置的位移相差stride乘extent(oldtype)个字节。
例如有oldtype数据
1，2，3，4，5，6，7，8
现在要求新的数据类型3个，每连续2个作为一个新的数据类型，间隔为1.

MPI_Type_vector(3,2,1,old,new)

• MPI_Type_hvector

int MPI_Type_hvector(
  int count,
  int blocklen,
  MPI_Aint stride,
  MPI_Datatype old_type,
  MPI_Datatype *newtype_p
);

功能同MPI_Type_vector相同，唯一区别就是stride的单位是字节。

4.Index数据类型

• MPI_Type_indexed

int MPI_Type_indexed(
  int count,
  int blocklens[],
  int indices[],//位移，和首地址的位移
  MPI_Datatype old_type,
  MPI_Datatype *newtype
);

创建索引数据类型：该函数生成的新数据类型有count个数据块构成，第i个数据块包含blocklens[i]个连续存放的oldtype,第i个数据块与首地址的偏移量（字节数）为indices[i]乘extent(oldtype)。
可以看作是MPI_Type_vector的扩展，区别是买个数据块的长度可以不同，数据块之间的间隔也可以不同。

• MPI_Type_hindexed

int MPI_Type_hindexed(
  int count,
  int blocklens[],
  MPI_Aint indices[],
  MPI_Datatype old_type,
  MPI_Datatype *newtype
);

功能同MPI_Type_vector相同，唯一区别就是indices数组存放的数据单位是字节。

• MPI_Type_struct

int MPI_Type_struct(
  int count,
  int blocklens[],
  MPI_Aint indices[],
  MPI_Datatype old_types[],
  MPI_Datatype *newtype
);

创建结构数据类型：与MPI_Type_indexed的区别在于每个数据块的数据类型可以不同，这里的indices数组存访的单位是字节。
该函数时最一般的新数据类型的构造函数，也是最广泛的一个。

MPI的数据打包与拆包

打包(Pack)和解包(Unpack)操作是为了发送不连续的数据， 在发送前显示地把数据包装大一个连续的缓冲区， 在接收之后从连续的缓冲区中解包。

• MPI_Pack

int MPI_Pack(
  void *inbuf,
  int incount,
  MPI_Datatype datatype,
  void *outbuf,
  int outcount,
  int *position,
  MPI_Comm comm
);

MPI_PACK把由inbuf,incount, datatype指定的发送缓冲区中的incount个datatype类型的消息放到起始为 outbuf 的连续空间，该空间共有 outcount 个字节。 输入缓冲区可以是 MPI_Send 允许的任何通信缓冲区。入口参数 position 的值是输出缓冲区中用于打包的起始地址，打包后它的值根据打包消息的大小来增加，出口参数 position 的值是被打包的消息占用的输出缓冲区后面的第一个地址。通过连续几次对不同位置的消息调用打包操作， 就将不连续的消息放到了一个连续的空间。comm参数是将在后面用于发送打包的消息时用的通信域。 (NOTE:这里要连续多次调用打包操作)

• MPI_Unpack

int MPI_Unpack(
  void *inbuf,
  int insize,
  int *position,
  void *outbuf,
  int outcount,
  MPI_Datatype datatype,
  MPI_Comm comm
);

MPI_UNPACK 和 MPI_PACK 对应， 它从 inbuf 和 insize 指定的缓冲区空间将不连续的消息解开，放到 outbuf, outcount, datatype 指定的缓冲区中。 输出缓冲区可以是 MPI_RECV 允许的任何通信缓冲区。 输入缓冲区是一个连续的存储空间，大小为insize字节， 开始地址为 inbuf。入口参数 position的初始值是输出缓冲区中被打包消息占用的起始地址， 解包后它的值根据打包消息的大小来增加，因此出口参数 position的值是输出缓冲区中被解包的消息占用空间后面的第一个地址。 通过连续几次对已打包的消息调用与打包时相应的解包操作，就可以将连续的消息解开放到一个不连续的空间。comm参数是用于接收消息的通信域。

• MPI_Pack_size

int MPI_Pack_size(
  int incount,
  MPI_Datatype datatype,
  MPI_Comm comm,
  int *size
);

描述MPI_Pack和MPI_Unpack的最大值。