operator_action_prepare#

cuquantum.bindings.cudensitymat.operator_action_prepare(
intptr_t handle,
intptr_t operator_action,
state_in,
intptr_t state_out,
int compute_type,
size_t workspace_size_limit,
intptr_t workspace,
intptr_t stream,
)[source]#

Prepares the (aggregate) operator(s) action for computation.

Parameters:

  • handle (intptr_t) – Library handle.

  • operator_action (intptr_t) – Operator(s) action specification.

  • state_in (object) –

    Input quantum state(s) for all operator(s) defining the current Operator Action. Each input quantum state can be a batch of quantum states itself (with the same batch size). It can be:

    • an int as the pointer address to the array, or

    • a Python sequence of ints (as pointer addresses).

  • state_out (intptr_t) – Updated output quantum state (or a batch) which accumulates the (aggregate) operator(s) action on all input quantum state(s).

  • compute_type (ComputeType) – Desired compute type.

  • workspace_size_limit (size_t) – Workspace buffer size limit (bytes).

  • workspace (intptr_t) – Empty workspace descriptor on entrance. The workspace size required for the computation will be set on exit.

  • stream (intptr_t) – CUDA stream.

See also

cudensitymatOperatorActionPrepare()