cuquantum.custatevec.collapse_by_bit_string_batched

cuquantum.custatevec.collapse_by_bit_string_batched(intptr_t handle, intptr_t batched_sv, int sv_data_type, uint32_t n_index_bits, uint32_t n_svs, int64_t sv_stride, bit_strings, bit_ordering, uint32_t bit_string_len, norms, intptr_t extra_workspace, size_t extra_workspace_size_in_bytes)[source]

将批量状态向量坍缩到给定比特字符串指定的状态。

参数
  • handle (intptr_t) – cuStateVec 库的句柄。

  • batched_sv (intptr_t) – 在设备上连续内存块中分配的批量状态向量。

  • sv_data_type (int) – 状态向量的数据类型。

  • n_index_bits (uint32_t) – 状态向量的索引比特数。

  • n_svs (uint32_t) – 批量状态向量的数量。

  • sv_stride (int64_t) – 两个连续状态向量的距离。

  • bit_strings (object) –

    指向比特字符串数组的指针,可以在主机或设备上。它可以是

    • 作为数组指针地址的 int,或者

    • custatevecIndex_t 的 Python 序列。

  • bit_ordering (object) –

    指向主机比特字符串顺序数组的指针。它可以是

    • 作为数组指针地址的 int,或者

    • int32_t 的 Python 序列。

  • bit_string_len (uint32_t) – 比特字符串的长度。

  • norms (object) –

    指向主机或设备上归一化常数数组的指针。它可以是

    • 作为数组指针地址的 int,或者

    • double 的 Python 序列。

  • extra_workspace (intptr_t) – 额外工作空间。

  • extra_workspace_size_in_bytes (size_t) – 额外工作空间的大小。