SimulationResults

class pulser_simulation.simresults.SimulationResults(size, basis_name, sim_times)

Bases: ABC, ResultsSequence[ResultType]

Results of a simulation run of a pulse sequence.

Parent class for NoisyResults and CoherentResults. Contains methods for studying the states and extracting useful information from them.

Attributes

states

Lists states of the system at simulation times.

Methods

count
expect	Returns the expectation values of operators in obs_list.
get_final_state	Returns the final state of the system.
get_state	Returns the state of the system at time t.
index	Raises ValueError if the value is not present.
plot	Plots the expectation value of a given operator op.
sample_final_state	Returns the result of multiple measurements of the final state.
sample_state	Returns the result of multiple measurements at time t.

Signatures

count(value) → integer -- return number of occurrences of value

expect(obs_list)

Returns the expectation values of operators in obs_list.

Parameters:

obs_list (Sequence[Qobj | ArrayLike]) – Input observable list. ArrayLike objects will be converted to qutip.Qobj.

Return type:

list[float | complex | ArrayLike]

Returns:

Expectation values of obs_list.

abstract get_final_state()

Returns the final state of the system.

Return type:

Qobj

abstract get_state(t)

Returns the state of the system at time t.

Return type:

Qobj

index(value[, start[, stop]]) → integer -- return first index of value.

Raises ValueError if the value is not present.

Supporting start and stop arguments is optional, but recommended.

plot(op, fmt='', label='')

Plots the expectation value of a given operator op.

Parameters:

• op (Qobj) – Operator whose expectation value is wanted.

• fmt (str, default: '') – Curve plot format.

• label (str, default: '') – Curve label.

Return type:

None

sample_final_state(N_samples=1000)

Returns the result of multiple measurements of the final state.

Parameters:

N_samples (int, default: 1000) – Number of samples to return.

Return type:

Counter

Returns:

Sample distribution of bitstrings corresponding to measured quantum states at the end of the simulation.

sample_state(t, n_samples=1000, t_tol=0.001)

Returns the result of multiple measurements at time t.

Parameters:

• t (float) – Time at which the state is sampled (in µs).

• n_samples (int, default: 1000) – Number of samples to return.

• t_tol (float, default: 0.001) – Tolerance for the difference between t and closest time.

Return type:

Counter

Returns:

Sample distribution of bitstrings corresponding to measured quantum states at time t.

abstract property states: list[Qobj]

Lists states of the system at simulation times.