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.

T1

class T1(physical_qubits, delays, backend=None)

An experiment to measure the qubit relaxation time.

Overview

This experiment estimates the $T_1$ relaxation time of the qubit by generating a series of circuits that excite the qubit then wait for different intervals before measurement. The resulting data of excited population versus wait time is fitted to an exponential curve to obtain an estimate for $T_1$.

User manual

T1 Characterization

Analysis class reference

T1Analysis

Experiment options

These options can be set by the set_experiment_options() method.

Options

• Defined in the class T1:

  • delays (Iterable[float])

    Default value: None

    Delay times of the experiments in seconds.

• Defined in the class BaseExperiment:

  • max_circuits (Optional[int])

    Default value: None

    The maximum number of circuits per job when running an experiment on a backend.

Initialization

Initialize the T1 experiment class.

Parameters:

• physical_qubits (Sequence[int]) – a single-element sequence containing the qubit whose T1 is to be estimated.

• delays (Union[List[float], array]) – Delay times of the experiments in seconds.

• backend (Optional[Backend]) – Optional, the backend to run the experiment on.

Raises:

ValueError – If the number of delays is smaller than 3

Attributes

T1.analysis	Return the analysis instance for the experiment
T1.backend	Return the backend for the experiment
T1.experiment_options	Return the options for the experiment.
T1.experiment_type	Return experiment type.
T1.num_qubits	Return the number of qubits for the experiment.
T1.physical_qubits	Return the device qubits for the experiment.
T1.run_options	Return options values for the experiment run() method.
T1.transpile_options	Return the transpiler options for the run() method.

Methods

T1.circuits()	Return a list of experiment circuits
T1.config()	Return the config dataclass for this experiment
T1.copy()	Return a copy of the experiment
T1.from_config(config)	Initialize an experiment from experiment config
T1.run([backend, analysis, timeout])	Run an experiment and perform analysis.
T1.set_experiment_options(**fields)	Set the experiment options.
T1.set_run_options(**fields)	Set options values for the experiment run() method.
T1.set_transpile_options(**fields)	Set the transpiler options for run() method.