235 lines
8.9 KiB
Plaintext
235 lines
8.9 KiB
Plaintext
---
|
||
title: StatevectorSimulatorPy
|
||
description: API reference for qiskit.providers.basicaer.StatevectorSimulatorPy
|
||
in_page_toc_min_heading_level: 1
|
||
python_api_type: class
|
||
python_api_name: qiskit.providers.basicaer.StatevectorSimulatorPy
|
||
---
|
||
|
||
<span id="qiskit-providers-basicaer-statevectorsimulatorpy" />
|
||
|
||
# qiskit.providers.basicaer.StatevectorSimulatorPy
|
||
|
||
<Class id="qiskit.providers.basicaer.StatevectorSimulatorPy" isDedicatedPage={true} github="https://github.com/qiskit/qiskit/tree/stable/0.16/qiskit/providers/basicaer/statevector_simulator.py" signature="StatevectorSimulatorPy(configuration=None, provider=None)" modifiers="class">
|
||
Python statevector 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.
|
||
|
||
**Parameters**
|
||
|
||
* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
|
||
* **provider** ([*BaseProvider*](qiskit.providers.BaseProvider "qiskit.providers.BaseProvider")) – provider responsible for this backend
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – if an error occurred when instantiating the backend.
|
||
|
||
### \_\_init\_\_
|
||
|
||
<Function id="qiskit.providers.basicaer.StatevectorSimulatorPy.__init__" signature="__init__(configuration=None, provider=None)">
|
||
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.
|
||
|
||
**Parameters**
|
||
|
||
* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
|
||
* **provider** ([*BaseProvider*](qiskit.providers.BaseProvider "qiskit.providers.BaseProvider")) – provider responsible for this backend
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – if an error occurred when instantiating the backend.
|
||
</Function>
|
||
|
||
## Methods
|
||
|
||
| | |
|
||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ |
|
||
| [`__init__`](#qiskit.providers.basicaer.StatevectorSimulatorPy.__init__ "qiskit.providers.basicaer.StatevectorSimulatorPy.__init__")(\[configuration, provider]) | Base class for backends. |
|
||
| [`configuration`](#qiskit.providers.basicaer.StatevectorSimulatorPy.configuration "qiskit.providers.basicaer.StatevectorSimulatorPy.configuration")() | Return the backend configuration. |
|
||
| [`name`](#qiskit.providers.basicaer.StatevectorSimulatorPy.name "qiskit.providers.basicaer.StatevectorSimulatorPy.name")() | Return the backend name. |
|
||
| [`properties`](#qiskit.providers.basicaer.StatevectorSimulatorPy.properties "qiskit.providers.basicaer.StatevectorSimulatorPy.properties")() | Return the backend properties. |
|
||
| [`provider`](#qiskit.providers.basicaer.StatevectorSimulatorPy.provider "qiskit.providers.basicaer.StatevectorSimulatorPy.provider")() | Return the backend Provider. |
|
||
| [`run`](#qiskit.providers.basicaer.StatevectorSimulatorPy.run "qiskit.providers.basicaer.StatevectorSimulatorPy.run")(qobj\[, backend\_options]) | Run qobj asynchronously. |
|
||
| [`run_experiment`](#qiskit.providers.basicaer.StatevectorSimulatorPy.run_experiment "qiskit.providers.basicaer.StatevectorSimulatorPy.run_experiment")(experiment) | Run an experiment (circuit) and return a single experiment result. |
|
||
| [`status`](#qiskit.providers.basicaer.StatevectorSimulatorPy.status "qiskit.providers.basicaer.StatevectorSimulatorPy.status")() | Return the backend status. |
|
||
| [`version`](#qiskit.providers.basicaer.StatevectorSimulatorPy.version "qiskit.providers.basicaer.StatevectorSimulatorPy.version")() | Return the backend version. |
|
||
|
||
## Attributes
|
||
|
||
| | |
|
||
| ----------------------- | - |
|
||
| `DEFAULT_CONFIGURATION` | |
|
||
| `DEFAULT_OPTIONS` | |
|
||
| `MAX_QUBITS_MEMORY` | |
|
||
| `SHOW_FINAL_STATE` | |
|
||
|
||
### configuration
|
||
|
||
<Function id="qiskit.providers.basicaer.StatevectorSimulatorPy.configuration" signature="configuration()">
|
||
Return the backend configuration.
|
||
|
||
**Returns**
|
||
|
||
the configuration for the backend.
|
||
|
||
**Return type**
|
||
|
||
[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
|
||
</Function>
|
||
|
||
### name
|
||
|
||
<Function id="qiskit.providers.basicaer.StatevectorSimulatorPy.name" signature="name()">
|
||
Return the backend name.
|
||
|
||
**Returns**
|
||
|
||
the name of the backend.
|
||
|
||
**Return type**
|
||
|
||
str
|
||
</Function>
|
||
|
||
### properties
|
||
|
||
<Function id="qiskit.providers.basicaer.StatevectorSimulatorPy.properties" signature="properties()">
|
||
Return the backend properties.
|
||
|
||
**Returns**
|
||
|
||
the configuration for the backend. If the backend does not support properties, it returns `None`.
|
||
|
||
**Return type**
|
||
|
||
[BackendProperties](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")
|
||
</Function>
|
||
|
||
### provider
|
||
|
||
<Function id="qiskit.providers.basicaer.StatevectorSimulatorPy.provider" signature="provider()">
|
||
Return the backend Provider.
|
||
|
||
**Returns**
|
||
|
||
the Provider responsible for the backend.
|
||
|
||
**Return type**
|
||
|
||
[BaseProvider](qiskit.providers.BaseProvider "qiskit.providers.BaseProvider")
|
||
</Function>
|
||
|
||
### run
|
||
|
||
<Function id="qiskit.providers.basicaer.StatevectorSimulatorPy.run" signature="run(qobj, backend_options=None)">
|
||
Run qobj asynchronously.
|
||
|
||
**Parameters**
|
||
|
||
* **qobj** ([*Qobj*](qiskit.qobj.Qobj "qiskit.qobj.Qobj")) – payload of the experiment
|
||
* **backend\_options** (*dict*) – backend options
|
||
|
||
**Returns**
|
||
|
||
derived from BaseJob
|
||
|
||
**Return type**
|
||
|
||
[BasicAerJob](qiskit.providers.basicaer.BasicAerJob "qiskit.providers.basicaer.BasicAerJob")
|
||
|
||
Additional Information:
|
||
|
||
```python
|
||
backend_options: Is a dict of options for the backend. It may contain
|
||
* "initial_statevector": vector_like
|
||
* "chop_threshold": double
|
||
|
||
The "initial_statevector" option specifies a custom initial
|
||
initial statevector for the simulator to be used instead of the all
|
||
zero state. This size of this vector must be correct for the number
|
||
of qubits in all experiments in the qobj.
|
||
|
||
The "chop_threshold" option specifies a truncation value for
|
||
setting small values to zero in the output statevector. The default
|
||
value is 1e-15.
|
||
|
||
Example::
|
||
|
||
backend_options = {
|
||
"initial_statevector": np.array([1, 0, 0, 1j]) / np.sqrt(2),
|
||
"chop_threshold": 1e-15
|
||
}
|
||
```
|
||
</Function>
|
||
|
||
### run\_experiment
|
||
|
||
<Function id="qiskit.providers.basicaer.StatevectorSimulatorPy.run_experiment" signature="run_experiment(experiment)">
|
||
Run an experiment (circuit) and return a single experiment result.
|
||
|
||
**Parameters**
|
||
|
||
**experiment** (*QobjExperiment*) – experiment from qobj experiments list
|
||
|
||
**Returns**
|
||
|
||
A result dictionary which looks something like:
|
||
|
||
```python
|
||
{
|
||
"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":
|
||
{
|
||
"counts": {'0x9: 5, ...},
|
||
"memory": ['0x9', '0xF', '0x1D', ..., '0x9']
|
||
},
|
||
"status": status string for the simulation
|
||
"success": boolean
|
||
"time_taken": simulation time of this single experiment
|
||
}
|
||
```
|
||
|
||
**Return type**
|
||
|
||
dict
|
||
|
||
**Raises**
|
||
|
||
[**BasicAerError**](qiskit.providers.basicaer.BasicAerError "qiskit.providers.basicaer.BasicAerError") – if an error occurred.
|
||
</Function>
|
||
|
||
### status
|
||
|
||
<Function id="qiskit.providers.basicaer.StatevectorSimulatorPy.status" signature="status()">
|
||
Return the backend status.
|
||
|
||
**Returns**
|
||
|
||
the status of the backend.
|
||
|
||
**Return type**
|
||
|
||
[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
|
||
</Function>
|
||
|
||
### version
|
||
|
||
<Function id="qiskit.providers.basicaer.StatevectorSimulatorPy.version" signature="version()">
|
||
Return the backend version.
|
||
|
||
**Returns**
|
||
|
||
the X.X.X version of the backend.
|
||
|
||
**Return type**
|
||
|
||
str
|
||
</Function>
|
||
</Class>
|
||
|