API reference

In this section we present the main Qibo components and primitives included in the public API.

• Models
  • Circuit models
    • Circuit
    • Circuit addition
    • Circuit fusion
    • Quantum Fourier Transform (QFT)
    • Variational Quantum Eigensolver (VQE)
    • Adiabatically Assisted Variational Quantum Eigensolver (AAVQE)
    • Quantum Approximate Optimization Algorithm (QAOA)
    • Feedback-based Algorithm for Quantum Optimization (FALQON)
    • Grover’s Algorithm
    • Travelling Salesman Problem
    • Iterative Quantum Amplitude Estimation (IQAE)
  • Time evolution
    • State evolution
    • Adiabatic evolution
  • Data Encoders
    • Computational Basis Encoder
    • Phase Encoder
    • Sparse encoder
    • Binary encoder
    • Unary Encoder
    • Unary Encoder for Random Gaussian States
    • Fixed Hamming-weight Encoder
    • Entangling layer
    • Greenberger-Horne-Zeilinger (GHZ) state
  • Error Mitigation
    • Readout Mitigation
    • Response Matrix
    • Randomized readout mitigation
    • Zero Noise Extrapolation (ZNE)
    • Clifford Data Regression (CDR)
    • Variable Noise CDR (vnCDR)
    • Importance Clifford Sampling (ICS)
• Gates
  • Abstract gate
    • Gate
  • Single qubit gates
    • Hadamard (H)
    • Pauli X (X)
    • Pauli Y (Y)
    • Pauli Z (Z)
    • Square-root of Pauli X (SX)
    • S gate (S)
    • T gate (T)
    • Identity (I)
    • Align (A)
    • Measurement (M)
    • Rotation X-axis (RX)
    • Rotation Y-axis (RY)
    • Rotation Z-axis (RZ)
    • First general unitary (U1)
    • Second general unitary (U2)
    • Third general unitary (U3)
  • Two qubit gates
    • Controlled-NOT (CNOT)
    • Controlled-Y (CY)
    • Controlled-phase (CZ)
    • Controlled-Square Root of X (CSX)
    • Controlled-rotation X-axis (CRX)
    • Controlled-rotation Y-axis (CRY)
    • Controlled-rotation Z-axis (CRZ)
    • Controlled first general unitary (CU1)
    • Controlled second general unitary (CU2)
    • Controlled third general unitary (CU3)
    • Swap (SWAP)
    • iSwap (iSWAP)
    • Square root of iSwap (SiSWAP)
    • f-Swap (FSWAP)
    • fSim
    • Sycamore gate
    • fSim with general rotation
    • Parametric XX interaction (RXX)
    • Parametric YY interaction (RYY)
    • Parametric ZZ interaction (RZZ)
    • Parametric ZX interaction (RZX)
    • Parametric XX-YY interaction (RXXYY)
    • Givens gate
    • Reconfigurable Beam Splitter gate (RBS)
    • Echo Cross-Resonance gate (ECR)
  • Special gates
    • Toffoli
    • CCZ
    • Deutsch
    • Generalized Reconfigurable Beam Splitter (RBS)
    • Arbitrary unitary
    • Callback gate
    • Fusion gate
  • IONQ Native gates
    • GPI
    • GPI2
    • Mølmer–Sørensen (MS)
  • Quantinuum native gates
    • U1q
  • IQM native gates
    • Phase-\(RX\)
• Channels
  • Kraus channel
    • KrausChannel
  • Unitary channel
    • UnitaryChannel
  • Pauli noise channel
    • PauliNoiseChannel
  • Depolarizing channel
    • DepolarizingChannel
  • Thermal relaxation channel
    • ThermalRelaxationChannel
  • Amplitude damping channel
    • AmplitudeDampingChannel
  • Phase damping channel
    • PhaseDampingChannel
  • Readout error channel
    • ReadoutErrorChannel
  • Reset channel
    • ResetChannel
• Noise
  • NoiseModel
    • NoiseModel.add()
    • NoiseModel.apply()
  • Quantum errors
    • KrausError
    • UnitaryError
    • PauliError
    • DepolarizingError
    • ThermalRelaxationError
    • AmplitudeDampingError
    • PhaseDampingError
    • ReadoutError
    • ResetError
    • CustomError
  • IBMQ noise model
    • IBMQNoiseModel
• Hamiltonians
  • AbstractHamiltonian
    • AbstractHamiltonian.eigenvalues()
    • AbstractHamiltonian.eigenvectors()
    • AbstractHamiltonian.ground_state()
    • AbstractHamiltonian.exp()
    • AbstractHamiltonian.expectation()
    • AbstractHamiltonian.expectation_from_samples()
  • Matrix Hamiltonian
    • Hamiltonian
  • Symbolic Hamiltonian
    • SymbolicHamiltonian
  • Non-interacting Pauli-X
    • X
  • Non-interacting Pauli-Y
    • Y
  • Non-interacting Pauli-Z
    • Z
  • Transverse field Ising model
    • TFIM
  • Max Cut
    • MaxCut
  • Heisenberg model
    • Heisenberg
  • Heisenberg XXX
    • XXX
  • Heisenberg XXZ
    • XXZ
• Symbols
  • Symbol
    • Symbol.gate
    • Symbol.full_matrix()
  • I
  • X
  • Y
  • Z
• Execution Outcomes
  • QuantumState
    • QuantumState.symbolic()
    • QuantumState.state()
    • QuantumState.probabilities()
    • QuantumState.to_dict()
    • QuantumState.dump()
    • QuantumState.from_dict()
    • QuantumState.load()
  • MeasurementOutcomes
    • MeasurementOutcomes.frequencies()
    • MeasurementOutcomes.probabilities()
    • MeasurementOutcomes.has_samples()
    • MeasurementOutcomes.samples()
    • MeasurementOutcomes.measurement_gate
    • MeasurementOutcomes.apply_bitflips()
    • MeasurementOutcomes.expectation_from_samples()
    • MeasurementOutcomes.to_dict()
    • MeasurementOutcomes.dump()
    • MeasurementOutcomes.from_dict()
    • MeasurementOutcomes.load()
  • CircuitResult
    • CircuitResult.probabilities()
    • CircuitResult.to_dict()
    • CircuitResult.from_dict()
• Callbacks
  • Callback
    • Callback.nqubits
  • Entanglement entropy
    • EntanglementEntropy
  • Norm
    • Norm
  • Overlap
    • Overlap
  • Energy
    • Energy
  • Gap
    • Gap
• Solvers
  • BaseSolver
    • BaseSolver.t
  • TrotterizedExponential
  • Exponential
  • RungeKutta4
  • RungeKutta45
• Optimizers
  • optimize()
  • cmaes()
  • newtonian()
  • sgd()
• Parameter
  • calculate_derivatives()
  • Parameter
    • Parameter.nparams
    • Parameter.nfeat
    • Parameter.ncomponents
    • Parameter.trainable_parameter_indices()
    • Parameter.unaffected_by()
    • Parameter.partial_derivative()
• Gradients
  • parameter_shift()
  • finite_differences()
• Quantum Information
  • Basis
    • Pauli basis
    • Computational basis to Pauli basis
    • Pauli basis to computational basis
  • Phase-space Representation of Stabilizer States
    • Clifford
  • Entanglement measures
    • Concurrence
    • Entanglement of formation
    • Negativity
    • Entanglement fidelity
    • Meyer-Wallach entanglement
    • Entanglement capability
  • Entropy measures
    • Shannon entropy
    • Classical relative entropy
    • Classical mutual information
    • Classical Rényi entropy
    • Classical Rényi relative entropy
    • Classical Tsallis entropy
    • Classical Tsallis relative entropy
    • von Neumann entropy
    • Relative von Neumann entropy
    • Mutual information
    • Rényi entropy
    • Relative Rényi entropy
    • Tsallis entropy
    • Relative Tsallis entropy
    • Entanglement entropy
  • Metrics
    • Purity
    • Impurity
    • Trace distance
    • Hilbert-Schmidt inner product
    • Hilbert-Schmidt distance
    • Fidelity
    • Infidelity
    • Bures angle
    • Bures distance
    • Process fidelity
    • Process infidelity
    • Average gate fidelity
    • Gate error
    • Diamond Norm
    • Expressibility of parameterized quantum circuits
    • Frame Potential
    • Quantum Fisher Information Matrix
  • Linear Algebra Operations
    • Commutator
    • Anticommutator
    • Partial trace
    • Partial transpose
    • Matrix exponentiation
    • Matrix power
    • Singular value decomposition
    • Schmidt decomposition
    • Lanczos algorithm
  • Quantum Networks
    • QuantumNetwork
    • QuantumComb
    • QuantumChannel
  • Random Ensembles
    • Haar-random \(U_{3}\)
    • Random Gaussian matrix
    • Random Hermitian matrix
    • Random unitary matrix
    • Random quantum channel
    • Random statevector
    • Random density matrix
    • Random Clifford
    • Random Pauli
    • Random Pauli Hamiltonian
    • Random stochastic matrix
  • Superoperator Transformations
    • Vectorization
    • Unvectorization
    • To Choi
    • To Liouville
    • To Pauli-Liouville
    • To Chi
    • To Stinespring
    • Choi to Liouville
    • Choi to Pauli-Liouville
    • Choi to Kraus
    • Choi to Chi-matrix
    • Choi to Stinespring
    • Kraus to Choi
    • Kraus to Liouville
    • Kraus to Pauli-Liouville
    • Kraus to Chi-matrix
    • Kraus to Stinespring
    • Liouville to Choi
    • Liouville to Pauli-Liouville
    • Liouville to Kraus
    • Liouville to Chi-matrix
    • Liouville to Stinespring
    • Pauli-Liouville to Liouville
    • Pauli-Liouville to Choi
    • Pauli-Liouville to Kraus
    • Pauli-Liouville to Chi-matrix
    • Pauli-Liouville to Stinespring
    • Chi-matrix to Choi
    • Chi-matrix to Liouville
    • Chi-matrix to Pauli-Liouville
    • Chi-matrix to Kraus
    • Chi-matrix to Stinespring
    • Stinespring to Choi
    • Stinespring to Liouville
    • Stinespring to Pauli-Liouville
    • Stinespring to Kraus
    • Stinespring to Chi-matrix
    • Kraus operators as probabilistic sum of unitaries
  • Utility Functions
    • Hamming weight
    • Hamming distance
    • Hadamard Transform
    • Hellinger distance
    • Hellinger fidelity
    • Hellinger shot error
    • Total variation distance
    • Haar integral
    • Parameterized quantum circuit integral
• Tomography
  • Gate Set Tomography
    • GST()
• Parallelism
  • parallel_execution()
  • parallel_circuits_execution()
  • parallel_parametrized_execution()
• Backends
  • Backend
    • Backend.qubits
    • Backend.connectivity
    • Backend.natives
    • Backend.set_precision()
    • Backend.set_device()
    • Backend.set_threads()
    • Backend.cast()
    • Backend.is_sparse()
    • Backend.to_numpy()
    • Backend.compile()
    • Backend.zero_state()
    • Backend.zero_density_matrix()
    • Backend.identity_density_matrix()
    • Backend.plus_state()
    • Backend.plus_density_matrix()
    • Backend.matrix()
    • Backend.matrix_parametrized()
    • Backend.matrix_fused()
    • Backend.apply_gate()
    • Backend.apply_gate_density_matrix()
    • Backend.apply_gate_half_density_matrix()
    • Backend.apply_channel()
    • Backend.apply_channel_density_matrix()
    • Backend.collapse_state()
    • Backend.collapse_density_matrix()
    • Backend.reset_error_density_matrix()
    • Backend.thermal_error_density_matrix()
    • Backend.execute_circuit()
    • Backend.execute_circuits()
    • Backend.execute_circuit_repeated()
    • Backend.execute_distributed_circuit()
    • Backend.calculate_symbolic()
    • Backend.calculate_symbolic_density_matrix()
    • Backend.calculate_probabilities()
    • Backend.calculate_probabilities_density_matrix()
    • Backend.set_seed()
    • Backend.sample_shots()
    • Backend.aggregate_shots()
    • Backend.samples_to_binary()
    • Backend.samples_to_decimal()
    • Backend.calculate_frequencies()
    • Backend.sample_frequencies()
    • Backend.calculate_vector_norm()
    • Backend.calculate_matrix_norm()
    • Backend.calculate_overlap()
    • Backend.calculate_overlap_density_matrix()
    • Backend.calculate_eigenvalues()
    • Backend.calculate_eigenvectors()
    • Backend.calculate_expectation_state()
    • Backend.calculate_expectation_density_matrix()
    • Backend.calculate_matrix_exp()
    • Backend.calculate_matrix_power()
    • Backend.calculate_singular_value_decomposition()
    • Backend.calculate_jacobian_matrix()
    • Backend.calculate_hamiltonian_matrix_product()
    • Backend.calculate_hamiltonian_state_product()
  • Clifford Simulation
    • CliffordBackend
  • Cloud Backends
• Models for High Energy Physics
  • Quantum PDFs
    • qPDF circuit model