qiskit.providers.ibmq.experiment.Experiment

class Experiment(provider, backend_name, experiment_type, extra=None, tags=None, start_datetime=None, end_datetime=None, experiment_uuid=None, plot_names=None, analysis_results=None, hub=None, group=None, project=None, share_level=None, owner=None)

Class representing an experiment.

Experiment constructor.

Parameter

• provider (AccountProvider) – the account provider.

• backend_name (str) – Name of the backend.

• experiment_type (str) – Experiment type.

• extra (Optional[Dict]) – Extra information about the experiment.

• tags (Optional[List[str]]) – Tags for the experiment.

• start_datetime (Optional[datetime]) – Timestamp when the experiment started. If no timezone information is present, local timezone is assumed.

• end_datetime (Optional[datetime]) – Timestamp when the experiment ended. If no timezone information is present, local timezone is assumed.

• experiment_uuid (Optional[str]) – Unique identifier of the experiment.

• plot_names (Optional[List[str]]) – A list of plot names for this experiment.

• analysis_results (Optional[List[AnalysisResult]]) – A list of analysis results associated with this experiment.

• hub (Optional[str]) – The hub to which this experiment belongs. If not specified the hub from the provider is used.

• group (Optional[str]) – The group to which this experiment belongs. If not specified the group from the provider is used.

• project (Optional[str]) – The project to which this experiment belongs. If not specified the project from the provider is used.

• share_level (Union[ExperimentShareLevel, str, None]) –

  The level at which the experiment is shared. This determines who can view the experiment (but not update it). This defaults to „private“ for new experiments. Possible values include:

  • private: The experiment is only visible to its owner (default)

  • project: The experiment is shared within its project

  • group: The experiment is shared within its group

  • hub: The experiment is shared within its hub

  • public: The experiment is shared publicly regardless of provider

• owner (Optional[str]) – The user ID for the owner of the experiment. This is set by the server when the experiment is uploaded and should not be set by a user.

Verursacht

ExperimentError – If the provider does not offer experiment services.

__init__(provider, backend_name, experiment_type, extra=None, tags=None, start_datetime=None, end_datetime=None, experiment_uuid=None, plot_names=None, analysis_results=None, hub=None, group=None, project=None, share_level=None, owner=None)

Experiment constructor.

Parameter

• provider (AccountProvider) – the account provider.

• backend_name (str) – Name of the backend.

• experiment_type (str) – Experiment type.

• extra (Optional[Dict]) – Extra information about the experiment.

• tags (Optional[List[str]]) – Tags for the experiment.

• start_datetime (Optional[datetime]) – Timestamp when the experiment started. If no timezone information is present, local timezone is assumed.

• end_datetime (Optional[datetime]) – Timestamp when the experiment ended. If no timezone information is present, local timezone is assumed.

• experiment_uuid (Optional[str]) – Unique identifier of the experiment.

• plot_names (Optional[List[str]]) – A list of plot names for this experiment.

• analysis_results (Optional[List[AnalysisResult]]) – A list of analysis results associated with this experiment.

• hub (Optional[str]) – The hub to which this experiment belongs. If not specified the hub from the provider is used.

• group (Optional[str]) – The group to which this experiment belongs. If not specified the group from the provider is used.

• project (Optional[str]) – The project to which this experiment belongs. If not specified the project from the provider is used.

• share_level (Union[ExperimentShareLevel, str, None]) –

  The level at which the experiment is shared. This determines who can view the experiment (but not update it). This defaults to „private“ for new experiments. Possible values include:

  • private: The experiment is only visible to its owner (default)

  • project: The experiment is shared within its project

  • group: The experiment is shared within its group

  • hub: The experiment is shared within its hub

  • public: The experiment is shared publicly regardless of provider

• owner (Optional[str]) – The user ID for the owner of the experiment. This is set by the server when the experiment is uploaded and should not be set by a user.

Verursacht

ExperimentError – If the provider does not offer experiment services.

Methods

__init__(provider, backend_name, experiment_type)	Experiment constructor.
from_remote_data(provider, remote_data)	Create an instance of this class from remote data.
refresh()	Update this experiment instance with remote data.
update_from_remote_data(remote_data)	Update the attributes of this instance using remote data.

Attributes

analysis_results	Return analysis results associated with this experiment.
backend_name	Return the experiment’s backend name.
creation_datetime	Return the timestamp when the experiment was created.
end_datetime	Return the timestamp when the experiment ended.
group	Return the experiment’s group.
hub	Return the experiment’s hub.
owner	Return the experiment’s owner.
plot_names	Return names of plots associated with this experiment.
project	Return the experiment’s project.
share_level	Return the experiment share_level.
start_datetime	Return the timestamp when the experiment started.
updated_datetime	Return the timestamp when the experiment was last updated.
uuid	Return the experiment’s uuid.

property analysis_results

Return analysis results associated with this experiment.

Rückgabetyp

List

property backend_name

Return the experiment’s backend name.

Rückgabetyp

str

property creation_datetime

Return the timestamp when the experiment was created.

Rückgabetyp

Optional[datetime]

property end_datetime

Return the timestamp when the experiment ended.

Rückgabetyp

Optional[datetime]

classmethod from_remote_data(provider, remote_data)

Create an instance of this class from remote data.

Parameter

• provider (AccountProvider) – account provider.

• remote_data (Dict) – Remote data to use.

Rückgabetyp

Experiment

Rückgabe

An instance of this class.

property group

Return the experiment’s group.

Rückgabetyp

str

property hub

Return the experiment’s hub.

Rückgabetyp

str

property owner

Return the experiment’s owner.

Rückgabetyp

str

property plot_names

Return names of plots associated with this experiment.

Rückgabetyp

List

property project

Return the experiment’s project.

Rückgabetyp

str

refresh()

Update this experiment instance with remote data.

Rückgabetyp

None

property share_level

Return the experiment share_level.

Rückgabetyp

Optional[ExperimentShareLevel]

property start_datetime

Return the timestamp when the experiment started.

Rückgabetyp

datetime

update_from_remote_data(remote_data)

Update the attributes of this instance using remote data.

Parameter

remote_data (Dict) – Remote data used to update this instance.

Rückgabetyp

None

property updated_datetime

Return the timestamp when the experiment was last updated.

Rückgabetyp

Optional[datetime]

property uuid

Return the experiment’s uuid.

Rückgabetyp

str