cuquantum.cutensornet.create_marginal¶

cuquantum.cutensornet.create_marginal(intptr_t handle, intptr_t state, int32_t n_marginal_modes, marginal_modes, int32_t n_projected_modes, projected_modes, marginal_tensor_strides) → intptr_t[source]¶

Create a representation for the tensor network state marginal distribution.

Parameters

handle (intptr_t) – The library handle.
state (intptr_t) – The tensor network state.
n_marginal_modes (int32_t) – The number of modes for the marginal.
marginal_modes –
A host array of modes for the marginal. It can be
- an int as the pointer address to the array
- a Python sequence of int
n_projected_modes (int32_t) – The number of modes that are projected out for the marginal.
projected_modes –
A host array of projected modes for the marginal. It can be
- an int as the pointer address to the array
- a Python sequence of int
marginal_tensor_strides –
A host array of strides for the marginal modes. It can be
- an int as the pointer address to the array
- a Python sequence of int

Returns

An opaque tensor network state marginal handle (as Python int).

Return type

intptr_t