cuquantum.bindings.cudensitymat.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 dimension). 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.