Note

This is the documentation for the current state of the development branch of Qiskit Experiments. The documentation or APIs here can change prior to being released.

MockIQParallelExperimentHelper.iq_clusters

MockIQParallelExperimentHelper.iq_clusters(circuits)

Returns circuit-specific IQ cluster centers and widths in the IQ plane.

Subclasses can override this function to modify the centers and widths of IQ clusters based on the circuits being simulated by a MockIQBackend. The base centers and widths are stored internally within the helper object, and can be set in __init__() or by modifying attr:iq_cluster_centers and attr:iq_cluster_width. The default behaviour for iq_clusters() is to return the centers and widths unmodified for each circuit in circuits. Subclasses may return different centers and widths based on the circuits provided.

The returned list contains a tuple per circuit. Each tuple contains the IQ centers and widths in the same format as attr:iq_cluster_centers and attr:iq_cluster_width, passed as arguments to __init__(). The format of the centers and widths lists, in the argument list and in the returned tuples, must match the format of iq_cluster_centers and iq_cluster_width in qiskit_experiments.test.MockIQExperimentHelper.__init__().

Parameters:

circuits (List[QuantumCircuit]) – The quantum circuits for which the clusters should be modified.

Returns:

A list of tuples containing the circuit-specific IQ centers and widths for the

provided circuits.

Return type:

List