qiskit.providers.ibmq.IBMQFactory¶

class IBMQFactory[Quellcode]¶

Factory and account manager for IBM Quantum Experience.

IBMQFactory constructor.

__init__()[Quellcode]¶: IBMQFactory constructor.

Methods

`__init__`()	IBMQFactory constructor.
`active_account`()	Return the IBM Quantum Experience account currently in use for the session.
`delete_account`()	Delete the saved account from disk.
`disable_account`()	Disable the account currently in use for the session.
`enable_account`(token[, url, hub, group, project])	Authenticate against IBM Quantum Experience for use during the session.
`get_provider`([hub, group, project])	Return a provider for a single hub/group/project combination.
`load_account`()	Authenticate against IBM Quantum Experience from stored credentials.
`providers`([hub, group, project])	Return a list of providers, subject to optional filtering.
`save_account`(token[, url, hub, group, …])	Save the account to disk for future use.
`stored_account`()	List the account stored on disk.
`update_account`([force])	Interactive helper for migrating stored credentials to IBM Quantum Experience v2.

active_account()[Quellcode]¶

Return the IBM Quantum Experience account currently in use for the session.

Rückgabetyp: Optional[Dict[str, str]]
Rückgabe: Information about the account currently in the session.

static delete_account()[Quellcode]¶

Delete the saved account from disk.

Verursacht

IBMQAccountCredentialsNotFound – If no valid IBM Quantum Experience credentials can be found on disk.
IBMQAccountMultipleCredentialsFound – If multiple IBM Quantum Experience credentials are found on disk.
IBMQAccountCredentialsInvalidUrl – If invalid IBM Quantum Experience credentials are found on disk.

Rückgabetyp

None

disable_account()[Quellcode]¶

Disable the account currently in use for the session.

Verursacht: IBMQAccountCredentialsNotFound – If no account is in use for the session.
Rückgabetyp: None

enable_account(token, url='https://auth.quantum-computing.ibm.com/api', hub=None, group=None, project=None, **kwargs)[Quellcode]¶

Authenticate against IBM Quantum Experience for use during the session.

Bemerkung

With version 0.4 of this qiskit-ibmq-provider package, use of the legacy Quantum Experience and Qconsole (also known as the IBM Quantum Experience v1) credentials is no longer supported.

Parameter

token (str) – IBM Quantum Experience token.
url (str) – URL for the IBM Quantum Experience authentication server.
hub (Optional[str]) – Name of the hub to use.
group (Optional[str]) – Name of the group to use.
project (Optional[str]) – Name of the project to use.
**kwargs –
Additional settings for the connection:
- proxies (dict): proxy configuration.
- verify (bool): verify the server’s TLS certificate.

Rückgabetyp

Optional[AccountProvider]

Rückgabe

If hub, group, and project are specified, the corresponding provider is returned. Otherwise the provider for the open access project is returned.

Verursacht

IBMQAccountError – If an IBM Quantum Experience account is already in use for the session.
IBMQAccountCredentialsInvalidUrl – If the URL specified is not a valid IBM Quantum Experience authentication URL.
IBMQProviderError – If no provider matches the specified criteria, or more than one provider matches the specified criteria.

get_provider(hub=None, group=None, project=None)[Quellcode]¶

Return a provider for a single hub/group/project combination.

Parameter

hub (Optional[str]) – Name of the hub.
group (Optional[str]) – Name of the group.
project (Optional[str]) – Name of the project.

Rückgabetyp

AccountProvider

Rückgabe

A provider that matches the specified criteria.

Verursacht

IBMQProviderError – If no provider matches the specified criteria, or more than one provider matches the specified criteria.

load_account()[Quellcode]¶

Authenticate against IBM Quantum Experience from stored credentials.

Rückgabetyp

Optional[AccountProvider]

Rückgabe

If the configuration file specifies a default provider, it is returned. Otherwise the provider for the open access project is returned.

Verursacht

IBMQAccountCredentialsInvalidFormat – If the default provider stored on disk could not be parsed.
IBMQAccountCredentialsNotFound – If no IBM Quantum Experience credentials can be found.
IBMQAccountMultipleCredentialsFound – If multiple IBM Quantum Experience credentials are found.
IBMQAccountCredentialsInvalidUrl – If invalid IBM Quantum Experience credentials are found.
IBMQProviderError – If the default provider stored on disk could not be found.

providers(hub=None, group=None, project=None)[Quellcode]¶

Return a list of providers, subject to optional filtering.

Parameter

hub (Optional[str]) – Name of the hub.
group (Optional[str]) – Name of the group.
project (Optional[str]) – Name of the project.

Rückgabetyp

List[AccountProvider]

Rückgabe

A list of providers that match the specified criteria.

static save_account(token, url='https://auth.quantum-computing.ibm.com/api', hub=None, group=None, project=None, overwrite=False, **kwargs)[Quellcode]¶

Save the account to disk for future use.

Bemerkung

If storing a default provider to disk, all three parameters hub, group, project must be specified.

Parameter

token (str) – IBM Quantum Experience token.
url (str) – URL for the IBM Quantum Experience authentication server.
hub (Optional[str]) – Name of the hub for the default provider to store on disk.
group (Optional[str]) – Name of the group for the default provider to store on disk.
project (Optional[str]) – Name of the project for the default provider to store on disk.
overwrite (bool) – Overwrite existing credentials.
**kwargs –
- proxies (dict): Proxy configuration for the server.
- verify (bool): If False, ignores SSL certificates errors

Verursacht

IBMQAccountCredentialsInvalidUrl – If the url is not a valid IBM Quantum Experience authentication URL.
IBMQAccountCredentialsInvalidToken – If the token is not a valid IBM Quantum Experience token.
IBMQAccountValueError – If only one or two parameters from hub, group, project are specified.

Rückgabetyp

None

static stored_account()[Quellcode]¶

List the account stored on disk.

Rückgabetyp

Dict[str, str]

Rückgabe

A dictionary with information about the account stored on disk.

Verursacht

IBMQAccountMultipleCredentialsFound – If multiple IBM Quantum Experience credentials are found on disk.
IBMQAccountCredentialsInvalidUrl – If invalid IBM Quantum Experience credentials are found on disk.

static update_account(force=False)[Quellcode]¶

Interactive helper for migrating stored credentials to IBM Quantum Experience v2.

Parameter: force (bool) – If True, disable interactive prompts and perform the changes.
Rückgabetyp: Optional[Credentials]
Rückgabe: The credentials for IBM Quantum Experience v2 if updating is successful or None otherwise.