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.

パラメータ

• 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.

例外

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.

パラメータ

• 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.

例外

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.

戻り値の型

List

property backend_name

Return the experiment’s backend name.

戻り値の型

str

property creation_datetime

Return the timestamp when the experiment was created.

戻り値の型

Optional[datetime]

property end_datetime

Return the timestamp when the experiment ended.

戻り値の型

Optional[datetime]

classmethod from_remote_data(provider, remote_data)

Create an instance of this class from remote data.

パラメータ

• provider (AccountProvider) – account provider.

• remote_data (Dict) – Remote data to use.

戻り値の型

Experiment

戻り値

An instance of this class.

property group

Return the experiment’s group.

戻り値の型

str

property hub

Return the experiment’s hub.

戻り値の型

str

property owner

Return the experiment’s owner.

戻り値の型

str

property plot_names

Return names of plots associated with this experiment.

戻り値の型

List

property project

Return the experiment’s project.

戻り値の型

str

refresh()

Update this experiment instance with remote data.

戻り値の型

None

property share_level

Return the experiment share_level.

戻り値の型

Optional[ExperimentShareLevel]

property start_datetime

Return the timestamp when the experiment started.

戻り値の型

datetime

update_from_remote_data(remote_data)

Update the attributes of this instance using remote data.

パラメータ

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

戻り値の型

None

property updated_datetime

Return the timestamp when the experiment was last updated.

戻り値の型

Optional[datetime]

property uuid

Return the experiment’s uuid.

戻り値の型

str