Qiskit-Aer

This is a working draft for the Qiskit-Aer simulator framework for Qiskit-Terra. This is the development repository and has no guarantee of stability or correctness.

Repository contents

• The aer folder contains the Qiskit-Aer python module for use with Qiskit-Terra.
• The cmake folder contains cmake scripts for building the simulator
• The src folder contains the C++ source files for building the simulator.
• The examples folder contains example qobj files for the simulator.
• The standalone folder contains a stand-alone executable that can be used for development and testing. Note that stand-alone building will be removed before release and will not be supported.
• The test folder contains simulator unit tests.

Documentation

See the Qiskit Aer wiki for documentation.

There's a contributing guide with more detailed information about the project.

Installation

Follow these steps for installing the Qiskit Aer package:

qiskit-aer$ pip install -r requirements-dev.txt
qiskit-aer$ python ./setup.py bdist_wheel

Once the build finishes, we just need to install the wheel package in our preferred python virtual environment:

qiskit-aer$ pip install dist/qiskit_aer-0.1.0-cp36-cp36m-linux_x86_64.whl

We are all set! Now we ready to start using the simulator in our python code:

import qiskit_aer as aer
from qiskit_aer import Aer  # Imports the Aer Provider

Aer.backends() # List Aer backends