state_projection_mps_insert_tensor#

cuquantum.bindings.cutensornet.state_projection_mps_insert_tensor( intptr_t handle, intptr_t tensor_network_projection, intptr_t env_spec, intptr_t ortho_spec, strides, intptr_t env_tensor_data, intptr_t work_desc, intptr_t cuda_stream, )[source]#

Inserts the MPS representation tensor for the specified contiguous 0-, 1-, or 2-site subset of sites.

Parameters:

handle (intptr_t) – cuTensorNet library handle.
tensor_network_projection (intptr_t) – Tensor network state MPS projection.
env_spec (intptr_t) – Specification of environment.
ortho_spec (intptr_t) – Specification of the orthogonality condition of the MPS after insertion. For insertion of a 1-site environment, this argument is currently required to be identical to env_spec. For insertion of a 0-site environment, the orthogonality center must be a 1-site region adjacent to the bond. For insertion of a 2-site environment, the orthogonality center must be one of the two 1-site sub-regions of env_spec (left or right site).
strides (object) –
Strides of the externally provided MPS representation tensor for the specified environment. A nullptr for this argument will use default (column-major) strides. It can be:
- an int as the pointer address to the array, or
- a Python sequence of int64_t.
env_tensor_data (intptr_t) – Externally provided MPS representation tensor for the specified environment. For 2-site environments, this tensor is decomposed via SVD according to the configured cutoffs, normalization, algorithm, and CUTENSORNET_STATE_PROJECTION_MPS_CONFIG_SVD_MAX_EXTENT cap (see cutensornetStateProjectionMPSAttributes_t), which may shrink the shared bond extent of the affected sites. The new extents become observable via cutensornetStateProjectionMPSGetTensorInfo and govern the shape of subsequently extracted region tensors and computed environments.
work_desc (intptr_t) – Allocated workspace descriptor.
cuda_stream (intptr_t) – CUDA stream.