Go to file
Deji Oyerinde 7ac677e385
Update standard_errors.py (#1799)
There was a typo in the rendering of the mathematical text on Depolarizing Error Page (https://qiskit.org/ecosystem/aer/stubs/qiskit_aer.noise.depolarizing_error.html)

Co-authored-by: Hiroshi Horii <hhorii@users.noreply.github.com>
Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>
2023-05-16 15:47:23 +00:00
.github Remove Sampler.close, assert DeprecationWarning of opflow, and update dependency (#1804) 2023-05-10 13:41:13 +09:00
cmake Remove REQUIRED to find PythonLibs in FindPybind11 (#1786) 2023-05-01 12:30:26 +00:00
contrib add code-formatting with black for python and with clang-format for c++ (#1630) 2023-03-13 20:19:06 +00:00
docs Activate jQuery in docs (#1802) 2023-05-12 11:39:13 +09:00
qiskit_aer Update standard_errors.py (#1799) 2023-05-16 15:47:23 +00:00
releasenotes fix cuQuantum static linking (#1812) 2023-05-16 04:57:26 +00:00
src Fix setting MPI processes and ranks (#1808) 2023-05-10 18:21:20 +09:00
test Support `SwitchCaseOp` that will be released in qiskit-terra 0.24.0 (#1778) 2023-05-16 12:23:56 +09:00
tools deploy documentation in qiskit.org/ecosystem (#1748) 2023-03-16 13:15:16 +00:00
.clang-format add code-formatting with black for python and with clang-format for c++ (#1630) 2023-03-13 20:19:06 +00:00
.clang-tidy Modernizing code (#338) 2019-09-26 09:56:15 -04:00
.git-blame-ignore-revs Add git blame ignore file (#1745) 2023-03-14 00:17:15 +00:00
.gitignore Move Aer to its own package (#1526) 2022-08-31 10:33:59 +09:00
.mailmap Update garrison's name in .mailmap (#1444) 2022-02-02 10:15:06 +00:00
.mergify.yml Add mergify configuration (#1518) 2022-05-10 09:26:18 -04:00
.pylintrc add code-formatting with black for python and with clang-format for c++ (#1630) 2023-03-13 20:19:06 +00:00
.stestr.conf Switch group regex to parallel-class 2019-11-14 14:47:30 -05:00
BENCHMARKING.md Prepare for renaming default branch to main (#1233) 2021-04-28 16:15:27 -04:00
CMakeLists.txt fix cuQuantum static linking (#1812) 2023-05-16 04:57:26 +00:00
CODE_OF_CONDUCT.md Qiskit projects point to main CoC (#1049) 2020-11-18 16:41:57 -05:00
CONTRIBUTING.md Add Tutorials to Documentation Page (#1768) 2023-04-05 03:29:22 +00:00
LICENSE.txt * Added Apache 2 license 2018-08-29 13:28:45 +02:00
MANIFEST.in Move Aer to its own package (#1526) 2022-08-31 10:33:59 +09:00
README.md Update pip install command to reference qiskit-aer (#1627) 2022-10-21 06:20:44 +00:00
constraints.txt Pin jinja2 in CI (#1490) 2022-03-25 14:23:06 +00:00
pyproject.toml add code-formatting with black for python and with clang-format for c++ (#1630) 2023-03-13 20:19:06 +00:00
requirements-dev.txt Add Tutorials to Documentation Page (#1768) 2023-04-05 03:29:22 +00:00
setup.py add code-formatting with black for python and with clang-format for c++ (#1630) 2023-03-13 20:19:06 +00:00
tox.ini add code-formatting with black for python and with clang-format for c++ (#1630) 2023-03-13 20:19:06 +00:00

README.md

Qiskit Aer

LicenseBuild Status

Qiskit is an open-source framework for working with noisy quantum computers at the level of pulses, circuits, and algorithms.

Qiskit is made up of elements that each work together to enable quantum computing. This element is Aer, which provides high-performance quantum computing simulators with realistic noise models.

Installation

We encourage installing Qiskit via the pip tool (a python package manager). The following command installs the core Qiskit components, including Aer.

pip install qiskit qiskit-aer

Pip will handle all dependencies automatically for us and you will always install the latest (and well-tested) version.

To install from source, follow the instructions in the contribution guidelines.

Installing GPU support

In order to install and run the GPU supported simulators on Linux, you need CUDA® 10.1 or newer previously installed. CUDA® itself would require a set of specific GPU drivers. Please follow CUDA® installation procedure in the NVIDIA® web.

If you want to install our GPU supported simulators, you have to install this other package:

pip install qiskit-aer-gpu

This will overwrite your current qiskit-aer package installation giving you the same functionality found in the canonical qiskit-aer package, plus the ability to run the GPU supported simulators: statevector, density matrix, and unitary.

Note: This package is only available on x86_64 Linux. For other platforms that have CUDA support you will have to build from source. You can refer to the contributing guide for instructions on doing this.

Simulating your first quantum program with Qiskit Aer

Now that you have Qiskit Aer installed, you can start simulating quantum circuits with noise. Here is a basic example:

$ python
import qiskit
from qiskit import IBMQ
from qiskit_aer import AerSimulator

# Generate 3-qubit GHZ state
circ = qiskit.QuantumCircuit(3)
circ.h(0)
circ.cx(0, 1)
circ.cx(1, 2)
circ.measure_all()

# Construct an ideal simulator
aersim = AerSimulator()

# Perform an ideal simulation
result_ideal = qiskit.execute(circ, aersim).result()
counts_ideal = result_ideal.get_counts(0)
print('Counts(ideal):', counts_ideal)
# Counts(ideal): {'000': 493, '111': 531}

# Construct a noisy simulator backend from an IBMQ backend
# This simulator backend will be automatically configured
# using the device configuration and noise model 
provider = IBMQ.load_account()
backend = provider.get_backend('ibmq_athens')
aersim_backend = AerSimulator.from_backend(backend)

# Perform noisy simulation
result_noise = qiskit.execute(circ, aersim_backend).result()
counts_noise = result_noise.get_counts(0)

print('Counts(noise):', counts_noise)
# Counts(noise): {'000': 492, '001': 6, '010': 8, '011': 14, '100': 3, '101': 14, '110': 18, '111': 469}

Contribution Guidelines

If you'd like to contribute to Qiskit, please take a look at our contribution guidelines. This project adheres to Qiskit's code of conduct. By participating, you are expect to uphold to this code.

We use GitHub issues for tracking requests and bugs. Please use our slack for discussion and simple questions. To join our Slack community use the link. For questions that are more suited for a forum we use the Qiskit tag in the Stack Exchange.

Next Steps

Now you're set up and ready to check out some of the other examples from our Qiskit IQX Tutorials or Qiskit Community Tutorials repositories.

Authors and Citation

Qiskit Aer is the work of many people who contribute to the project at different levels. If you use Qiskit, please cite as per the included BibTeX file.

License

Apache License 2.0