qiskit.providers.basicaer.UnitarySimulatorPy¶

class UnitarySimulatorPy(configuration=None, provider=None)[source]¶

Python implementation of a unitary simulator.

Base class for backends.

This method should initialize the module and its configuration, and raise an exception if a component of the module is not available.

Paramètres

configuration (BackendConfiguration) – backend configuration
provider (BaseProvider) – provider responsible for this backend

Lève

QiskitError – if an error occurred when instantiating the backend.

__init__(configuration=None, provider=None)[source]¶

Base class for backends.

This method should initialize the module and its configuration, and raise an exception if a component of the module is not available.

Paramètres

configuration (BackendConfiguration) – backend configuration
provider (BaseProvider) – provider responsible for this backend

Lève

QiskitError – if an error occurred when instantiating the backend.

Methods

`__init__`([configuration, provider])	Base class for backends.
`configuration`()	Return the backend configuration.
`name`()	Return the backend name.
`properties`()	Return the backend properties.
`provider`()	Return the backend Provider.
`run`(qobj[, backend_options])	Run qobj asynchronously.
`run_experiment`(experiment)	Run an experiment (circuit) and return a single experiment result.
`status`()	Return the backend status.
`version`()	Return the backend version.

Attributes

`DEFAULT_CONFIGURATION`
`DEFAULT_OPTIONS`
`MAX_QUBITS_MEMORY`

configuration()¶

Return the backend configuration.

Renvoie: the configuration for the backend.
Type renvoyé: BackendConfiguration

name()¶

Return the backend name.

Renvoie: the name of the backend.
Type renvoyé: str

properties()¶

Return the backend properties.

Renvoie: the configuration for the backend. If the backend does not support properties, it returns None.
Type renvoyé: BackendProperties

provider()¶

Return the backend Provider.

Renvoie: the Provider responsible for the backend.
Type renvoyé: BaseProvider

run(qobj, backend_options=None)[source]¶

Run qobj asynchronously.

Paramètres

qobj (Qobj) – payload of the experiment
backend_options (dict) – backend options

Renvoie

derived from BaseJob

Type renvoyé

BasicAerJob

Additional Information:

backend_options: Is a dict of options for the backend. It may contain
    * "initial_unitary": matrix_like
    * "chop_threshold": double

The "initial_unitary" option specifies a custom initial unitary
matrix for the simulator to be used instead of the identity
matrix. This size of this matrix must be correct for the number
of qubits inall experiments in the qobj.

The "chop_threshold" option specifies a truncation value for
setting small values to zero in the output unitary. The default
value is 1e-15.

Example::

    backend_options = {
        "initial_unitary": np.array([[1, 0, 0, 0],
                                     [0, 0, 0, 1],
                                     [0, 0, 1, 0],
                                     [0, 1, 0, 0]])
        "chop_threshold": 1e-15
    }

run_experiment(experiment)[source]¶

Run an experiment (circuit) and return a single experiment result.

Paramètres

experiment (QobjExperiment) – experiment from qobj experiments list

Renvoie

A result dictionary which looks something like:

{
"name": name of this experiment (obtained from qobj.experiment header)
"seed": random seed used for simulation
"shots": number of shots used in the simulation
"data":
    {
    "unitary": [[[0.0, 0.0], [1.0, 0.0]],
                [[1.0, 0.0], [0.0, 0.0]]]
    },
"status": status string for the simulation
"success": boolean
"time taken": simulation time of this single experiment
}

Type renvoyé

dict

Lève

BasicAerError – if the number of qubits in the circuit is greater than 24.
Note that the practical qubit limit is much lower than 24. –

status()¶

Return the backend status.

Renvoie: the status of the backend.
Type renvoyé: BackendStatus

version()¶

Return the backend version.

Renvoie: the X.X.X version of the backend.
Type renvoyé: str