Recording Experimental Results¶
Circuits are provided as Circuit objects.
A circuit object contains a Results object into which
experimental results should be input once the circuit is performed (or simulated). This
results object is a thin wrapper for a dictionary class and is initially empty.
Once data have been collected, results contain a mapping between bitstrings and the
number of shots that resulted in that bitstring. A results object also contains
attributes such as the timestamp of when the results were last modified, the dimension of
the system, the total number of measurements (i.e. the length of the bitstrings), and the
total number of shots.
Note
The Results object supports ditstrings in general,
however this document only talks about bitstrings for brevity.
Bitstrings that were not observed should not be entered.
For instance, if a 2-qubit device performs 50 shots of a given circuit object,
then circuit.results might have the value
circuit.results
>>> Results({'00': 47, '01': 2, '10': 1})
In this example, the qubits were measured as being in the \(|00\rangle\) state 47 times, in the \(|01\rangle\) state two times, and in the \(|10\rangle\) state once.
Note
Each bitstring must have a length equal to n_sys.
The order of bitstrings coincides with meas_locs, which is
a list of tuples (cycle_idx, qubit_idx).
Setting Results¶
Results can be entered simply by setting the results property
to a new dictionary, which will automatically convert to a
Results object, or by updating the existing dictionary using
unary addition with a compatible results-like object (refer to this
example).