Contents Menu Expand Light mode Dark mode Auto light/dark mode
🎉 Qiskit is getting a new documentation experience on IBM Quantum! Check it out
  • Documentation Home
  • Quantum computing in a nutshell
  • Getting started
  • Introduction to Qiskit
  • Tutorials
    • Circuit Basics
    • Getting Started with Qiskit
    • Qiskit Visualizations
    • Summary of Quantum Operations
    • Advanced Circuits
    • Operators
    • Visualizing a Quantum Circuit
    • Transpiler Passes and Pass Manager
    • Pulse gates
    • Building Pulse Schedules
    • Schedule Instructions
    • Pulse Builder
    • Using the Scheduler
    • Obtaining information about your backend
    • Operator Flow
    • Qiskit Gradient Framework
  • API Reference
    • Quantum Circuits (qiskit.circuit)
      • QuantumCircuit
      • QuantumRegister
      • Qubit
      • ClassicalRegister
      • Clbit
      • AncillaRegister
      • AncillaQubit
      • CircuitInstruction
      • Register
      • Bit
      • Gate
      • ControlledGate
      • Delay
      • Instruction
      • InstructionSet
      • Operation
      • EquivalenceLibrary
      • ControlFlowOp
      • IfElseOp
      • WhileLoopOp
      • ForLoopOp
      • SwitchCaseOp
      • BreakLoopOp
      • ContinueLoopOp
      • Parameter
      • ParameterVector
      • ParameterExpression
    • Circuit Library (qiskit.circuit.library)
      • C3XGate
      • C3SXGate
      • C4XGate
      • CCXGate
      • DCXGate
      • CHGate
      • CPhaseGate
      • CRXGate
      • CRYGate
      • CRZGate
      • CSGate
      • CSdgGate
      • CSwapGate
      • CSXGate
      • CUGate
      • CU1Gate
      • CU3Gate
      • CXGate
      • CYGate
      • CZGate
      • CCZGate
      • ECRGate
      • HGate
      • IGate
      • MSGate
      • PhaseGate
      • RCCXGate
      • RC3XGate
      • RGate
      • RXGate
      • RXXGate
      • RYGate
      • RYYGate
      • RZGate
      • RZZGate
      • RZXGate
      • XXMinusYYGate
      • XXPlusYYGate
      • SGate
      • SdgGate
      • SwapGate
      • iSwapGate
      • SXGate
      • SXdgGate
      • TGate
      • TdgGate
      • UGate
      • U1Gate
      • U2Gate
      • U3Gate
      • XGate
      • YGate
      • ZGate
      • GlobalPhaseGate
      • Barrier
      • Measure
      • Reset
      • Diagonal
      • MCMT
      • MCMTVChain
      • Permutation
      • PermutationGate
      • GMS
      • GR
      • GRX
      • GRY
      • GRZ
      • MCPhaseGate
      • MCXGate
      • MCXGrayCode
      • MCXRecursive
      • MCXVChain
      • RVGate
      • PauliGate
      • LinearFunction
      • AND
      • OR
      • XOR
      • InnerProduct
      • QFT
      • LinearAmplitudeFunction
      • FunctionalPauliRotations
      • LinearPauliRotations
      • PolynomialPauliRotations
      • PiecewiseLinearPauliRotations
      • PiecewisePolynomialPauliRotations
      • PiecewiseChebyshev
      • DraperQFTAdder
      • CDKMRippleCarryAdder
      • VBERippleCarryAdder
      • WeightedAdder
      • HRSCumulativeMultiplier
      • RGQFTMultiplier
      • IntegerComparator
      • QuadraticForm
      • ExactReciprocal
      • FourierChecking
      • GraphState
      • HiddenLinearFunction
      • IQP
      • QuantumVolume
      • PhaseEstimation
      • GroverOperator
      • PhaseOracle
      • EvolvedOperatorAnsatz
      • PauliEvolutionGate
      • NLocal
      • TwoLocal
      • PauliTwoDesign
      • RealAmplitudes
      • EfficientSU2
      • ExcitationPreserving
      • QAOAAnsatz
      • PauliFeatureMap
      • ZFeatureMap
      • ZZFeatureMap
      • StatePreparation
    • Classical expressions (qiskit.circuit.classical)
    • Compilation Routines (qiskit.compiler)
    • Executing Experiments (qiskit.execute_function)
    • Visualizations (qiskit.visualization)
      • qiskit.visualization.plot_histogram
      • qiskit.visualization.plot_distribution
      • qiskit.visualization.plot_bloch_vector
      • qiskit.visualization.plot_bloch_multivector
      • qiskit.visualization.plot_state_city
      • qiskit.visualization.plot_state_hinton
      • qiskit.visualization.plot_state_paulivec
      • qiskit.visualization.plot_state_qsphere
      • qiskit.visualization.plot_gate_map
      • qiskit.visualization.plot_error_map
      • qiskit.visualization.plot_circuit_layout
      • qiskit.visualization.plot_coupling_map
      • qiskit.visualization.circuit_drawer
      • DefaultStyle
      • qiskit.visualization.dag_drawer
      • qiskit.visualization.pass_manager_drawer
      • qiskit.visualization.pulse_drawer
      • IQXStandard
      • IQXSimple
      • IQXDebugging
      • qiskit.visualization.timeline_drawer
      • qiskit.visualization.visualize_transition
      • qiskit.visualization.array_to_latex
    • ClassicalFunction compiler (qiskit.circuit.classicalfunction)
      • ClassicalFunction
      • BooleanExpression
      • qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError
      • qiskit.circuit.classicalfunction.ClassicalFunctionParseError
      • qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError
    • Circuit Converters (qiskit.converters)
    • Circuit and Schedule Assembler (qiskit.assembler)
      • RunConfig
    • DAG Circuits (qiskit.dagcircuit)
      • DAGCircuit
      • DAGNode
      • DAGOpNode
      • DAGInNode
      • DAGOutNode
      • DAGDepNode
      • DAGDependency
      • BlockCollapser
      • BlockCollector
      • BlockSplitter
    • Quantum Circuit Extensions (qiskit.extensions)
      • UnitaryGate
      • HamiltonianGate
      • SingleQubitUnitary
      • Snapshot
      • Initialize
      • UCPauliRotGate
      • UCRXGate
      • UCRYGate
      • UCRZGate
    • BasicAer: Python-based Simulators (qiskit.providers.basicaer)
      • QasmSimulatorPy
      • StatevectorSimulatorPy
      • UnitarySimulatorPy
      • BasicAerProvider
      • BasicAerJob
      • qiskit.providers.basicaer.BasicAerError
    • Providers Interface (qiskit.providers)
      • Provider
      • ProviderV1
      • Backend
      • BackendV1
      • BackendV2
      • QubitProperties
      • BackendV2Converter
      • qiskit.providers.convert_to_target
      • Options
      • Job
      • JobV1
      • JobStatus
    • Writing a New Provider
    • Migrating between Backend API Versions
    • Fake Provider (qiskit.providers.fake_provider)
      • FakeProviderForBackendV2
      • FakeProvider
      • FakeAlmadenV2
      • FakeArmonkV2
      • FakeAthensV2
      • FakeAuckland
      • FakeBelemV2
      • FakeBoeblingenV2
      • FakeBogotaV2
      • FakeBrooklynV2
      • FakeBurlingtonV2
      • FakeCairoV2
      • FakeCambridgeV2
      • FakeCasablancaV2
      • FakeEssexV2
      • FakeGeneva
      • FakeGuadalupeV2
      • FakeHanoiV2
      • FakeJakartaV2
      • FakeJohannesburgV2
      • FakeKolkataV2
      • FakeLagosV2
      • FakeLimaV2
      • FakeLondonV2
      • FakeManhattanV2
      • FakeManilaV2
      • FakeMelbourneV2
      • FakeMontrealV2
      • FakeMumbaiV2
      • FakeNairobiV2
      • FakeOslo
      • FakeOurenseV2
      • FakeParisV2
      • FakePerth
      • FakePrague
      • FakePoughkeepsieV2
      • FakeQuitoV2
      • FakeRochesterV2
      • FakeRomeV2
      • FakeSantiagoV2
      • FakeSherbrooke
      • FakeSingaporeV2
      • FakeSydneyV2
      • FakeTorontoV2
      • FakeValenciaV2
      • FakeVigoV2
      • FakeWashingtonV2
      • FakeYorktownV2
      • FakeAlmaden
      • FakeArmonk
      • FakeAthens
      • FakeBelem
      • FakeBoeblingen
      • FakeBogota
      • FakeBrooklyn
      • FakeBurlington
      • FakeCairo
      • FakeCambridge
      • FakeCasablanca
      • FakeEssex
      • FakeGuadalupe
      • FakeHanoi
      • FakeJakarta
      • FakeJohannesburg
      • FakeKolkata
      • FakeLagos
      • FakeLima
      • FakeLondon
      • FakeManhattan
      • FakeManila
      • FakeMelbourne
      • FakeMontreal
      • FakeMumbai
      • FakeNairobi
      • FakeOurense
      • FakeParis
      • FakePoughkeepsie
      • FakeQuito
      • FakeRochester
      • FakeRome
      • FakeRueschlikon
      • FakeSantiago
      • FakeSingapore
      • FakeSydney
      • FakeTenerife
      • FakeTokyo
      • FakeToronto
      • FakeValencia
      • FakeVigo
      • FakeWashington
      • FakeYorktown
      • FakeQasmSimulator
      • FakeOpenPulse2Q
      • FakeOpenPulse3Q
      • Fake1Q
      • FakeBackendV2
      • FakeBackend5QV2
      • FakeMumbaiFractionalCX
      • ConfigurableFakeBackend
    • Backend Objects (qiskit.providers.models)
      • BackendConfiguration
      • BackendProperties
      • BackendStatus
      • QasmBackendConfiguration
      • PulseBackendConfiguration
      • UchannelLO
      • GateConfig
      • PulseDefaults
      • Command
      • JobStatus
    • Pulse (qiskit.pulse)
      • Acquire
      • Call
      • Reference
      • Delay
      • Play
      • RelativeBarrier
      • SetFrequency
      • ShiftFrequency
      • SetPhase
      • ShiftPhase
      • Snapshot
      • TimeBlockade
      • Waveform
      • ScalableSymbolicPulse
      • SymbolicPulse
      • ParametricPulse
      • Constant
      • Drag
      • Gaussian
      • GaussianSquare
      • qiskit.pulse.library.GaussianSquareDrag
      • qiskit.pulse.library.gaussian_square_echo
      • qiskit.pulse.library.GaussianDeriv
      • qiskit.pulse.library.Sin
      • qiskit.pulse.library.Cos
      • qiskit.pulse.library.Sawtooth
      • qiskit.pulse.library.Triangle
      • qiskit.pulse.library.Square
      • qiskit.pulse.library.Sech
      • qiskit.pulse.library.SechDeriv
      • DriveChannel
      • MeasureChannel
      • AcquireChannel
      • ControlChannel
      • RegisterSlot
      • MemorySlot
      • SnapshotChannel
      • Schedule
      • ScheduleBlock
      • AlignEquispaced
      • AlignFunc
      • AlignLeft
      • AlignRight
      • AlignSequential
      • InstructionScheduleMap
    • Circuit Scheduler (qiskit.scheduler)
    • Circuit Synthesis (qiskit.synthesis)
      • EvolutionSynthesis
      • ProductFormula
      • LieTrotter
      • SuzukiTrotter
      • MatrixExponential
      • QDrift
      • SolovayKitaevDecomposition
    • Primitives (qiskit.primitives)
      • BaseEstimator
      • Estimator
      • BackendEstimator
      • BaseSampler
      • Sampler
      • BackendSampler
      • EstimatorResult
      • SamplerResult
    • OpenQASM 2 (qiskit.qasm2)
    • OpenQASM 3 (qiskit.qasm3)
    • Qasm (qiskit.qasm)
    • Qobj (qiskit.qobj)
      • Qobj
      • QobjExperimentHeader
      • QobjHeader
      • QasmQobj
      • QasmQobjInstruction
      • QasmQobjExperimentConfig
      • QasmQobjExperiment
      • QasmQobjConfig
      • QasmExperimentCalibrations
      • GateCalibration
      • PulseQobj
      • PulseQobjInstruction
      • PulseQobjExperimentConfig
      • PulseQobjExperiment
      • PulseQobjConfig
      • QobjMeasurementOption
      • PulseLibraryItem
    • QPY serialization (qiskit.qpy)
    • Quantum Information (qiskit.quantum_info)
      • Operator
      • Pauli
      • Clifford
      • ScalarOp
      • SparsePauliOp
      • CNOTDihedral
      • PauliList
      • PauliTable
      • StabilizerTable
      • qiskit.quantum_info.pauli_basis
      • Statevector
      • DensityMatrix
      • StabilizerState
      • Choi
      • SuperOp
      • Kraus
      • Stinespring
      • Chi
      • PTM
      • Z2Symmetries
      • OneQubitEulerDecomposer
      • TwoQubitBasisDecomposer
      • Quaternion
      • XXDecomposer
    • Experiment Results (qiskit.result)
      • Result
      • qiskit.result.ResultError
      • Counts
      • ProbDistribution
      • QuasiDistribution
      • BaseReadoutMitigator
      • CorrelatedReadoutMitigator
      • LocalReadoutMitigator
    • Qiskit Tools (qiskit.tools)
    • Jupyter Tools (qiskit.tools.jupyter)
    • Transpiler (qiskit.transpiler)
      • Target
      • InstructionProperties
      • StagedPassManager
      • PassManager
      • PassManagerConfig
      • PropertySet
      • FlowController
      • ConditionalController
      • DoWhileController
      • Layout
      • CouplingMap
      • TranspileLayout
      • InstructionDurations
      • FencedDAGCircuit
      • FencedPropertySet
      • TransformationPass
      • AnalysisPass
    • Transpiler Passes (qiskit.transpiler.passes)
      • SetLayout
      • TrivialLayout
      • DenseLayout
      • NoiseAdaptiveLayout
      • SabreLayout
      • CSPLayout
      • VF2Layout
      • ApplyLayout
      • Layout2qDistance
      • EnlargeWithAncilla
      • FullAncillaAllocation
      • BasicSwap
      • LookaheadSwap
      • StochasticSwap
      • SabreSwap
      • BIPMapping
      • Commuting2qGateRouter
      • Unroller
      • Unroll3qOrMore
      • Decompose
      • UnrollCustomDefinitions
      • BasisTranslator
      • TranslateParameterizedGates
      • Optimize1qGates
      • Optimize1qGatesDecomposition
      • Collect1qRuns
      • Collect2qBlocks
      • CollectMultiQBlocks
      • CollectLinearFunctions
      • CollectCliffords
      • ConsolidateBlocks
      • CXCancellation
      • InverseCancellation
      • CommutationAnalysis
      • CommutativeCancellation
      • CommutativeInverseCancellation
      • Optimize1qGatesSimpleCommutation
      • RemoveDiagonalGatesBeforeMeasure
      • RemoveResetInZeroState
      • CrosstalkAdaptiveSchedule
      • HoareOptimizer
      • TemplateOptimization
      • EchoRZXWeylDecomposition
      • ResetAfterMeasureSimplification
      • OptimizeCliffords
      • PulseGates
      • RZXCalibrationBuilder
      • RZXCalibrationBuilderNoEcho
      • TimeUnitConversion
      • ALAPScheduleAnalysis
      • ASAPScheduleAnalysis
      • PadDynamicalDecoupling
      • PadDelay
      • ConstrainedReschedule
      • AlignMeasures
      • ValidatePulseGates
      • InstructionDurationCheck
      • SetIOLatency
      • ALAPSchedule
      • ASAPSchedule
      • DynamicalDecoupling
      • Width
      • Depth
      • Size
      • CountOps
      • CountOpsLongestPath
      • NumTensorFactors
      • DAGLongestPath
      • UnitarySynthesis
      • LinearFunctionsSynthesis
      • LinearFunctionsToPermutations
      • HighLevelSynthesis
      • SolovayKitaev
      • SolovayKitaevSynthesis
      • VF2PostLayout
      • CheckMap
      • CheckCXDirection
      • CheckGateDirection
      • CXDirection
      • GateDirection
      • MergeAdjacentBarriers
      • RemoveBarriers
      • BarrierBeforeFinalMeasurements
      • RemoveFinalMeasurements
      • DAGFixedPoint
      • FixedPoint
      • MinimumPoint
      • ContainsInstruction
      • GatesInBasis
      • ConvertConditionsToIfOps
      • UnrollForLoops
    • Preset Passmanagers (qiskit.transpiler.preset_passmanagers)
    • Transpiler Stage Plugin Interface (qiskit.transpiler.preset_passmanagers.plugin)
      • PassManagerStagePlugin
      • PassManagerStagePluginManager
    • Synthesis Plugins (qiskit.transpiler.passes.synthesis.plugin)
      • UnitarySynthesisPlugin
      • UnitarySynthesisPluginManager
      • qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names
      • HighLevelSynthesisPlugin
      • HighLevelSynthesisPluginManager
    • Built-in Transpiler Synthesis Plugins
      • Approximate Quantum Compiler (qiskit.transpiler.synthesis.aqc)
        • AQC
        • AQCSynthesisPlugin
        • ApproximateCircuit
        • ApproximatingObjective
        • CNOTUnitCircuit
        • CNOTUnitObjective
        • DefaultCNOTUnitObjective
        • FastCNOTUnitObjective
    • Utilities (qiskit.utils)
      • QuantumInstance
    • Measurement Mitigation Utils (qiskit.utils.mitigation)
      • CompleteMeasFitter
      • TensoredMeasFitter
    • Operators (qiskit.opflow)
      • OperatorBase
      • qiskit.opflow.primitive_ops
        • PrimitiveOp
        • CircuitOp
        • MatrixOp
        • PauliOp
        • PauliSumOp
        • TaperedPauliSumOp
        • Z2Symmetries
      • qiskit.opflow.list_ops
        • ListOp
        • ComposedOp
        • SummedOp
        • TensoredOp
      • qiskit.opflow.state_fns
        • StateFn
        • CircuitStateFn
        • DictStateFn
        • VectorStateFn
        • SparseVectorStateFn
        • OperatorStateFn
        • CVaRMeasurement
      • qiskit.opflow.converters
        • ConverterBase
        • CircuitSampler
        • AbelianGrouper
        • DictToCircuitSum
        • PauliBasisChange
        • TwoQubitReduction
      • qiskit.opflow.evolutions
        • EvolutionBase
        • EvolutionFactory
        • EvolvedOp
        • MatrixEvolution
        • PauliTrotterEvolution
        • TrotterizationBase
        • TrotterizationFactory
        • Trotter
        • Suzuki
        • QDrift
      • qiskit.opflow.expectations
        • ExpectationBase
        • ExpectationFactory
        • AerPauliExpectation
        • MatrixExpectation
        • PauliExpectation
        • CVaRExpectation
      • qiskit.opflow.gradients
        • DerivativeBase
        • GradientBase
        • HessianBase
        • QFIBase
        • CircuitGradient
        • CircuitQFI
        • Gradient
        • Hessian
        • NaturalGradient
        • QFI
    • Algorithms (qiskit.algorithms)
      • AmplificationProblem
      • AmplitudeAmplifier
      • Grover
      • GroverResult
      • AmplitudeEstimator
      • AmplitudeEstimatorResult
      • AmplitudeEstimation
      • AmplitudeEstimationResult
      • EstimationProblem
      • FasterAmplitudeEstimation
      • FasterAmplitudeEstimationResult
      • IterativeAmplitudeEstimation
      • IterativeAmplitudeEstimationResult
      • MaximumLikelihoodAmplitudeEstimation
      • MaximumLikelihoodAmplitudeEstimationResult
      • qiskit.algorithms.eigensolvers
        • Eigensolver
        • NumPyEigensolver
        • VQD
        • EigensolverResult
        • NumPyEigensolverResult
        • VQDResult
      • Eigensolver
      • EigensolverResult
      • NumPyEigensolver
      • VQD
      • VQDResult
      • RealTimeEvolver
      • ImaginaryTimeEvolver
      • TimeEvolutionResult
      • TimeEvolutionProblem
      • PVQD
      • PVQDResult
      • SciPyImaginaryEvolver
      • SciPyRealEvolver
      • VarQITE
      • VarQRTE
      • RealEvolver
      • ImaginaryEvolver
      • TrotterQRTE
      • EvolutionResult
      • EvolutionProblem
      • qiskit.algorithms.time_evolvers.variational
        • VariationalPrinciple
        • RealVariationalPrinciple
        • ImaginaryVariationalPrinciple
        • RealMcLachlanPrinciple
        • ImaginaryMcLachlanPrinciple
        • ForwardEulerSolver
      • qiskit.algorithms.time_evolvers.trotterization
        • TrotterQRTE
      • qiskit.algorithms.gradients
        • BaseEstimatorGradient
        • BaseQGT
        • BaseSamplerGradient
        • EstimatorGradientResult
        • SamplerGradientResult
        • QGTResult
        • FiniteDiffEstimatorGradient
        • FiniteDiffSamplerGradient
        • LinCombEstimatorGradient
        • LinCombSamplerGradient
        • LinCombQGT
        • ParamShiftEstimatorGradient
        • ParamShiftSamplerGradient
        • QFIResult
        • QFI
        • ReverseEstimatorGradient
        • ReverseQGT
        • SPSAEstimatorGradient
        • SPSASamplerGradient
      • qiskit.algorithms.minimum_eigensolvers
        • MinimumEigensolver
        • NumPyMinimumEigensolver
        • VQE
        • AdaptVQE
        • SamplingMinimumEigensolver
        • SamplingVQE
        • QAOA
        • MinimumEigensolverResult
        • NumPyMinimumEigensolverResult
        • VQEResult
        • AdaptVQEResult
        • SamplingMinimumEigensolverResult
        • SamplingVQEResult
      • MinimumEigensolver
      • MinimumEigensolverResult
      • NumPyMinimumEigensolver
      • QAOA
      • VQE
      • qiskit.algorithms.optimizers
        • OptimizerResult
        • OptimizerSupportLevel
        • Optimizer
        • Minimizer
        • qiskit.algorithms.optimizers.optimizer_utils
          • LearningRate
        • SteppableOptimizer
        • AskData
        • TellData
        • OptimizerState
        • ADAM
        • AQGD
        • CG
        • COBYLA
        • L_BFGS_B
        • GSLS
        • GradientDescent
        • GradientDescentState
        • NELDER_MEAD
        • NFT
        • P_BFGS
        • POWELL
        • SLSQP
        • SPSA
        • QNSPSA
        • TNC
        • SciPyOptimizer
        • UMDA
        • BOBYQA
        • IMFIL
        • SNOBFIT
        • CRS
        • DIRECT_L
        • DIRECT_L_RAND
        • ESCH
        • ISRES
      • HamiltonianPhaseEstimation
      • HamiltonianPhaseEstimationResult
      • PhaseEstimationScale
      • PhaseEstimation
      • PhaseEstimationResult
      • IterativePhaseEstimation
      • qiskit.algorithms.state_fidelities
        • BaseStateFidelity
        • ComputeUncompute
        • StateFidelityResult
      • AlgorithmJob
    • Top-level exceptions (qiskit.exceptions)
  • How-to Guides
    • Compute circuit output probabilities with Sampler primitive
    • Compute an expectation value with Estimator primitive
  • Explanation
    • Order of qubits in Qiskit
  • Migration Guides
    • Algorithms Migration Guide
    • Opflow Migration Guide
    • Quantum Instance Migration Guide
  • Release Notes
  • Local Configuration
  • GitHub
  • Frequently Asked Questions

Contributing

  • Contributing to Qiskit
  • Deprecation Policy
  • Maintainers Guide
  • 0.44
  • 0.43
  • 0.42
  • 0.41
  • 0.40
  • 0.39
  • 0.38
  • 0.37
  • 0.36
  • 0.35
  • 0.34
  • 0.33
  • 0.32
  • 0.31
  • 0.30
  • 0.29
  • 0.28
  • 0.27
  • 0.26
  • 0.25
  • 0.24
  • 0.19
  • English
  • Bengali
  • French
  • German
  • Japanese
  • Korean
  • Portuguese
  • Spanish
  • Tamil
Back to top

Explanation#

  • Order of qubits in Qiskit
Next
Order of qubits in Qiskit
Previous
Compute an expectation value with Estimator primitive
Copyright © 2017-2023, Qiskit Development Team
Made with Sphinx and @pradyunsg's Furo
Last updated on 2023/10/02