qiskit.providers.aer.PulseSimulator¶

class PulseSimulator(configuration=None, properties=None, defaults=None, provider=None, **backend_options)[ソース]¶

Pulse schedule simulator backend.

The PulseSimulator simulates continuous time Hamiltonian dynamics of a quantum system, with controls specified by pulse Schedule objects, and the model of the physical system specified by PulseSystemModel objects. Results are returned in the same format as when jobs are submitted to actual devices.

Examples

The minimal information a PulseSimulator needs to simulate is a PulseSystemModel, which can be supplied either by setting the backend option before calling run, e.g.:

backend_sim = qiskit.providers.aer.PulseSimulator()

# Set the pulse system model for the simulator
backend_sim.set_options(system_model=system_model)

# Assemble schedules using PulseSimulator as the backend
pulse_qobj = assemble(schedules, backend=backend_sim)

# Run simulation
results = backend_sim.run(pulse_qobj)

or by supplying the system model at runtime, e.g.:

backend_sim = qiskit.providers.aer.PulseSimulator()

# Assemble schedules using PulseSimulator as the backend
pulse_qobj = assemble(schedules, backend=backend_sim)

# Run simulation on a PulseSystemModel object
results = backend_sim.run(pulse_qobj, system_model=system_model)

Alternatively, an instance of the PulseSimulator may be further configured to contain more information present in a real backend. The simplest way to do this is to instantiate the PulseSimulator from a real backend:

armonk_sim = qiskit.providers.aer.PulseSimulator.from_backend(FakeArmonk())
pulse_qobj = assemble(schedules, backend=armonk_sim)
armonk_sim.run(pulse_qobj)

In the above example, the PulseSimulator copies all configuration and default data from FakeArmonk(), and as such has the same affect as FakeArmonk() when passed as an argument to assemble. Furthermore it constructs a PulseSystemModel from the model details in the supplied backend, which is then used in simulation.

Supported PulseQobj parameters

qubit_lo_freq: Local oscillator frequencies for each DriveChannel. Defaults to either the value given in the PulseSystemModel, or is calculated directly from the Hamiltonian.
meas_level: Type of desired measurement output, in [1, 2]. 1 gives complex numbers (IQ values), and 2 gives discriminated states |0> and |1>. Defaults to 2.
meas_return: Measurement type, 'single' or 'avg'. Defaults to 'avg'.
shots: Number of shots per experiment. Defaults to 1024.

Simulation details

The simulator uses the zvode differential equation solver method through scipy. Simulation is performed in the rotating frame of the diagonal of the drift Hamiltonian contained in the PulseSystemModel. Measurements are performed in the dressed basis of the drift Hamiltonian.

Other options

Additional valid keyword arguments for run():

'solver_options': A dict for solver options. Accepted keys are 'atol', 'rtol', 'nsteps', 'max_step', 'num_cpus', 'norm_tol', and 'norm_steps'.

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

パラメータ

configuration (BackendConfiguration) – backend configuration.
properties (BackendProperties or None) – Optional, backend properties.
defaults (PulseDefaults or None) – Optional, backend pulse defaults.
available_methods (list or None) – Optional, the available simulation methods if backend supports multiple methods.
provider (BaseProvider) – Optional, provider responsible for this backend.
backend_options (dict or None) – Optional set custom backend options.

例外

AerError – if there is no name in the configuration

__init__(configuration=None, properties=None, defaults=None, provider=None, **backend_options)[ソース]¶

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

パラメータ

configuration (BackendConfiguration) – backend configuration.
properties (BackendProperties or None) – Optional, backend properties.
defaults (PulseDefaults or None) – Optional, backend pulse defaults.
available_methods (list or None) – Optional, the available simulation methods if backend supports multiple methods.
provider (BaseProvider) – Optional, provider responsible for this backend.
backend_options (dict or None) – Optional set custom backend options.

例外

AerError – if there is no name in the configuration

Methods

`__init__`([configuration, properties, …])	Aer class for backends.
`available_methods`()	Return the available simulation methods.
`clear_options`()	Reset the simulator options to default values.
`configuration`()	Return the simulator backend configuration.
`defaults`()	Return the simulator backend pulse defaults.
`from_backend`(backend, **options)	Initialize simulator from backend.
`name`()	Return the backend name.
`properties`()	Return the simulator backend properties if set.
`provider`()	Return the backend Provider.
`run`(qobj, *args[, backend_options, validate])	Run a qobj on the backend.
`set_options`(**backend_options)	Set the simulator options
`status`()	Return backend status.
`version`()	Return the backend version.

Attributes

options

Return the current simulator options

available_methods()¶: Return the available simulation methods.

clear_options()¶: Reset the simulator options to default values.

configuration()¶

Return the simulator backend configuration.

戻り値: the configuration for the backend.
戻り値の型: BackendConfiguration

defaults()¶

Return the simulator backend pulse defaults.

戻り値

The backend pulse defaults or None if the: backend does not support pulse.

戻り値の型

PulseDefaults

classmethod from_backend(backend, **options)[ソース]¶: Initialize simulator from backend.

name()¶

Return the backend name.

戻り値: the name of the backend.
戻り値の型: str

property options¶: Return the current simulator options

properties()¶

Return the simulator backend properties if set.

戻り値

The backend properties or None if the: backend does not have properties set.

戻り値の型

BackendProperties

provider()¶

Return the backend Provider.

戻り値: the Provider responsible for the backend.
戻り値の型: BaseProvider

run(qobj, *args, backend_options=None, validate=True, **run_options)[ソース]¶

Run a qobj on the backend.

パラメータ

qobj (QasmQobj) – The Qobj to be executed.
backend_options (dict or None) – DEPRECATED dictionary of backend options for the execution (default: None).
validate (bool) – validate the Qobj before running (default: True).
run_options (kwargs) – additional run time backend options.

戻り値

The simulation job.

戻り値の型

AerJob

Additional Information:

kwarg options specified in run_options will override options of the same kwarg specified in the simulator options, the backend_options and the Qobj.config.
The entries in the backend_options will be combined with the Qobj.config dictionary with the values of entries in backend_options taking precedence. This kwarg is deprecated and direct kwarg’s should be used for options to pass them to run_options.

set_options(**backend_options)¶: Set the simulator options

status()¶

Return backend status.

戻り値: the status of the backend.
戻り値の型: BackendStatus

version()¶

Return the backend version.

戻り値: the X.X.X version of the backend.
戻り値の型: str