cuquantum.custatevec.measure_batched

cuquantum.custatevec.measure_batched(intptr_t handle, intptr_t batched_svs, int sv_data_type, uint32_t n_index_bits, uint32_t n_svs, int64_t sv_stride, intptr_t bit_strings, bit_ordering, uint32_t bit_string_len, rand_nums, int collapse)[source]

Performs measurement of a batched of statevectors.

Parameters
  • handle (intptr_t) – The library handle.

  • batched_svs (intptr_t) – The pointer address (as Python int) to the batched statevectors (on device).

  • sv_data_type (cuquantum.cudaDataType) – The data type of the statevector.

  • n_index_bits (uint32_t) – The number of index bits.

  • n_svs (uint32_t) – The number of batched statevectors.

  • sv_stride (int64_t) – The stride between each state vector in the batch.

  • bit_strings (intptr_t) – The pointer address (as Python int) to a host or device array of measured bit strings.

  • bit_ordering

    A host array of bit string ordering. It can be

    • an int as the pointer address to the array

    • a Python sequence of bit ordering

  • bit_string_len (uint32_t) – The length of bit_string.

  • rand_nums (double) –

    An array of random numbers in [0, 1). It can be

    • an int as the pointer address to the array (on host or device)

    • a Python sequence of random numbers

  • collapse (Collapse) – Indicate the collapse operation.