cuquantum.bindings.cudensitymat.create_elementary_operator

cuquantum.bindings.cudensitymat.create_elementary_operator(intptr_t handle, int32_t num_space_modes, space_mode_extents, int sparsity, int32_t num_diagonals, diagonal_offsets, int data_type, intptr_t tensor_data, tensor_callback) → intptr_t[源代码]

创建一个作用于给定数量量子态模式（又称空间模式）的基本张量算符。

参数

  • handle (intptr_t) – 库句柄。

  • num_space_modes (int32_t) – 作用的（状态）空间模式的数量。

  • space_mode_extents (object) –

    作用的（状态）空间模式的范围。它可以是

    • 指向数组的指针地址的 int，或者

    • int64_t 的 Python 序列。

  • sparsity (ElementaryOperatorSparsity) – 张量算符稀疏性，定义存储方案。

  • num_diagonals (int32_t) – 对于多对角张量算符矩阵，指定非零对角线的总数。

  • diagonal_offsets (object) –

    非零对角线的偏移量（例如，主对角线的偏移量为 0，主对角线上方对角线的偏移量为 +1，主对角线下方对角线的偏移量为 -1，依此类推）。它可以是

    • 指向数组的指针地址的 int，或者

    • int32_t 的 Python 序列。

  • data_type (int) – 张量算符数据类型。

  • tensor_data (intptr_t) – GPU 可访问的指针，指向张量算符元素存储。

  • tensor_callback (object) – 可选的用户定义的张量回调函数，稍后可以调用该函数以填充提供的存储中的张量元素，或者为 NULL。

返回

基本张量算符。

返回类型

intptr_t

参见

cudensitymatCreateElementaryOperator()