operator_action_compute#

cuquantum.bindings.cudensitymat.operator_action_compute(
intptr_t handle,
intptr_t operator_action,
double time,
int64_t batch_size,
int32_t num_params,
intptr_t params,
state_in,
intptr_t state_out,
intptr_t workspace,
intptr_t stream,
)[source]#

Executes the action of one or more operators constituting the aggreggate operator(s) action on the same number of input quantum states, accumulating the results into a single output quantum state.

Parameters:
  • handle (intptr_t) – Library handle.

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

  • time (double) – Time value.

  • batch_size (int64_t) – Batch size (>=1).

  • num_params (int32_t) – Number of variable parameters defined by the user.

  • params (intptr_t) – GPU-accessible pointer to an F-order 2d-array of user-defined real parameter values: params[num_params, batch_size].

  • state_in (object) –

    Input quantum state(s). Each input quantum state can be a batch of quantum states, in general. 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 which accumulates operator action(s) on all input quantum state(s).

  • workspace (intptr_t) – Allocated workspace descriptor.

  • stream (intptr_t) – CUDA stream.