scientific-skills/pennylane/references/getting_started.md
PennyLane is a cross-platform Python library for quantum computing, quantum machine learning, and quantum chemistry. It enables training quantum computers like neural networks through automatic differentiation and seamless integration with classical machine learning frameworks.
Install PennyLane using uv:
uv pip install pennylane
For specific device plugins (IBM, Amazon Braket, Google, Rigetti, etc.):
# IBM Qiskit
uv pip install pennylane-qiskit
# Amazon Braket
uv pip install amazon-braket-pennylane-plugin
# Google Cirq
uv pip install pennylane-cirq
# Rigetti
uv pip install pennylane-rigetti
A QNode is a quantum function that can be evaluated on a quantum device. It combines a quantum circuit definition with a device:
import pennylane as qml
# Define a device
dev = qml.device('default.qubit', wires=2)
# Create a QNode
@qml.qnode(dev)
def circuit(params):
qml.RX(params[0], wires=0)
qml.RY(params[1], wires=1)
qml.CNOT(wires=[0, 1])
return qml.expval(qml.PauliZ(0))
Devices execute quantum circuits. PennyLane supports:
default.qubit, default.mixed, lightning.qubit# Local simulator
dev = qml.device('default.qubit', wires=4)
# Lightning high-performance simulator
dev = qml.device('lightning.qubit', wires=10)
PennyLane supports various measurement types:
@qml.qnode(dev)
def measure_circuit():
qml.Hadamard(wires=0)
# Expectation value
return qml.expval(qml.PauliZ(0))
@qml.qnode(dev)
def measure_probs():
qml.Hadamard(wires=0)
# Probability distribution
return qml.probs(wires=[0, 1])
@qml.qnode(dev)
def measure_samples():
qml.Hadamard(wires=0)
# Sample measurements
return qml.sample(qml.PauliZ(0))
import pennylane as qml
import numpy as np
dev = qml.device('default.qubit', wires=3)
@qml.qnode(dev)
def quantum_circuit(weights):
# Apply gates
qml.RX(weights[0], wires=0)
qml.RY(weights[1], wires=1)
qml.CNOT(wires=[0, 1])
qml.RZ(weights[2], wires=2)
# Measure
return qml.expval(qml.PauliZ(0) @ qml.PauliZ(1))
# Automatic differentiation
grad_fn = qml.grad(quantum_circuit)
weights = np.array([0.1, 0.2, 0.3])
gradients = grad_fn(weights)
from pennylane import numpy as np
# Define optimizer
opt = qml.GradientDescentOptimizer(stepsize=0.1)
# Optimization loop
weights = np.array([0.1, 0.2, 0.3], requires_grad=True)
for i in range(100):
weights = opt.step(quantum_circuit, weights)
if i % 20 == 0:
print(f"Step {i}: Cost = {quantum_circuit(weights)}")
Write circuits once, run anywhere:
# Same circuit, different backends
@qml.qnode(qml.device('default.qubit', wires=2))
def circuit_simulator(x):
qml.RX(x, wires=0)
return qml.expval(qml.PauliZ(0))
# Switch to hardware (if available)
@qml.qnode(qml.device('qiskit.ibmq', wires=2))
def circuit_hardware(x):
qml.RX(x, wires=0)
return qml.expval(qml.PauliZ(0))
@qml.qnode(dev)
def parameterized_circuit(params, x):
# Encode data
qml.RX(x, wires=0)
# Apply parameterized layers
for param in params:
qml.RY(param, wires=0)
qml.CNOT(wires=[0, 1])
return qml.expval(qml.PauliZ(0))
Use built-in templates for common patterns:
from pennylane.templates import StronglyEntanglingLayers
@qml.qnode(dev)
def template_circuit(weights):
StronglyEntanglingLayers(weights, wires=range(3))
return qml.expval(qml.PauliZ(0))
# Generate random weights for template
n_layers = 2
n_wires = 3
shape = StronglyEntanglingLayers.shape(n_layers, n_wires)
weights = np.random.random(shape)
print(qml.draw(circuit)(params))
print(qml.draw_mpl(circuit)(params)) # Matplotlib visualization
with qml.tape.QuantumTape() as tape:
qml.Hadamard(wires=0)
qml.CNOT(wires=[0, 1])
print(tape.operations)
print(tape.measurements)
For detailed information on specific topics:
references/quantum_circuits.mdreferences/quantum_ml.mdreferences/quantum_chemistry.mdreferences/devices_backends.mdreferences/optimization.mdreferences/advanced_features.md